Repolode
Enviar
openai

openai/swarm

Framework experimental y educativo de Python para coordinar varios agentes de forma ligera mediante Agents y handoffs sobre la Chat Completions API.

Ver en GitHub
Estrellas
22,113
Forks
2,351
Issues abiertos
38
Último commit
hace 7 meses

¿Qué es?

Swarm es un framework de Python para coordinar varios agentes de LLM. Sus dos componentes principales son Agent, que agrupa instrucciones y funciones invocables, y los handoffs, que permiten que un agente transfiera la conversación a otro. El método run() del cliente procesa en bucle las respuestas del modelo, la ejecución de herramientas y los cambios de agente hasta que no se realizan más llamadas a funciones; después devuelve los mensajes actualizados, el agente activo y las variables de contexto.

Swarm se basa por completo en la Chat Completions API y no conserva estado entre llamadas, por lo que quien lo invoca debe volver a pasar el historial de mensajes en cada turno. Admite streaming, variables de contexto por ejecución que pueden consultar los agentes y las funciones, y un REPL de demostración para probar una configuración desde la línea de comandos.

El proyecto es explícitamente experimental y educativo. OpenAI señala que ha sido sustituido por OpenAI Agents SDK, que el equipo recomienda para uso en producción.

Funciones clave

  • 01Los objetos Agent combinan instrucciones con funciones de Python que puede invocar el modelo.
  • 02Los handoffs permiten que un agente transfiera la conversación a otro.
  • 03Las variables de contexto se pasan a las funciones y a las instrucciones dinámicas.
  • 04Se basa en la Chat Completions API y no mantiene estado en el servidor.
  • 05Admite respuestas en streaming y un ciclo de demostración por línea de comandos.

Casos de uso

  • Aprender en la práctica cómo funcionan los handoffs entre agentes y las llamadas a herramientas.
  • Crear prototipos de flujos de triaje que dirijan las solicitudes a agentes especializados.
  • Crear demostraciones de atención al cliente con agentes distintos para cada tarea.

Inicio rápido

  1. 1

    Instala Swarm desde GitHub con pip (requiere Python 3.10 o posterior).

    pip install git+https://github.com/openai/swarm.git
  2. 2

    Crea un cliente de Swarm, define agentes y funciones y, después, llama a client.run() como se muestra en el ejemplo de uso del README.

Antes de usarlo

  • Swarm es experimental y educativo; no está pensado para usarse en producción.
  • El README indica que Swarm ha sido reemplazado por OpenAI Agents SDK, que se recomienda para producción.
  • Swarm se basa en la API Chat Completions y no conserva el estado entre llamadas, así que debes gestionar el historial de la conversación por tu cuenta.

En colecciones

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

Temas

#multi-agent#llm#agent-framework#openai#function-calling#python

Preguntas frecuentes

¿Qué es swarm?
Framework experimental y educativo de Python para coordinar varios agentes de forma ligera mediante Agents y handoffs sobre la Chat Completions API. Swarm es un framework de Python para coordinar varios agentes de LLM. Sus dos componentes principales son Agent, que agrupa instrucciones y funciones invocables, y los handoffs, que permiten que un agente transfiera la conversación a otro. El método run() del cliente procesa en bucle las respuestas del modelo, la ejecución de herramientas y los cambios de agente hasta que no se realizan más llamadas a funciones; después devuelve los mensajes actualizados, el agente activo y las variables de contexto.
¿swarm es gratuito? ¿Qué licencia tiene?
swarm es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿swarm sigue mantenido?
Sin commits en más de 6 meses. El último commit de swarm fue el 15 abr 2026.
¿Para qué puedo usar swarm?
Aprender en la práctica cómo funcionan los handoffs entre agentes y las llamadas a herramientas. Crear prototipos de flujos de triaje que dirijan las solicitudes a agentes especializados. Crear demostraciones de atención al cliente con agentes distintos para cada tarea.
¿Cómo se instala swarm?
Instala Swarm desde GitHub con pip (requiere Python 3.10 o posterior).: pip install git+https://github.com/openai/swarm.git Crea un cliente de Swarm, define agentes y funciones y, después, llama a client.run() como se muestra en el ejemplo de uso del README.
¿Dónde consigo swarm?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/openai/swarm

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

Proyectos relacionados