mcpField
C
cloudflare-agents

cloudflare-agents

github.com/secondskyAgent 工作流240382 次安装5 周前更新
代码仓库

关于 cloudflare-agents

这是一份面向 Cloudflare LLM 应用开发者的 Agent 构建指南，涵盖工具注册、模型提供方、Cloudflare 绑定、MCP 集成和可复用模板。

主要功能

  1. 01注册并执行工具
  2. 02支持 OpenAI、Anthropic 和 Gemini
  3. 03支持 Cloudflare D1、KV、R2 和 Durable Objects
  4. 04HTTP、SSE 和 WebSocket 模式
  5. 05状态管理与定时任务
  6. 06Agent 和 MCP 集成模板

适用场景

  1. 01构建可调用已注册工具的 Agent
  2. 02让 Agent 连接 Cloudflare 存储绑定
  3. 03实现流式或 WebSocket Agent 界面
  4. 04为 Cloudflare Agent 添加 MCP 集成

MCP 相关

指南涵盖 MCP 协议支持，并提供 MCP 集成参考文档和将 MCP 服务端接入 Agent 的模板。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/secondsky/claude-skills --skill cloudflare-agents

安装后在 Claude Code 中输入/cloudflare-agents确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
advanced-features.md
agent-api.md
configuration-guide.md
error-catalog.md
http-sse-guide.md
mcp-integration.md
patterns-concepts.md
state-management.md
websockets-guide.md
templates/
basic-agent.ts
browser-agent.ts
calling-agents-worker.ts
chat-agent-streaming.ts
hitl-agent.ts
mcp-server-basic.ts
rag-agent.ts
react-useagent-client.tsx
scheduled-agent.ts
state-sync-agent.ts
websocket-agent.ts
workflow-agent.ts
wrangler-agents-config.jsonc

详细介绍

Cloudflare Agents

最后更新：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()));
  }
};

核心功能

  • 工具集成：注册并执行工具
  • 大模型提供商：OpenAI、Anthropic、Google Gemini
  • MCP 协议：支持 Model Context Protocol
  • Cloudflare 绑定：D1、KV、R2、Durable Objects

Agent 模式

const agent = {
  tools: [...],
  systemPrompt: 'You are a helpful assistant',
  model: 'gpt-4o',
  async run(input) {
    // Process with LLM
  }
};

资源

核心文档
  • references/patterns-concepts.md（317 行）- Cloudflare Agents 是什么、模式与概念、关键规则、已知问题的预防方法
  • references/configuration-guide.md（152 行）- 完整的配置深入指南
  • references/agent-api.md（115 行）- 完整的 Agent Class API 参考
集成指南
  • references/http-sse-guide.md（74 行）- HTTP 与服务器发送事件
  • references/websockets-guide.md（110 行）- WebSocket 集成
  • references/state-management.md（388 行）- 状态管理、计划任务、工作流
  • references/mcp-integration.md（130 行）- Model Context Protocol 集成
高级功能
  • references/advanced-features.md（637 行）- 浏览器自动化、RAG、AI 模型集成、调用 Agent、客户端 API
错误参考
  • references/error-catalog.md（10 行）- 常见错误及解决方案
模板
  • templates/basic-agent.ts - 基础 Agent 设置
  • templates/browser-agent.ts - 浏览器自动化
  • templates/calling-agents-worker.ts - 调用其他 Agent
  • templates/chat-agent-streaming.ts - 流式聊天 Agent
  • 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 Agent
  • templates/workflow-agent.ts - 工作流集成
  • templates/wrangler-agents-config.jsonc - Wrangler 配置

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

评论

支持 Markdown