Cloudflare智能体 cloudflare-agents

---

name: cloudflare-agents description: 在Cloudflare Workers上构建AI智能体，集成MCP协议、工具使用和LLM提供商。 license: MIT

Cloudflare智能体

最后更新: 2025-11-21

快速开始

export default {
  async fetch(request, env, ctx) {
    const agent = {
      tools: [
        { name: 'getTodo', handler: async ({id}) => ({id, title: 'Task'}) }
      ],
      async run(input) {
        return await processWithLLM(input, this.tools);
      }
    };
    
    return Response.json(await agent.run(await request.text()));
  }
};

核心特性

• 工具集成: 注册和执行工具
• LLM提供商: OpenAI、Anthropic、Google Gemini
• MCP协议: 模型上下文协议支持
• Cloudflare绑定: D1、KV、R2、Durable Objects

智能体模式

const agent = {
  tools: [...],
  systemPrompt: '您是一个有用的助手',
  model: 'gpt-4o',
  async run(input) {
    // 使用LLM处理
  }
};

资源

核心文档

• references/patterns-concepts.md (317行) - 什么是Cloudflare智能体，模式与概念，关键规则，已知问题预防
• references/configuration-guide.md (152行) - 完整配置深入指南
• references/agent-api.md (115行) - 完整的智能体类API参考

集成指南

• references/http-sse-guide.md (74行) - HTTP与服务器发送事件
• references/websockets-guide.md (110行) - WebSocket集成
• references/state-management.md (388行) - 状态管理，定时任务，工作流
• references/mcp-integration.md (130行) - 模型上下文协议集成

高级特性

• references/advanced-features.md (637行) - 浏览器自动化，RAG，AI模型集成，调用智能体，客户端API

错误参考

• references/error-catalog.md (10行) - 常见错误及解决方案

模板

• templates/basic-agent.ts - 基本智能体设置
• templates/browser-agent.ts - 浏览器自动化
• templates/calling-agents-worker.ts - 调用其他智能体
• templates/chat-agent-streaming.ts - 流式聊天智能体
• templates/hitl-agent.ts - 人在回路
• templates/mcp-server-basic.ts - MCP服务器集成
• templates/rag-agent.ts - RAG实现
• templates/react-useagent-client.tsx - React客户端集成
• templates/scheduled-agent.ts - 定时任务
• templates/state-sync-agent.ts - 状态同步
• templates/websocket-agent.ts - WebSocket智能体
• templates/workflow-agent.ts - 工作流集成
• templates/wrangler-agents-config.jsonc - Wrangler配置

官方文档: https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-agents/