Résoudre un problème
Identifiez ce qui a échoué avant de relancer.
À l’arrivée
Vous choisissez la bonne action : corriger, reconnecter ou demander de l’aide.
INPUT_ERRORCorriger les entréesAUTH_ERRORRétablir la connexionAPI_CHANGEDConsulter la réparationEXECUTION_ERRORExaminer le résultatRésultat d’une écriture inconnu ? Vérifiez le site avant de relancer.
Votre parcours, en trois étapes.
- 01
Une entrée est incorrecte
INPUT_ERROR : vérifiez les champs, les formats et l’existence de l’enregistrement demandé.
- 02
Le logiciel refuse l’accès
AUTH_ERROR : ouvrez le parcours de reconnexion et terminez les vérifications demandées par le logiciel.
- 03
Le comportement a changé
API_CHANGED : consultez la réparation et son résultat. EXECUTION_ERROR : utilisez le détail de l’exécution pour comprendre le problème ou contacter l’équipe.
Un point à approfondir ?
Ouvrez uniquement le sujet dont vous avez besoin.
Vue d’ensemble
Les sites changent sans prévenir personne, et les comptes se font déconnecter. Trouvez votre symptôme ci-dessous : ce que vous voyez, pourquoi cela arrive en clair, quoi faire, et à quoi doit ressembler le résultat.
01 · LA SESSIONVotre accès au site
Sa durée dépend du logiciel. Le connecteur peut la renouveler si ce parcours est pris en charge.
02 · LES IDENTIFIANTSEnregistrés avec votre accord
Ils peuvent permettre une nouvelle connexion. Une validation supplémentaire peut demander votre intervention.
Chaque installation conserve ses propres accès.
Ce que Vela fait tout seul
- Il essaie chaque connecteur de lecture environ une fois par heure, pour repérer les problèmes avant vous. Cela ne vous coûte rien et ne compte pas comme une utilisation.
- Il n’essaie jamais les connecteurs qui modifient des choses. Un contrôle qui pose un rendez-vous n’est pas un contrôle. Quand un site permet de vérifier la connexion séparément, c’est cela qui est essayé.
- Si le problème n’est qu’une connexion et que vous avez enregistré votre mot de passe, il se reconnecte et poursuit — vous n’êtes pas prévenu, puisqu’il ne s’est rien passé.
- Si le site a réellement changé, il reconstruit le connecteur à partir de votre enregistrement d’origine et vérifie la nouvelle version avant de basculer dessus.
- La version précédente est toujours conservée, donc vous pouvez revenir en arrière.
- Retry repair sur la page du connecteur demande une nouvelle tentative — utilisez-le une fois, et lisez l’historique avant d’appuyer une seconde fois.
Une réparation ne rejoue jamais votre action
Vela ne réserve, n’envoie et ne soumet jamais rien pour tester un connecteur. Il rejoue l’enregistrement à la place.
Le connecteur dit que la connexion a échoué
| Symptôme | Ce que ça veut dire | Quoi faire | Résultat attendu |
|---|---|---|---|
| Un bandeau sur la page du connecteur indique qu’il n’a pas pu se connecter, avec un bouton Open sign-in browser. | Le site a déconnecté le connecteur. C’est normal et prévu, pas un défaut de votre connecteur. | Cliquez sur Open sign-in browser et suivez Reconnecter un connecteur. | La page annonce Session restored, puis un Check health réussit. |
| L’historique montre un échec d’authentification alors que le connecteur paraît sain. | L’autorisation du site a expiré à l’intérieur de la session que Vela détient. La fiche du connecteur, elle, va bien. | Reconnectez-le une fois depuis la page du connecteur, pas depuis votre outil. | L’appel suivant depuis votre outil renvoie une réponse au lieu d’une erreur d’authentification. |
| Un e-mail vous demande de vous reconnecter pour un connecteur nommé. | Vela a essayé de se connecter seul une fois, cette tentative réclamait une personne, et il s’est arrêté plutôt que de deviner. | Utilisez le lien de l’e-mail. Il mène à la même page que le bouton. | La page de reconnexion annonce la session restaurée. |
Un connecteur n’a pas pu être créé ou ne se construit pas
| Symptôme | Ce que ça veut dire | Quoi faire | Résultat attendu |
|---|---|---|---|
| Start building reste grisé et ne répond pas. | L’écran a besoin de l’adresse et de l’objectif pour démarrer. En Advanced · Define your fields, il lui faut aussi au moins une sortie et un exemple pour chaque entrée. | Remplissez le champ manquant. La ligne à côté du bouton le nomme. | Le bouton s’active et la construction démarre. |
| Une construction s’arrête sur une protection anti-robot. | Le site est fait pour refuser l’automatisation, délibérément. C’est hors périmètre, et aucune insistance n’y changera rien. | Arrêtez-vous là. Choisissez un autre site, ou une partie du site qui ne demande pas cette vérification. | Rien à attendre : c’est une vraie limite du produit, pas une étape que vous auriez ratée. |
| Une construction s’arrête sur une étape que seuls certains comptes ont. | La démonstration a pris un chemin dont votre compte ne dispose pas, ou une étape inconnue de Vela est apparue. | Refaites la démonstration, restez sur le chemin le plus court, et franchissez cette étape vous-même quand elle apparaît. | La construction dépasse l’étape et va jusqu’au bout. |
| Une construction aboutit mais le résultat est vide ou faux. | La démonstration a appris à Vela à partir d’une recherche sans résultat ou d’une valeur inventée : il n’a jamais vu à quoi ressemble une vraie réponse. | Exécutez le connecteur dans API Playground sur un enregistrement qui existe vraiment, et reconstruisez si la forme de la réponse est fausse. | L’exécution renvoie les valeurs que vous attendez. |
Un connecteur n’est plus disponible
| Symptôme | Ce que ça veut dire | Quoi faire | Résultat attendu |
|---|---|---|---|
| Un appel est refusé, le connecteur étant signalé indisponible ou introuvable. | Le connecteur a été supprimé, mis en pause, ou la clé utilisée par votre outil ne correspond plus. | Vérifiez qu’il existe toujours sous Connectors et qu’il est activé. S’il existe, régénérez la clé dans Integrations & Exports et collez la nouvelle dans votre outil. | L’appel renvoie une réponse, et l’exécution apparaît dans Activity & Logs. |
| Le connecteur s’exécute mais signale qu’une valeur est introuvable. | Le site a été interrogé et a répondu non : un nom qui n’existe pas, un créneau déjà pris. Le message liste en général des valeurs qui passeraient. | Envoyez une valeur qui existe vraiment sur le site. | L’exécution renvoie l’enregistrement au lieu du refus. |
| Il a commencé à échouer juste après une modification de Inputs & outputs. | Un champ que le connecteur renvoie encore a été déclaré retiré, et Vela vérifie que ce qui revient correspond à ce que vous avez déclaré. | Remettez le champ dans Edit inputs & outputs. | L’exécution suivante passe le contrôle de sortie. |
| Les appels sont refusés et on vous demande de ralentir. | Environ un appel toutes les cinq secondes par connecteur est autorisé. Cela protège autant le site appelé que votre compte. | Espacez les appels au lieu de réessayer aussitôt. | Les appels repassent dès que la cadence baisse. |
Un Toolset est inutilisable
| Symptôme | Ce que ça veut dire | Quoi faire | Résultat attendu |
|---|---|---|---|
| Votre agent ne voit aucun outil. | L’adresse collée dans l’agent est fausse, ou le mot d’en-tête manque devant le token. | Collez l’adresse et le token exactement comme la page du Toolset les donne, plutôt que de recopier l’adresse de votre navigateur. | L’agent liste les outils sous les noms que vous leur avez donnés. |
| Le connecteur voulu n’est pas dans Select Active Connector. | Il n’est pas en Live, ou le Toolset est en lecture seule et ce connecteur modifie quelque chose. | Activez le connecteur, ou rattachez-le à un Toolset qui n’est pas en lecture seule si vous voulez vraiment autoriser cette action. | Le connecteur apparaît dans la liste et peut être rattaché. |
| Chaque appel est refusé comme si aucune clé n’avait été envoyée. | Le token a été renouvelé après votre copie, donc l’ancien ne fonctionne plus. | Appuyez sur Rotate Token, puis collez le nouveau token dans votre agent dans la foulée. | Les appels repassent, et l’exécution apparaît dans l’historique du connecteur. |
Toujours bloqué
- Chaque exécution en échec porte une référence affichée à côté d’elle. Citez-la dans une demande d’aide : elle identifie l’exécution exacte, ce qui a été envoyé, et la version qui a répondu.
- Ne répétez jamais un appel qui réserve, envoie ou soumet quand vous ne pouvez pas voir si le premier a abouti : vous dupliqueriez une vraie réservation, un vrai message ou une vraie commande. Lisez l’exécution d’abord, puis décidez.
- Pour tout ce que les tableaux ci-dessus ne couvrent pas, partez de Reconnecter un connecteur si une connexion est en jeu, et de Créer un toolset si un agent est en jeu.
Ce que ces guides prouvent, et ce qu’ils ne prouvent pas
Chaque nom de bouton, champ et phrase de résultat de cette aide est vérifié contre l’écran qui l’affiche : renommer un élément casse cette vérification au lieu de vous laisser chercher quelque chose qui n’existe plus. C’est la limite de ce qui est prouvé ici, et elle mérite d’être dite clairement :
- Aucun navigateur n’est piloté pendant la vérification de la documentation : les libellés sont prouvés présents dans le fichier qui les affiche, pas placés par une page réelle là où un guide le dit.
- Les outils côté agent (Claude, Cursor et les autres) ne sont pas exercés ici. Quand un guide décrit ce qu’affiche un agent, cette partie n’est pas vérifiée par ce dépôt.
- La version de la documentation déployée n’est pas confirmée depuis ce dépôt.
Si une étape d’ici contredit ce que vous voyez, c’est le guide qui a tort : dites-nous quelle étape, et ce que l’écran affichait à la place.
Ce qui déclenche une réparation, ce qu’elle fait, et où elle s’arrête.
↗Votre situation ne correspond pas au guide ?
Échanger avec l’équipe ↗