Configuración de agentes
Mapear IDs de agente a comandos CLI y timeouts en config.yaml.
Configuración de agentes
AgentFlow no habla con APIs de agentes directamente. Arranca cada agente como subproceso sin shell (application/internal/agent/exec), pasando un argv plano desde tu config. Cada clave bajo agents: es un id lógico que referencias desde flags (--agent), work.default_agent y reglas de enrutamiento.
El bloque siguiente es una forma realista: varios ids apuntan a ejecutables distintos, con args, modelos, timeouts opcionales y un endpoint HTTP estilo Ollama donde ese tipo de agente lo espera.
Ejemplo
agents:
kiro:
command: kiro
args: ["--cli"]
cursor:
command: cursor-agent
default_model: auto
timeout: 3600
codex:
command: codex
timeout: 3600
claude:
command: claude
timeout: 3600
ollama:
endpoint: http://localhost:11434
model: qwen2.5-coder:14b
embedding_model: nomic-embed-text
timeout: 300Campos
La tabla enlaza campo de config y uso en la capa exec. Nada es implícito: sin timeout, aplican valores por defecto en otros sitios; las claves Ollama solo importan para agentes con ese protocolo.
| Campo | Usado por |
|---|---|
command | Nombre del ejecutable en PATH |
args | argv extra (Kiro, wrappers) |
default_model | Se pasa si el agente admite flags de modelo |
timeout | Segundos antes de kill |
endpoint | URL base HTTP de Ollama |
model / embedding_model | Tags de modelo Ollama |
Valores por defecto en work
work elige qué ids lógicos corren cuando un comando no los anula. Ajústalo cuando implementación, revisor o enriquecedor por defecto deban cambiar en todo el repo.
work:
default_agent: cursor
default_reviewer: codex
default_enricher: ollamaPuedes anular por invocación, p. ej. agentflow dev feat --agent cursor o agentflow review feat --agent codex.
Dry-run
Con --dry-run, la capa exec no lanza subprocesos reales. Útil en CI para validar cableado y para ensayar docs o scripts que esperarían agentes largos.