Dépannage
Une doc v1 sur un produit en accès anticipé. Vous allez tomber sur des aspérités. Voici celles que nous connaissons déjà et comment les contourner.
L'email d'invitation a atterri dans les spams
Outlook, Live et Gmail sont les suspects habituels. Vérifiez le dossier indésirables, marquez l'expéditeur (update@etiakorp.com) comme légitime, et déplacez l'email vers votre boîte de réception. Les emails système suivants atterriront au bon endroit.
J'ai reçu plusieurs emails d'invitation
Cela arrive quand le provisionnement réessaie. Utilisez le plus récent. Les liens plus anciens peuvent encore fonctionner, mais le dernier est le bon.
L'URL de l'application ne se charge pas, ou je vois un 502 / 503
Les nouveaux sous-domaines tenant ont besoin d'1 à 2 minutes pour que le DNS et le TLS se propagent. Attendez, puis rafraîchissez. Si plus de 5 minutes se sont écoulées, le cluster est peut-être en cours de synchronisation — réessayez dans une ou deux minutes. Si cela ne fonctionne toujours pas après 10 minutes, voir Obtenir de l'aide.
Le lien d'activation dit « expired »
Les jetons d'action des emails d'activation expirent après une courte fenêtre (généralement quelques heures). La solution est un email frais — ouvrez un ticket de support (avec votre slug) et on relancera l'invitation. Si vous avez déjà reçu plusieurs invitations, essayez un email plus récent avant de contacter le support.
L'assistant d'accueil reste bloqué sur « Decomposing into tasks… »
Rafraîchissez la page. L'assistant relit l'état depuis le serveur et vous pouvez reprendre où vous en étiez — votre choix de workspace est conservé. Si le blocage revient après le rafraîchissement, contactez le support ; cela signifie en général qu'un réglage côté back-end ne va pas et qu'on doit regarder.
Une clé d'API fournisseur a été refusée
Vérifiez le préfixe :
- Les clés Anthropic commencent par
sk-ant-… - Les clés OpenAI (et compatibles) commencent par
sk-… - Les clés Synthetic.new commencent par
syn-…
Si le préfixe est mauvais, vous avez probablement copié le mauvais champ depuis la console du fournisseur. Régénérez depuis le tableau de bord du fournisseur si la clé est expirée. Le message d'erreur dans Genesis peut afficher le code HTTP brut dans certains chemins — 401 veut dire « clé invalide », 403 « pas d'accès », 429 « limite atteinte ou pas de crédit ».
Mission bloquée en « Decomposing » plus de 2 minutes
- Rafraîchissez la page.
- Si votre fournisseur a eu une panne récente, le planificateur peut être en train de retenter ; attendez une minute de plus.
- Si 5 minutes passent sans avancée, annulez la mission et recréez la conversation.
Mission bloquée en « Running » sans avancée apparente
- Ouvrez la mission. Regardez le statut tâche par tâche.
- Tâches en Pending depuis plus de quelques minutes → la flotte est peut-être saturée. Voyez l'onglet Outils de Config LLM : le Max. concurrent de la flotte, le Max Instances de chaque variante et le compte en direct des instances actives vivent là. (L'ancienne page Fleet Resource Config redirige désormais vers cet onglet.)
- Tâches en InProgress avec la même durée écoulée depuis plus de 10 minutes → une tâche unique est peut-être dans une boucle de retry longue. Ouvrez-la ; le log dit ce qu'il se passe.
Une tâche affiche « TurnLimitReached »
Le coder a épuisé son budget de tours — le plafond par exécution du nombre d'étapes qu'il peut prendre — avant de déclarer le travail terminé. C'est un arrêt, pas un plantage : ce que le coder a commité est sur sa branche, mais la tâche n'a pas fini. Sur la page mission, la ligne de la tâche propose le bouton ↻ (Réessayer la tâche) — cliquez-le pour remettre la tâche en file pour un coder frais. Si la même tâche retape le plafond, le travail est probablement trop gros pour une seule tâche ; demandez une tranche plus petite dans la conversation.
Une tâche reste en « UsageLimitWait »
Le quota d'utilisation du fournisseur est épuisé pour la fenêtre en cours. Ce n'est pas une erreur : la tâche est en pause, pas en échec, et elle reprend toute seule quand la fenêtre de quota se réinitialise. Rien à cliquer, pas de ticket à ouvrir — laissez-la tranquille et revenez plus tard.
Une mission affiche « Paused »
Quelqu'un a cliqué sur Pause sur la page mission — cela suspend le nouveau travail sans rien perdre. Ouvrez la mission : dans la rangée d'actions en bas, Reprendre remplace Pause tant que la mission est en pause. Cliquez-le et la mission repasse en InProgress.
« L'action a été refusée » (transition invalide)
Vous avez demandé à une mission un changement d'état qu'elle n'autorise pas depuis là où elle se trouve — la demande est refusée plutôt qu'ignorée en silence. Le message d'erreur nomme l'état actuel de la mission et liste les transitions qu'elle accepte. Lisez cette liste avant de réessayer : le même clic rebondira encore, et l'une des actions listées est le prochain coup légal.
L'écran de revue est vide alors qu'une tâche s'est terminée
- La revue est peut-être encore en synchro — rafraîchissez après 30 secondes.
- Si toujours vide, le coder a peut-être produit un no-op (rare mais possible). La page tâche montre ce que le coder a réellement changé ; si « rien », c'est la cause.
Push vers l'origine échoué après approbation
- Voyez la demande d'attention sur la revue — elle nomme généralement l'erreur (auth, réseau, conflit de ref).
- Ré-ajoutez les identifiants dans la page Projects si le token a expiré.
- Il n'y a pas de bouton de relance du push — les pushes se relancent automatiquement, et une tâche dont le push échoue en boucle est remise en file toute seule. Corrigez les identifiants, puis laissez quelques minutes ; si la tâche finit quand même en Failed, le bouton ↻ (Réessayer la tâche) sur sa ligne est le levier manuel.
Workflows
Symptômes propres aux missions qui exécutent un workflow. Pour la vue d'ensemble, voir Runs, acceptation et changements.
| Symptôme | Solution |
|---|---|
| Publish (« Publier ») refusé | Lisez la liste de problèmes — elle est exhaustive. La validation signale tout d'un coup ; corriger les éléments listés est tout le travail. Voir Cycle de vie d'un workflow. |
| Un run ne démarre pas | En général : un run est déjà ouvert sur cette mission, ou la mission n'est pas encore planifiée. Acceptez ou écartez le run ouvert, ou laissez la planification se terminer, puis relancez. Voir Runs, acceptation et changements. |
| Accept (« Accepter ») refusé | Les choses ont bougé sous le run — la pointe de la mission a avancé ou la fusion entre en conflit. Rien n'a atterri ; lancez un run frais depuis la nouvelle pointe. Voir Accepter. |
| Une gate semble bloquée | Elle vous attend. Ouvrez le tableau Decisions — la carte de la gate porte ses instructions et d'éventuels champs à remplir. |
| Impossible de modifier un workflow publié | C'est voulu — les workflows publiés sont immuables. Clonez-le en un nouveau draft, modifiez, et publiez une nouvelle version. Voir Cycle de vie d'un workflow. |
Surprises de coût
- Ouvrez le tableau Costs, filtrez sur la période en question.
- La vue par mission montre quelle mission et quel point d'appel ont dépensé l'argent.
- Si une tâche unique a beaucoup mangé, ouvrez-la et regardez le modèle — parfois une chaîne de fallback vous a basculé sur un modèle plus cher sans que vous le remarquiez.
Je ne peux pas me connecter
- Confirmez l'URL :
https://<votre-slug>.ards.etiakorp.com/. - Essayez une fenêtre de navigation privée (élimine un cookie périmé).
- Si vous venez de définir un nouveau mot de passe, laissez DNS / TLS encore une minute.
- Toujours coincé après 5 minutes → ouvrez un ticket de support (envoyez-nous un email si vous ne pouvez littéralement pas ouvrir la page de tickets).
Autre chose semble ne pas aller / cette doc est incomplète
Cette doc est en v1. Des manques et des inexactitudes sont probables. Dites-le-nous — voir Obtenir de l'aide. Ce qui aide : ce que vous étiez en train de faire, ce que vous avez vu, un horodatage approximatif, et une capture d'écran si c'est visuel.