mirror of
https://github.com/cloudflare/skills.git
synced 2026-09-14 16:49:26 +08:00
Sunil Pai
e96fbc77bc
Replace legacy building-* guides with a consolidated agents-sdk skill: update SKILL.md to expand capabilities and retrieval links, add multiple new reference pages (client-sdk, configuration, durable-execution, browse-the-web, human-in-the-loop, observability, queue-retries, routing, server-driven-messages, and others), and update command docs (build-agent.md, build-mcp.md) to point to the agents-sdk pages and include scaffold examples. Remove deprecated building-ai-agent-on-cloudflare and building-mcp-server-on-cloudflare content. These changes centralize documentation around the Agents SDK, add scaffold/snippet guidance, and refresh links to the live Cloudflare developer docs.
58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
---
|
|
description: Build an AI agent on Cloudflare using the Agents SDK
|
|
argument-hint: [agent-description]
|
|
allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, WebFetch]
|
|
---
|
|
|
|
# Build AI Agent on Cloudflare
|
|
|
|
## Arguments
|
|
|
|
The user invoked this command with: $ARGUMENTS
|
|
|
|
## Instructions
|
|
|
|
When this command is invoked:
|
|
|
|
1. Read the skill file at `agents-sdk/SKILL.md` for core SDK guidance, APIs, and wrangler config
|
|
2. Based on what the user wants to build, read the relevant references from `agents-sdk/references/`:
|
|
- For chat/AI agents: `streaming-chat.md`, `client-sdk.md`
|
|
- For state management: `state-scheduling.md`
|
|
- For RPC methods: `callable.md`
|
|
- For background work: `workflows.md`, `durable-execution.md`, `queue-retries.md`
|
|
- For MCP integration: `mcp.md`
|
|
- For email handling: `email.md`
|
|
- For webhooks/push: `webhooks-push.md`
|
|
- For approval flows: `human-in-the-loop.md`
|
|
- For voice: `voice.md`
|
|
- For browser tools: `browse-the-web.md`
|
|
- For higher-level chat: `think.md`
|
|
3. Fetch the relevant pages from https://developers.cloudflare.com/agents/ for the latest API details
|
|
4. Always start with `configuration.md` and `routing.md` for project setup
|
|
|
|
## Scaffold Steps
|
|
|
|
1. **Create project**: `npx create-cloudflare@latest --template cloudflare/agents-starter`
|
|
2. **Configure wrangler.jsonc**: DO bindings, migrations, AI binding, assets
|
|
3. **Implement agent class**: extend `Agent` or `AIChatAgent` depending on use case
|
|
4. **Wire routing**: `routeAgentRequest` in the default export
|
|
5. **Build client**: `useAgent` + `useAgentChat` React hooks
|
|
6. **Deploy**: `npx wrangler deploy`
|
|
|
|
## Key Decision: Agent vs AIChatAgent vs Think
|
|
|
|
| Need | Use | Package |
|
|
|------|-----|---------|
|
|
| Custom stateful logic, RPC, scheduling | `Agent` | `agents` |
|
|
| AI chat with streaming, tools, persistence | `AIChatAgent` | `@cloudflare/ai-chat` |
|
|
| AI chat with automatic tool loop, built-in workspace | `Think` | `@cloudflare/think` (experimental) |
|
|
|
|
## Example Usage
|
|
|
|
```
|
|
/build-agent a customer support chatbot with tool calling
|
|
/build-agent a real-time collaborative editor with state sync
|
|
/build-agent a background processing agent with scheduled tasks
|
|
/build-agent a voice assistant that can browse the web
|
|
```
|