iCode Agent · Guide · Automatisation
Automatisez dans les scripts et la CI.
iCode Agent est un agent terminal, mais il n’a pas besoin d’un terminal. Les mêmes tâches qu’en interactif s’exécutent sans interface avec -p, et le flux d’événements complet de l’environnement d’exécution est disponible en JSON.
Mode impression
Exécutez une tâche, imprimez la réponse finale et quittez :
icode-agent -p "run the tests and report failures" /path/to/project
L’espace de travail peut être fourni en argument ou défini avec --cwd <dir>. Le mode impression se termine avec le code 0 lorsque l’exécution a atteint une réponse finale, et 1 sinon — vous pouvez donc tester ce code dans un script.
Mode événements JSON
Ajoutez --mode json pour diffuser chaque événement d’exécution sous forme de ligne JSON, suivie d’une ligne de résultat finale. C’est le mode pour l’outillage : vous obtenez la progression de l’agent sous forme de données, et non de sortie terminal.
icode-agent --mode json -p "find all TODO comments" /path/to/project
Le flux comprend des événements tels que :
run_start— la tâche et l’identité du modèle.iteration_start,assistant_delta— la progression au sein de chaque étape.tool_callettool_result— chaque outil utilisé par l’agent et ce qu’il a renvoyé.model_response— l’usage de tokens pour l’appel, lorsque le fournisseur le signale.compaction,projection_reduced— des événements de gestion du contexte, afin que le comportement des coûts soit visible dans le flux.run_end— le résumé de l’exécution.
Chaque ligne est un objet JSON complet, que des outils standard — jq, un pipeline de logs, une étape de CI — peuvent consommer directement.
Reprendre une session
Les sessions de l’espace de travail sont conservées automatiquement. Reprenez la plus récente, ou reprenez une session précise par son identifiant :
# continue the most recent session in this workspace icode-agent -c -p "now fix the issue you found" /path/to/project # resume a specific session icode-agent --resume <id> -p "add tests for that fix" /path/to/project
Un exemple de CI
Une étape qui demande à l’agent de faire passer la suite et fait échouer le job lorsque le code de retour est non nul :
icode-agent -p "run the full test suite and fix any failures" "$PWD" status=$? if [ "$status" -ne 0 ]; then echo "iCode Agent did not reach a passing state." >&2 exit 1 fi
Instructions et paramètres du projet
Les exécutions sans interface lisent la même configuration que les exécutions interactives :
AGENTS.md(ouCLAUDE.md) à la racine du dépôt est chargé dans le prompt système, afin que les exécutions en CI suivent les règles de votre projet.- Les paramètres globaux se trouvent dans
~/.icode-agent/settings.jsonet peuvent être surchargés pour chaque projet dans.icode-agent/settings.json. - Les modèles de prompts (
.icode-agent/prompts/*.md) et les skills (.icode-agent/skills/<name>/SKILL.md) se chargent automatiquement.
Sur un runner de CI sans ~/.icode-agent, pointez ICODE_AGENT_CONFIG_DIR vers un répertoire préparé pour que la configuration du modèle soit disponible.