Agentes

Los agentes son la estrella de un despliegue de ZeroClaw. Todo lo demás en este libro —los proveedores, los canales, los perfiles de seguridad, las habilidades, la memoria— existe para que un agente pueda usarlo. Esta sección es el escaparate; el resto de la documentación son los créditos.

Multiagente. ZeroClaw ejecuta muchos agentes desde una sola instalación. Cada agente tiene su propio conjunto de referencias (perfil de riesgo, proveedor de modelo, canales), su propio directorio de espacio de trabajo y su propio backend de memoria. Un agente puede generar un SubAgent efímero que hereda la identidad y la política de seguridad de su padre, y los agentes pueden comunicarse entre sí cuando comparten un peer group. En la configuración, cada agente es un bloque [agents.<alias>]. Consulte Agentes → Detalles internos del runtime.

Un agente es una unión

Un agente no es un programa que se instala. Es una fila con nombre, [agents.<alias>], que une dos mitades:

• Referencias de configuración (el lado relacional): punteros a elementos configurados en otro lugar, un proveedor de modelos, un perfil de riesgo, un perfil de runtime, canales, bundles de skills / conocimiento / MCP, trabajos cron. Cada uno es un alias con puntos. El agente no posee ninguno de estos; apunta hacia ellos, y muchos agentes pueden apuntar al mismo o divergir libremente.
• Componentes de Filesystem (la parte en disco): un directorio de espacio de trabajo por agente, un backend de memoria y una fuente de identidad (personalidad). Aquí es donde el grafo relacional se encuentra con un árbol de directorios concreto.

  Config references (relational)              Filesystem (on-disk)
  ──────────────────────────────             ──────────────────────
  - model provider                           - workspace/
  - risk profile                             - memory store
  - runtime profile          agents.<alias>  - identity / personality
  - channels             ──▶  (the join)  ◀──
  - peer groups
  - skill / knowledge / MCP bundles
  - cron jobs

El agente apunta a las referencias de la izquierda, sin poseer ninguna de ellas: muchos agentes pueden compartir una o divergir libremente. Posee la mitad del sistema de archivos de la derecha.

Cada referencia es un enlace de vuelta a su propia sección, los créditos: los proveedores de modelos se encuentran en Model Providers, los perfiles en Security & Autonomy, los canales en Channels, los grupos de pares en Peer Groups, los paquetes en Tools.

Multiagente desde el principio

No existe un “el agente” privilegiado. El runtime mantiene un mapa de agentes indexado por alias; una instalación de un solo agente es simplemente un mapa de tamaño uno. No empiezas con un bot y le añades más después, sino que agregas agentes y conectas cada uno, y coexisten desde la primera línea de configuración.

Debido a que cada agente une sus propias referencias y su propio sistema de archivos, los agentes pueden compartir algunos ejes y divergir en otros de forma independiente. Dos agentes podrían compartir un mismo proveedor de modelos pero ejecutarse bajo diferentes perfiles de riesgo, responder en diferentes canales y mantener memorias completamente separadas.

Los agentes se comunican entre sí de dos formas, cada una controlada por separado: pueden enviar mensajes en un canal donde comparten un grupo de pares, y pueden delegar una tarea entre sí únicamente cuando el perfil de riesgo del llamador permite la delegación y el destinatario está dentro del conjunto alcanzable del llamador (un par del mismo perfil, o una entrada explícita entre perfiles en la lista delegates del llamador; consulta Ejecución de agentes).

                    agents.researcher          agents.support
                    ─────────────────          ──────────────
  model provider     openrouter.prod ◀───────── openrouter.prod   (same one)
  risk profile       hardened                   permissive        (diverge)
  channel            discord.main               slack.helpdesk    (diverge)
  peers              └──────▶ peer group on discord.main ◀───────┘

Dos agentes comparten un mismo proveedor de modelos, se ejecutan bajo diferentes perfiles de riesgo, responden en diferentes canales y solo coinciden donde comparten un grupo de pares.

Un SubAgent es la excepción de corta duración a la coexistencia: un agente puede generar un SubAgent efímero que hereda la identidad y la política de seguridad del padre para una única tarea. Consulta Delegation & SubAgents.

A dónde ir a continuación

• Anatomía de un agente: cada campo en [agents.<alias>], y a qué apunta cada referencia.
• Componentes de Filesystem: el espacio de trabajo, la memoria y la identidad que residen en disco por cada agente.
• Ejecutar agentes: direccionamiento de agentes, coexistencia y cómo un agente aparece en los paneles Code y Chat de zerocode.

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