Repolode
cloudflare

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. 1

    Crea un proyecto nuevo a partir de la plantilla inicial

    npm create cloudflare@latest -- --template cloudflare/agents-starter
  2. 2

    O añade el SDK a un proyecto existente

    npm install agents
  3. 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