# Agentes ## Que Son los Agentes? Los agentes son asistentes de IA aislados que razonan sobre problemas, ejecutan tareas y se comunican a traves de multiples plataformas. Cada agente tiene su propio espacio de trabajo, historial de sesiones, configuracion de modelo y vinculaciones de canal. ## Aislamiento de Agentes Cada agente obtiene: - **Espacio de trabajo** -- Un directorio dedicado para archivos, notas y datos especificos del agente - **Sesiones** -- Historial de conversaciones independiente y transcripciones - **Configuracion** -- Seleccion de modelo, permisos de herramientas, limites de gasto - **Identidad** -- Una persona unica definida en el archivo `AGENTS.md` del agente - **Perfiles de autenticacion** -- Configuraciones de clave API y autenticacion por agente ## Personas de Agentes El espacio de trabajo de cada agente contiene un archivo `AGENTS.md` que define personalidad, instrucciones y pautas de comportamiento. Este prompt del sistema persistente da forma a como responde el agente -- tono, experiencia en el dominio, formato, uso de herramientas y politicas de seguridad. ## Enrutamiento Multi-Agente Al ejecutar multiples agentes, los mensajes entrantes se enrutan automaticamente basandose en **vinculaciones**: - **Vinculacion de canal** -- Enrutar todos los mensajes de una plataforma (por ejemplo, todo Telegram -> agente `personal`) - **Vinculacion de servidor/espacio de trabajo** -- Enrutar un servidor de Discord o espacio de trabajo de Slack especifico a un agente dedicado - **Vinculacion por tipo de chat** -- Enrutar mensajes privados a un agente y mensajes de grupo a otro - **Vinculacion de contacto/peer** -- Enrutar mensajes de contactos especificos a agentes especificos Las vinculaciones se evaluan en orden de prioridad. La primera coincidencia gana. Los mensajes sin coincidencia van al agente predeterminado. ## Sub-Agentes y Delegacion Los agentes pueden generar sub-agentes para tareas especializadas: - **Delegacion de tareas** -- Descomponer tareas complejas y delegar partes a sub-agentes especializados - **Ejecucion aislada** -- Los sub-agentes se ejecutan en su propio contexto de sesion - **Conversaciones ping-pong** -- Los agentes pueden tener intercambios de ida y vuelta (hasta 5 turnos) para colaborar - **Anuncio de resultados** -- Los resultados de sub-agentes pueden publicarse de vuelta al canal original ## Equipos y Orquestacion Los equipos multi-agente habilitan flujos de trabajo coordinados: - **Ejecucion paralela** -- Ejecutar multiples agentes simultaneamente en diferentes aspectos de una tarea - **Pipelines secuenciales** -- Encadenar agentes donde cada uno construye sobre la salida anterior - **Modo hibrido** -- Combinar ejecucion paralela y secuencial - **Seguimiento de tareas** -- Monitorear el estado del trabajo de cada agente (en cola, ejecutando, completado, error, cancelado) ## Perfiles de Herramientas Controle lo que cada agente puede hacer: | Perfil | Herramientas Disponibles | |---------|----------------| | **minimal** | Solo estado de sesion | | **coding** | E/S de archivos, ejecucion, sesiones, memoria, imagenes | | **messaging** | Envio de mensajes, historial de sesion | | **full** | Todas las herramientas (predeterminado) | Se pueden establecer listas de permitidos/denegados personalizadas por agente y por proveedor de modelo. ## Modo Seguro El Modo Seguro proporciona un sandbox de ejecucion: - **Toggle maestro** -- Habilitar o deshabilitar globalmente - **Controles por agente** -- Deshabilitar para agentes de confianza, mantener activo para otros - **Aprobacion de ejecucion** -- Las operaciones sensibles requieren aprobacion explicita del usuario - **Sincronizacion de politicas** -- Los ajustes se sincronizan en todos los clientes conectados en tiempo real ## Memoria del Agente Cada agente tiene acceso a un sistema de memoria: - **MEMORY.md** -- Notas persistentes e informacion importante entre sesiones - **Archivos de memoria** -- Conocimiento estructurado adicional en `memory/` - **Busqueda vectorial** -- Buscar en la memoria usando consultas en lenguaje natural Consulte [Sesiones y Memoria](sessions-memory.md) para mas detalles.