Cloudflare Agents - La plataforma para construir agentes de IA

什么是 Cloudflare Agents

Desarrollar AI Agents robustos y escalables sigue siendo un desafío significativo para los equipos de ingeniería. Los desarrolladores enfrentan problemas recurrentes: la ejecución sin estado complica la gestión del contexto, mantener conversaciones largas requiere soluciones externas complejas, y los WebSockets permanente generan costos elevados durante períodos de inactividad. Estas limitaciones técnicas ralentizan la innovación y aumentan la complejidad operativa.

Cloudflare Agents emerge como una solución nativa de edge computing diseñada específicamente para construir Agents inteligentes. La plataforma está construida sobre la red global de Cloudflare, que abarca 330 ciudades en más de 125 países y procesa un promedio de 93 millones de solicitudes HTTP diarias. Esta infraestructura de borde permite ejecutar Agents con latencia mínima en cualquier ubicación geográfica, ofreciendo una experiencia fluida para usuarios distribuidos globalmente.

La propuesta de valor central de Cloudflare Agents combina tres pilares tecnológicos fundamentales. Primero, Durable Objects proporciona ejecución con estado real: cada Agent opera como un microservidor persistente donde el estado se mantiene automáticamente entre despliegues y períodos de hibernación, eliminando la necesidad de bases de datos externas para gestionar contexto. Segundo, Workers AI ofrece inferencia sin servidor con GPU, soportando modelos como Llama, Claude, Gemini y DeepSeek con facturación por Neurons utilizados. Tercero, el modelo de precios por uso garantiza que solo se paga por los recursos realmente consumidos, sin costos fijos ni cargos por capacidad inactiva.

Un caso de éxito concreto demuestra las capacidades de la plataforma: Knock utilizó Cloudflare Agents SDK para construir un servidor MCP remoto, lográndolo en tiempo récord y entregándolo directamente a sus clientes. Este ejemplo ilustra cómo la plataforma acelera el desarrollo de Agents complejos con integración de protocolos estándar.

---

Cloudflare Agents 的核心功能

La plataforma proporciona un conjunto completo de funcionalidades diseñadas para resolver los desafíos técnicos que enfrentan los desarrolladores de Agents. Cada característica está optimizada para integrarse con el ecosistema Cloudflare y ofrecer rendimiento de nivel de producción.

El Agent SDK representa el núcleo del framework. Construido sobre TypeScript, permite definir Agents mediante clases que heredan de la clase base Agent. Los métodos expuestos utilizan el decorador @callable() para crear endpoints RPC accesibles desde clientes y otros Agents. Esta arquitectura permite que los Agents mantengan estado interno mientras exponen interfaces limpias para interacción externa. El soporte nativo para WebSockets permite conexiones de larga duración, y la característica de Hibernation pausa la facturación cuando no hay actividad, manteniendo la conexión activa sin costos adicionales.

Cada Agent incluye almacenamiento SQLite integrado y estado clave-valor que se sincroniza automáticamente con el cliente. Esta funcionalidad elimina la necesidad de configurar bases de datos externas para gestionar contexto conversacional o estado de aplicación. El estado persiste entre despliegues y survives a los períodos de hibernación del Agent, proporcionando continuidad operativa sin configuración adicional.

Para casos de uso comunes, AIChatAgent ofrece una implementación lista para producción. Este Agent especializado proporciona chat AI con persistencia de mensajes, soporta streaming de respuestas mediante streamText, e incluye hooks de React como useAgentChat para integración directa con interfaces de usuario. La recuperación automática ante desconexiones garantiza una experiencia de usuario fluida.

La compatibilidad con múltiples modelos asegura flexibilidad arquitectónica. Workers AI incluye modelos como Llama 3.1, 3.2 y 3.3, Mistral, DeepSeek R1, Gemma y Qwen. Para requisitos específicos, la plataforma permite integrar modelos de terceros como OpenAI GPT-4, Anthropic Claude y Google Gemini mediante AI Gateway, proporcionando una capa unificada de abstracción.

El sistema de herramientas extiende las capacidades de los Agents más allá de la inferencia AI. Cualquier método decorado con @callable() puede invocarse como herramienta, permitiendo que Agents interactúen con APIs externas, operen bases de datos o ejecuten procesos de negocio complejos. La integración con MCP (Model Context Protocol) permite exponer herramientas para otros Agents y conectar con el ecosistema de servidores MCP disponibles.

---

技术架构与核心特性

La arquitectura técnica de Cloudflare Agents está diseñada para escalar a millones de instancias mientras mantiene latencia mínima y costos predecibles. Comprender estos componentes técnicos permite a los equipos arquitectónicos tomar decisiones informadas sobre integración.

Durable Objects constituye el fundamento de la ejecución con estado. Cada Agent se ejecuta dentro de un Durable Object, que es una instancia de servidor con estado propia. A diferencia de funciones serverless tradicionales que son efímeras, los Durable Objects persisten entre invocaciones. El estado se almacena en almacenamiento local SQLite y se sincroniza automáticamente con clientes conectados. Esta arquitectura permite que un Agent mantenga contexto conversacional, preferencias de usuario o estado de negocio sin recurrir a bases de datos externas.

Workers AI proporciona inferencia de modelos con GPU a través de una API serverless. Los modelos se ejecutan en infraestructura GPU optimizada de Cloudflare, con facturación basada en Neurons—una unidad que representa el procesamiento de tokens de manera eficiente. El modelo de precios esgranular: solo se paga el tiempo de CPU realmente utilizado, no el tiempo de pared (wall time). Esto permite optimización significativa de costos comparado con proveedores que cobran por duración de instancia.

Vectorize es la base de datos vectorial nativa para búsqueda semántica y aplicaciones RAG (Retrieval-Augmented Generation). Permite almacenar embeddings y realizar búsquedas de similitud con baja latencia, fundamental para construir Agents que necesitan acceder a conocimiento contextualizado.

D1 ofrece bases de datos SQL serverless con compatibilidad SQLite. La integración con Agents es directa: cada Durable Object puede acceder a su instancia D1 asociada para almacenamiento relacional estructurado.

Workflows extiende las capacidades más allá de ejecuciones de corta duración. Esta característica permite coordinar tareas de múltiples pasos con garantías de ejecución: reintentos automáticos ante fallos, estado persistente entre pasos, y soporte para tareas que duran días o semanas. Es ideal para procesos de negocio complejos que requieren intervención humana o ejecución prolongada.

La integración con MCP permite construir生态系统 de Agents cooperativos. Los servidores MCP exponen herramientas que pueden invocarse desde cualquier Agent, habilitando arquitecturas distribuidas donde diferentes Agents especializados colaboran para completar tareas complejas.

---

快速开始

Comenzar con Cloudflare Agents requiere mínimo setup y permite ver resultados en minutos. El ecosistema está diseñado para desarrolladores familiarizados con Node.js y TypeScript, ofreciendo una experiencia de desarrollo fluida desde el IDE hasta producción.

Requisitos previos: Node.js 18 o superior, npm, y una cuenta de Cloudflare. No se requiere configuración de infraestructura adicional.

La instalación se completa en cuatro comandos que bootstrapean un proyecto completo con ejemplos funcionales:

npm i agents
npx create-cloudflare@latest --template cloudflare/agents-starter
cd agents-starter && npm install
npm run dev

Este scaffold proporciona un Lunch Agent funcional que demuestra las capacidades principales del framework. El código ejemplo muestra la definición de un Agent como clase TypeScript:

export class LunchAgent extends Agent<Env, LunchState> {
  @callable()
  async nominateRestaurant(restaurantName: string) {
    // Lógica de提名餐厅
  }
}

El Agent de ejemplo incluye implementación completa de chat con IA, herramientas invocables, scheduler para tareas programadas, y estado persistente. Sirve como plantilla para cualquier caso de uso, desde chatbots hasta sistemas de automatización.

Para desarrollo local, npm run dev inicia un servidor de desarrollo con hot reload. Los logs detallados y el debugging integrado facilitan la identificación de problemas durante la construcción.

Despliegue a producción se realiza con Wrangler CLI:

npx wrangler deploy

El comando automáticamente configura Workers, Durable Objects y cualquier recurso adicional requerido. La URL pública queda disponible inmediatamente, lista para recibir tráfico de producción.

---

Cloudflare Agents 的定价方案

El modelo de precios de Cloudflare Agents está diseñado para escalar desde experimentación gratuita hasta producción empresarial, con facturación granular que solo carga recursos efectivamente consumidos.

Workers Plan Comparison

El plan Free incluye 100,000 solicitudes diarias con 10ms de CPU por request—suficiente para desarrollo, testing y proyectos personales. El plan Paid comienza en $5/mes con 10 millones de solicitudes y 30 millones de CPU ms mensuales, con cargos adicionales por uso excedente: $0.30 por millón de requests y $0.02 por millón de CPU ms.

Workers AI Pricing (por millón de tokens)

Todos los modelos incluyen 10,000 Neurons gratuitos diarios para desarrollo y experimentación. Excedentes se facturan a $0.011 por cada 1,000 Neurons. El modelo de facturación por Neurons—en lugar de tiempo de ejecución—asegura costos predecibles independientemente de la eficiencia del modelo.

Durable Objects Pricing

Esta estructura permite optimización de costos significativa. Un Agent con WebSocket que permanece inactivo por horas solo facturará los momentos de actividad real, mientras la conexión se mantiene abierta mediante hibernación sin costo adicional.

---

生态与集成

Cloudflare Agents no es una plataforma aislada—está diseñado para integrarse con el ecosistema más amplio de herramientas y servicios que las équipes de desarrollo ya utilizan.

La compatibilidad con MCP (Model Context Protocol) abre puertas a integraciones profundas. El ecosistema MCP incluye conectores para Slack, GitHub, bases de datos PostgreSQL, MySQL, y muchos más. Los desarrolladores pueden construir servidores MCP personalizados que exponen herramientas específicas del negocio, permitiendo que cualquier Agent—ya sea construido en Cloudflare o externamente—invoque estas capacidades mediante el protocolo estándar.

La integración con AI Gateway proporciona abstracción sobre proveedores de modelos externos. Esto permite conectar con OpenAI, Anthropic Claude, y Google Gemini sin modificar código de aplicación. AI Gateway maneja autenticación, rate limiting, y logging centralizado, simplificando la operación de arquitecturas multi-proveedor.

El ecosistema de herramientas para desarrolladores incluye: Wrangler CLI para deployment y gestión, Workers Playground para experimentación sin setup, integración nativa con Chrome DevTools para debugging, y soporte completo para TypeScript con tipos generados automáticamente.

Los recursos comunitarios aceleran el aprendizaje: el repositorio GitHub incluye ejemplos como Lunch Agent, Chat Agent, y Slack Agent que demuestran patrones de implementación. La comunidad de Discord de Cloudflare—con decenas de miles de miembros—proporciona soportepeer-to-peer y discusión técnica activa.

Para implementaciones empresariales, la plataforma cuenta con certificaciones SOC 2 y cumplimiento GDPR, facilitando la adopción en entornos regulados. La integración con sistemas existentes se simplifica mediante APIs REST y webhooks.

---

常见问题