Keyboard shortcuts

Press or to navigate between chapters

Press ? to show this help

Press Esc to hide this help

Ejecutar agentes

Como no existe un “el agente” privilegiado, cada comando que controla un agente debe nombrar cuál. Los agentes coexisten; te diriges a uno mediante su alias.

Dirigirse a un agente

En la CLI, el alias del agente es obligatorio, no hay un agente predeterminado:

sh

zeroclaw agent -a <alias> -m "hola"

El alias es la mitad <alias> de un bloque [agents.<alias>]. Para conocer la superficie completa de la CLI y todos los flags, consulta la referencia de la CLI generada.

Coexistencia y aislamiento

Los agentes se ejecutan en paralelo desde una sola instalación. Cada uno mantiene su propio espacio de trabajo, memoria e identidad (consulta Filesystem components), por lo que, de forma predeterminada, nada de lo que hace un agente se filtra a otro. Solo comparten lo que sus configuraciones referencian en común: un proveedor, un canal, un bundle.

Hay dos formas en que un agente se comunica con otro, cada una controlada por separado:

  • Mensajería en un canal compartido: dos agentes pueden dirigirse entre sí solo cuando comparten un grupo de pares.
  • Delegación: un agente puede entregar una tarea a otro agente solo cuando se cumplen ambas condiciones: el delegation_policy.mode de su propio perfil de riesgo es allow (el valor predeterminado es forbidden), y el agente de destino comparte el mismo perfil de riesgo. La delegación nunca cruza niveles de confianza: un agente con un perfil reforzado no puede delegar a uno con un perfil permisivo. El perfil de riesgo compartido es en sí mismo la lista de permitidos: la lista de delegados ofrecida al modelo es exactamente los demás agentes del perfil del llamador, y solo cuando la delegación está permitida. Consulte Delegation & SubAgents para conocer el comportamiento completo de la verificación y los mensajes exactos de rechazo.

Cuando un agente necesita un ayudante puntual en lugar de un par existente, genera un SubAgent efímero que hereda su identidad y política de seguridad para una sola tarea, y luego desaparece.

Agentes en zerocode

zerocode es la interfaz de terminal para manejar agentes. Dos paneles ponen un agente frente a ti:

  • El panel Code ejecuta un agente sobre tu árbol de trabajo para tareas de programación.
  • El panel de Chat es una vista conversacional de un agente.

Ambos paneles controlan un agente específico, y zerocode puede asignar a cada agente su propia paleta de colores para que puedas distinguirlos de un vistazo, consulta Temas por agente. El panel Config es el lugar preferido para añadir y conectar agentes sin editar archivos manualmente.

Operar múltiples agentes a la vez

zeroclaw daemon levanta juntos todos los agentes habilitados, cada uno respondiendo en sus propios canales. Agregar un agente es aditivo: define un nuevo bloque [agents.<alias>], conecta sus referencias, y se une al conjunto en ejecución; los agentes existentes no se ven afectados.

Para los detalles internos del runtime, el modelo de permisos, el modelo de memoria y el bucle del agente, consulta Runtime internals.