Repolode
Enviar
VRSEN

VRSEN/agency-swarm

Framework de Python para crear sistemas multiagente en los que agentes de IA con roles definidos se pasan el trabajo mediante flujos de comunicación explícitos.

Ver en GitHubSitio web
Estrellas
4,629
Forks
1,063
Issues abiertos
9
Último commit
hace 5 días

¿Qué es?

Agency Swarm es un framework de Python para crear aplicaciones compuestas por varios agentes de IA que colaboran, organizados como un equipo real. Cada agente tiene su propio rol, instrucciones y herramientas, y el desarrollador define qué agentes pueden iniciar conversaciones con otros. El framework está construido sobre OpenAI Agents SDK y añade una capa de orquestación.

Los agentes se comunican mediante una herramienta específica llamada send_message, y el conjunto direccional communication_flows definido en una Agency determina quién puede contactar con quién. Las herramientas se pueden escribir como funciones de Python con el decorador @function_tool, como subclases de BaseTool con campos de Pydantic o generarse a partir de esquemas OpenAPI. El historial de conversaciones se puede guardar mediante callbacks de carga y guardado, por ejemplo, en una base de datos o un sistema de almacenamiento de archivos.

El proyecto requiere Python 3.12 o posterior y admite de forma nativa los modelos de OpenAI. También permite usar otros proveedores, como Anthropic, Gemini y Azure OpenAI, a través de LiteLLM. Incluye una demo web y una interfaz de terminal para ejecutar una agencia.

Funciones clave

  • 01Define roles para los agentes, con instrucciones, herramientas y ajustes de modelo propios.
  • 02Restringe la comunicación entre agentes mediante flujos direccionales.
  • 03Crea herramientas con seguridad de tipos a partir de funciones de Python, clases BaseTool o esquemas OpenAPI.
  • 04Guarda el historial de conversaciones mediante callbacks de carga y guardado.
  • 05Permite ejecutar la agencia mediante una demo web, una interfaz de terminal o la API asíncrona get_response.

Casos de uso

  • Prototipar un equipo de agentes especializados, como un agente CEO que delega tareas en agentes desarrolladores y asistentes.
  • Crear automatizaciones internas en las que los agentes llaman a API existentes descritas mediante esquemas OpenAPI.
  • Ejecutar flujos de trabajo multiagente que necesitan conservar el estado de las conversaciones entre sesiones.

Inicio rápido

  1. 1

    Instala el framework con pip

    pip install -U agency-swarm
  2. 2

    Configura tu clave de API de OpenAI en un archivo .env o en la shell

    export OPENAI_API_KEY="YOUR_API_KEY"
  3. 3

    Empieza con Agency Starter Template y sigue el README para definir agentes y flujos de comunicación

Antes de usarlo

  • Requiere Python 3.12 o posterior.
  • Necesita una clave de API de OpenAI u otro proveedor de modelos compatible para ejecutar agentes.
  • La migración desde v0.x requiere adaptar los proyectos a la nueva versión basada en SDK.

En colecciones

Frameworks de orquestación multiagenteFrameworks y apps de agentes de IA open source

Temas

#multi-agent#llm#agents#python#openai#orchestration

Preguntas frecuentes

¿Qué es agency-swarm?
Framework de Python para crear sistemas multiagente en los que agentes de IA con roles definidos se pasan el trabajo mediante flujos de comunicación explícitos. Agency Swarm es un framework de Python para crear aplicaciones compuestas por varios agentes de IA que colaboran, organizados como un equipo real. Cada agente tiene su propio rol, instrucciones y herramientas, y el desarrollador define qué agentes pueden iniciar conversaciones con otros. El framework está construido sobre OpenAI Agents SDK y añade una capa de orquestación.
¿agency-swarm es gratuito? ¿Qué licencia tiene?
agency-swarm es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿agency-swarm sigue mantenido?
Mantenimiento activo. El último commit de agency-swarm fue el 2 nov 2026.
¿Para qué puedo usar agency-swarm?
Prototipar un equipo de agentes especializados, como un agente CEO que delega tareas en agentes desarrolladores y asistentes. Crear automatizaciones internas en las que los agentes llaman a API existentes descritas mediante esquemas OpenAPI. Ejecutar flujos de trabajo multiagente que necesitan conservar el estado de las conversaciones entre sesiones.
¿Cómo se instala agency-swarm?
Instala el framework con pip: pip install -U agency-swarm Configura tu clave de API de OpenAI en un archivo .env o en la shell: export OPENAI_API_KEY="YOUR_API_KEY" Empieza con Agency Starter Template y sigue el README para definir agentes y flujos de comunicación
¿Dónde consigo agency-swarm?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/VRSEN/agency-swarm

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados