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.
champrep ai -p "list the Go files here and count them"Lire l’invite à partir de l’entrée standard avec -p -:
git diff | champrep ai -p -
En lecture seule par défaut
Section intitulée « En lecture seule par défaut »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 :
| Option | Effet |
|---|---|
--allowed-tools RULES | Pré-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-edits | Autoriser la modification des fichiers au sein de l’espace de travail. Les commandes nécessitent toutefois une règle d’autorisation. |
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.
Autres options
Section intitulée « Autres options »| Option | Effet |
|---|---|
--output text | Par 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 json | Diffuser des événements NDJSON vers la sortie standard. --json a le même effet lorsque --output n’est pas défini. |
--max-turns N | S’arrêter après N itérations du modèle. Une fois la limite atteinte, l’exécution s’interrompt avec une erreur. |
--model NAME | auto (par défaut), un identifiant de modèle de plateforme ou le nom d’un modèle que vous avez enregistré. |
--add-dir PATH | Ajouter un autre répertoire à l’espace de travail. Opération reproductible. |
--verbose | Affichez également les lignes d’état dans la sortie texte. |
Sortie JSON
Section intitulée « Sortie JSON »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.
Codes de sortie
Section intitulée « Codes de sortie »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.
Utiliser une cléAPI dans CI
Section intitulée « Utiliser une cléAPI dans CI »-
Créer une clé qui inclut le
ai:agentportée, ainsi que les portées de tout autrechamprepcommandes exécutées par la tâche.ai:agentdoit ê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 -
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. -
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.ndjsonLes 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.