FAQ¶
Je n'ai plus le code d'installation ni le lien d'activation.
Ils sont écrits en 0600 dans /data/bootstrap/ du conteneur web (docker compose exec web cat /data/bootstrap/setup-code).
Un lien est réémis au démarrage tant que l'administrateur n'est pas activé.
Une opération répond 403 denied.
Votre rôle ne contient pas la permission de l'opération. harness explain <permission> (ou le simulateur) indique
pourquoi. Les opérations réservées aux humains (human_only) exigent aussi une session web ré-authentifiée.
Une opération répond 202 pending_confirmation.
L'action élargit des droits ou a été jugée sensible : un humain doit l'approuver (page Confirmations en attente). Ce
n'est pas une erreur.
Une clé API répond 401.
Causes possibles : clé expirée ou révoquée, compte désactivé, adresse source hors des IP autorisées, jeton recopié
avec un espace. La page Clés API indique l'état (actif, expiré, révoqué, désactivé) et le dernier usage.
J'ai perdu une clé API.
Elle n'est montrée qu'une fois. Émettez-en une nouvelle (core.svc.key.issue) : l'ancienne est invalidée.
Où est l'OpenAPI ?
GET /api/v1/openapi.json, sans authentification (voir API).
Les liens « ? » ne s'affichent pas ou pointent au mauvais endroit.
Ils utilisent le réglage docs.base_url (/docs/ par défaut, servi par l'entrée Apache). Vide, les liens disparaissent ;
pour une documentation hébergée ailleurs, mettez son URL complète.
Un agent est « sans réponse ». Vérifiez qu'un compte modèle est activé et hors temps de repos (page Comptes modèle), que l'utilisateur a accès à l'agent, et le run correspondant dans Runs & sessions.
Cette documentation est-elle à jour ? Les pages de la section Référence sont générées depuis le code ; la CI échoue si elles sont périmées.