Aller au contenu
Documentation

Exécuter l’agent IA en mode sans interface graphique et en CI

Le mode sans interface utilisateur exécute une invite jusqu’à son terme, affiche la réponse, puis se ferme. Il n’affiche jamais d’invite ; par conséquent, toutes les actions qu’il est susceptible d’effectuer doivent être définies au préalable.

Fenêtre de terminal
champrep ai -p "list the Go files here and count them"

Lire l’invite à partir de l’entrée standard avec -p -:

Fenêtre de terminal
git diff | champrep ai -p -

Sans indicateurs supplémentaires, une exécution en mode sans interface graphique est en lecture seule : l’agent peut lire et effectuer des recherches dans l’espace de travail, mais ne peut ni modifier de fichiers ni exécuter de commandes. Toute opération nécessitant une demande d’autorisation est refusée, et le modèle en est informé.

Autorisez davantage de possibilités avec l’un ou l’autre de ces indicateurs :

OptionEffet
--allowed-tools RULESPré-approuver des règles spécifiques pour cette exécution uniquement. Les appels non couverts par une règle sont refusés.
--permission-mode accept-editsAutoriser la modification des fichiers au sein de l’espace de travail. Les commandes nécessitent toutefois une règle d’autorisation.
Fenêtre de terminal
champrep ai -p "fix the failing test" \
--allowed-tools "local_edit_file(src/**),local_bash(go test*)"

Les règles utilisent la syntaxe décrite dans Règles d’autorisation et de refus. Séparez les règles par des virgules ou des espaces, ou répétez l’indicateur. Lorsque vous utilisez l’un ou l’autre de ces indicateurs, les règles de votre fichier de paramètres utilisateur s’appliquent également, et les règles de refus issues des fichiers de paramètres de projet s’appliquent systématiquement. Les règles d’autorisation issues des fichiers de paramètres de projet, ainsi que defaultMode provenant de n’importe quel fichier de paramètres, ne sont pas utilisées lors des exécutions en mode sans interface graphique.

Les actions qui modifient les données de vos CHAMPREPservices ne sont jamais validées en mode sans interface utilisateur. Elles restent en attente, et l’exécution affiche l’identifiant de l’action afin que vous puissiez la valider ou la rejeter dans l’application webCHAMPREP.

OptionEffet
--output textPar défaut. La réponse est envoyée vers la sortie standard ; l’activité de l’outil est envoyée vers la sortie d’erreur standard.
--output jsonDiffuser des événements NDJSON vers la sortie standard. --json a le même effet lorsque --output n’est pas défini.
--max-turns NS’arrêter après N itérations du modèle. Une fois la limite atteinte, l’exécution s’interrompt avec une erreur.
--model NAMEauto (par défaut), un identifiant de modèle de plateforme ou le nom d’un modèle que vous avez enregistré.
--add-dir PATHAjouter un autre répertoire à l’espace de travail. Opération reproductible.
--verboseAffichez également les lignes d’état dans la sortie texte.

Avec --output json, chaque événement correspond à un objet JSON par ligne. Les événements comprennent le texte de la réponse diffusé en continu, les appels d’outilsCHAMPREP et leurs résultats, ainsi que les événements liés aux outils locaux (local_tool_start, local_tool_result, local_resume), et les validations. La dernière ligne est toujours l’une des suivantes :

{"type":"local_result","text":"There are 42 Go files.","conversation_id":"CONVERSATION_ID","suspensions":1,"model":"MODEL_ID","input_tokens":1234,"output_tokens":56}
{"type":"local_error","code":"ERROR_CODE","message":"Explanation of the failure"}

Analysez la dernière ligne pour obtenir le résultat, et considérez les autres types d’événements que vous ne reconnaissez pas comme des informations.

Une exécution réussie se termine par 0. Les échecs utilisent la norme CLI Codes de sortie, par exemple 3 lorsque l’identification est absente ou non valide et 5 lorsqu’une limite a été atteinte. Les refus s’accompagnent d’un message d’aide affiché sur le flux d’erreurs standard, par exemple un forfait n’incluant pas l’agent ou une limite par minute indiquant le nombre de secondes à patienter. Appuyez sur Ctrl+C interrompt l’exécution.

  1. Créer une clé qui inclut le ai:agent portée, ainsi que les portées de tout autre champrep commandes exécutées par la tâche. ai:agent doit être sélectionné par nom ; les portées plus larges ne permettent pas à elles seules l’utilisation d’outils locaux.

    Fenêtre de terminal
    champrep keys create --name "ci-review" --scope ai:agent
  2. Enregistrez-le sous la forme d’un secret CI masqué et protégé nommé CHAMPREP_TOKEN. Il CLI l’utilise directement et n’a pas besoin d’un trousseau de clés.

  3. Exécutez l’agent avec uniquement les autorisations nécessaires à la tâche.

ai-review:
script:
- champrep ai -p "review the changes in this merge request and list problems by severity" --output json --max-turns 20 > review.ndjson
- tail -n 1 review.ndjson

Les commandes exécutées par l’agent ne reçoivent jamais CHAMPREP_TOKEN ou tout autre CHAMPREP_* variable. Pour que l’état des tâches ne soit pas stocké dans le répertoire personnel de votre runner, définissez CHAMPREP_CONFIG_DIR dans un répertoire temporaire.

Voir API Clés pour l’automatisationCLI en matière de rotation et de révision, et Formules et limites pour savoir comment les exécutions de CI sont prises en compte dans vos limites.