Framework de TypeScript para crear agentes de IA con memoria, herramientas, MCP, RAG, voz y flujos de trabajo, además de la consola VoltOps para observabilidad.
cloudflare/agents
SDK de TypeScript para crear agentes de IA persistentes y con estado en Cloudflare Durable Objects, con sincronización en tiempo real, programación de tareas y compatibilidad con MCP.
- Estrellas
- 5,854
- Forks
- 787
- Issues abiertos
- 171
- Último commit
- hace 18 horas
¿Qué es?
Cloudflare Agents es un SDK para ejecutar agentes de IA como unidades persistentes y con estado en Cloudflare Durable Objects. Cada agente conserva su propio estado y almacenamiento, entra en hibernación cuando está inactivo y se activa cuando hace falta, por lo que puedes crear uno por usuario, sesión o sala de juego.
El paquete principal, `agents`, ofrece una clase base `Agent` con estado que se sincroniza en tiempo real con los clientes conectados, métodos invocables mediante el decorador `@callable()` y compatibilidad integrada con la programación de tareas, WebSockets, consultas SQL y llamadas a modelos de IA. Para integrar el frontend, ofrece hooks de React como `useAgent` y `useAgentChat`, además de un cliente de JavaScript vanilla.
El repositorio es un monorepo de pnpm que también incluye paquetes para chat con IA, un enfoque de Code Mode en el que los LLM escriben TypeScript ejecutable, un empaquetador de Workers en tiempo de ejecución y middleware para Hono, además de más de 30 aplicaciones de ejemplo.
Funciones clave
- 01Estado persistente de los agentes, sincronizado en tiempo real con todos los clientes conectados
- 02Métodos invocables con seguridad de tipos mediante el decorador @callable()
- 03Programación de tareas puntuales, recurrentes y basadas en cron
- 04Compatibilidad con servidores y clientes MCP
- 05Flujos de trabajo duraderos de varios pasos con aprobación humana en el proceso
- 06Hooks de React y un cliente de JavaScript vanilla para integrar el frontend
Casos de uso
- Crear un asistente de IA por usuario con memoria persistente e historial de chat
- Crear salas de juegos multijugador en tiempo real donde cada sala sea un agente
- Exponer herramientas a los LLM mediante servidores MCP alojados en Cloudflare Workers
- Ejecutar tareas en segundo plano programadas que invocan modelos de IA
Inicio rápido
- 1
Crea un proyecto nuevo a partir de la plantilla inicial
npm create cloudflare@latest -- --template cloudflare/agents-starter - 2
O añade el SDK a un proyecto existente
npm install agents - 3
Ejecuta un ejemplo localmente desde el repositorio (por ejemplo, el playground)
cd examples/playground npm start
Antes de usarlo
- Está basado en Cloudflare Durable Objects, por lo que está diseñado para ejecutarse en la plataforma de Cloudflare.
- Por el momento no se aceptan pull requests externos.
Temas
Preguntas frecuentes
- ¿Qué es agents?
- SDK de TypeScript para crear agentes de IA persistentes y con estado en Cloudflare Durable Objects, con sincronización en tiempo real, programación de tareas y compatibilidad con MCP. Cloudflare Agents es un SDK para ejecutar agentes de IA como unidades persistentes y con estado en Cloudflare Durable Objects. Cada agente conserva su propio estado y almacenamiento, entra en hibernación cuando está inactivo y se activa cuando hace falta, por lo que puedes crear uno por usuario, sesión o sala de juego.
- ¿agents es gratuito? ¿Qué licencia tiene?
- agents es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
- ¿agents sigue mantenido?
- Mantenimiento activo. El último commit de agents fue el 20 oct 2026.
- ¿Para qué puedo usar agents?
- Crear un asistente de IA por usuario con memoria persistente e historial de chat Crear salas de juegos multijugador en tiempo real donde cada sala sea un agente Exponer herramientas a los LLM mediante servidores MCP alojados en Cloudflare Workers Ejecutar tareas en segundo plano programadas que invocan modelos de IA
- ¿Cómo se instala agents?
- Crea un proyecto nuevo a partir de la plantilla inicial: npm create cloudflare@latest -- --template cloudflare/agents-starter O añade el SDK a un proyecto existente: npm install agents Ejecuta un ejemplo localmente desde el repositorio (por ejemplo, el playground): cd examples/playground npm start
- ¿Dónde consigo agents?
- El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cloudflare/agents
Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.
Proyectos relacionados
SDK de código abierto para crear y ejecutar agentes de IA en Python y TypeScript, con herramientas, MCP, memoria y compatibilidad con distintos modelos.
SDK de TypeScript y Python que ofrece a los agentes de IA más de 1000 toolkits de apps con autenticación previa, sesiones por usuario y un sandbox para ejecutar acciones.
Una biblioteca JavaScript que integra un agente de interfaz gráfica en cualquier página web para que los usuarios controlen la interfaz con lenguaje natural.
Framework de TypeScript para crear agentes de IA y aplicaciones basadas en LLM, con workflows, herramientas, memoria, servidores MCP y evals.
Servidor MCP de código abierto que conecta agentes de IA, IDE y aplicaciones con bases de datos mediante herramientas predefinidas o definiciones personalizadas.