Agency Swarm

Agency Swarm: Marco de Orquestación Multi-Agente Confiable

Agency Swarm es un marco de código abierto diseñado para simplificar la creación de agencias de AI aprovechando y extendiendo el OpenAI Agents SDK. Facilita la construcción, orquestación y gestión de enjambres colaborativos de agentes de AI, permitiendo una verdadera colaboración entre agentes con flujos de comunicación definidos por el usuario.

¿Qué es Agency Swarm?

Agency Swarm mejora el OpenAI Agents SDK al introducir características como la verdadera colaboración entre agentes con flujos de comunicación flexibles, una clase Agency para definir la comunicación compleja, la persistencia de conversación flexible y una herramienta especializada send_message para la comunicación entre agentes. Permite a los desarrolladores pensar en la automatización en términos de estructuras organizativas del mundo real, lo que la hace intuitiva tanto para los agentes como para los usuarios.

Características Clave:

• Roles de Agente Personalizables: Define roles de agente distintos (por ejemplo, CEO, Asistente Virtual, Desarrollador) con instrucciones, herramientas y capacidades a medida.
• Control Total Sobre los Prompts/Instrucciones: Mantén un control completo sobre los prompts guía de cada agente para una personalización precisa del comportamiento.
• Herramientas con Tipos Seguros: Desarrolla herramientas utilizando modelos Pydantic para la validación automática de argumentos.
• Comunicación de Agentes Orquestada: Los agentes se comunican a través de una herramienta dedicada send_message, con interacciones gobernadas por flujos de comunicación explícitos y direccionales.
• Persistencia de Estado Flexible: Gestiona el historial de conversaciones proporcionando load_threads_callback y save_threads_callback a la Agency, lo que permite la persistencia entre sesiones (por ejemplo, almacenamiento en DB/archivo).
• Orquestación Multi-Agente: Construye flujos de trabajo de agentes sobre la base del OpenAI Agents SDK, mejorado por la capa de orquestación estructurada de Agency Swarm.
• Enfoque Listo para la Producción: Construido para la fiabilidad y diseñado para una fácil implementación en entornos del mundo real.

¿Cómo funciona Agency Swarm?

Agency Swarm se basa en el OpenAI Agents SDK introduciendo el concepto de una Agency que gestiona múltiples agentes y sus flujos de comunicación. Los componentes clave incluyen:

• Agency: Un orquestador que define los flujos de comunicación entre los agentes utilizando el operador >. También maneja la persistencia de la conversación a través de funciones de callback.
• Agent: Una extensión del Agent SDK base con manejo de archivos incorporado y registro de sub-agentes. A los agentes se les puede asignar roles, instrucciones y herramientas específicas.
• Flujos de Comunicación: Rutas de comunicación explícitas y direccionales definidas en la Agency que rigen cómo interactúan los agentes entre sí.
• Herramientas: Herramientas personalizadas desarrolladas utilizando modelos Pydantic o convertidas desde esquemas OpenAPI, lo que permite a los agentes realizar tareas específicas.

¿Cómo usar Agency Swarm?

1. Instalación: Instala el paquete usando pip: pip install -U agency-swarm
2. Establecer Clave OpenAI: Establece tu clave OpenAI API en un archivo .env o expórtala en tu shell.
3. Crear Herramientas: Define herramientas personalizadas utilizando el decorador @function_tool o extiende BaseTool.
4. Definir Roles de Agente: Define roles de agente con instrucciones, herramientas y capacidades específicas.
5. Definir Flujos de Comunicación de la Agencia: Establece flujos de comunicación entre agentes utilizando la clase Agency y el operador >.
6. Ejecutar una Demostración: Ejecuta una demostración usando la interfaz de usuario web (agency.copilot_demo()), el terminal (agency.terminal_demo()) o programáticamente.

¿Para quién es Agency Swarm?

Agency Swarm está diseñado para desarrolladores, ingenieros de AI e investigadores que desean construir aplicaciones de AI multi-agente complejas. Es particularmente útil para:

• Automatizar tareas complejas que requieren la colaboración entre múltiples agentes de AI.
• Construir flujos de trabajo impulsados por AI que imitan las estructuras organizativas del mundo real.
• Crear aplicaciones de AI listas para la producción que se pueden implementar y escalar fácilmente.

¿Por qué elegir Agency Swarm?

Agency Swarm ofrece varias ventajas sobre los enfoques tradicionales de desarrollo de AI:

• Orquestación Multi-Agente Simplificada: Proporciona un marco estructurado para gestionar y orquestar múltiples agentes de AI.
• Colaboración Mejorada: Permite una verdadera colaboración entre agentes con flujos de comunicación definidos por el usuario.
• Listo para la Producción: Construido para la fiabilidad y diseñado para una fácil implementación en entornos del mundo real.
• Extensible: Aprovecha y extiende el OpenAI Agents SDK, lo que permite a los desarrolladores personalizar y extender el marco para satisfacer sus necesidades específicas.

¿La mejor manera de construir aplicaciones de AI multi-agente?

Agency Swarm proporciona un marco robusto y flexible para construir aplicaciones de AI multi-agente. Al definir los roles de los agentes, los flujos de comunicación y las herramientas personalizadas, los desarrolladores pueden crear flujos de trabajo impulsados por AI que pueden automatizar tareas complejas y resolver problemas del mundo real. El enfoque del marco en la preparación para la producción y la extensibilidad lo convierte en una opción ideal para construir aplicaciones de AI escalables y fiables.

Compatibilidad:

• Python: 3.12+
• Backends de modelos:
  • OpenAI (nativo): Familia GPT-5, GPT-4o, etc.
  • A través de LiteLLM (router): Anthropic (Claude), Google (Gemini), Azure OpenAI, OpenRouter (gateway), etc.
• SO: macOS, Linux, Windows

Conclusión:

Agency Swarm simplifica el desarrollo de aplicaciones de AI multi-agente al proporcionar un marco estructurado para gestionar los roles de los agentes, los flujos de comunicación y las herramientas. Su diseño listo para la producción y su extensibilidad lo convierten en una herramienta poderosa para construir soluciones de AI escalables y fiables. Si estás buscando construir aplicaciones de AI complejas que requieran la colaboración entre múltiples agentes, Agency Swarm es una excelente opción.