secondsky/claude-skills / plugins/cloudflare-agents/skills/cloudflare-agents
cloudflare-agents
VerifiedBuild AI agents on Cloudflare Workers with MCP integration, tool use, and LLM providers.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.7 KB |
| references/advanced-features.md | markdown | 13.5 KB |
| references/agent-api.md | markdown | 2.9 KB |
| references/configuration-guide.md | markdown | 3.1 KB |
| references/error-catalog.md | markdown | 275 B |
| references/http-sse-guide.md | markdown | 2.0 KB |
| references/mcp-integration.md | markdown | 2.7 KB |
| references/patterns-concepts.md | markdown | 11.0 KB |
| references/state-management.md | markdown | 9.5 KB |
| references/websockets-guide.md | markdown | 3.0 KB |
| templates/basic-agent.ts | script | 383 B |
| templates/browser-agent.ts | script | 4.9 KB |
| templates/calling-agents-worker.ts | script | 3.7 KB |
| templates/chat-agent-streaming.ts | script | 1.5 KB |
| templates/hitl-agent.ts | script | 6.6 KB |
| templates/mcp-server-basic.ts | script | 4.0 KB |
| templates/rag-agent.ts | script | 4.8 KB |
| templates/react-useagent-client.tsx | other | 5.5 KB |
| templates/scheduled-agent.ts | script | 4.5 KB |
| templates/state-sync-agent.ts | script | 3.9 KB |
| templates/websocket-agent.ts | script | 4.1 KB |
| templates/workflow-agent.ts | script | 3.8 KB |
| templates/wrangler-agents-config.jsonc | other | 1.9 KB |
templates/rag-agent.ts
View on GitHub// RAG Agent with Vectorize + Workers AI
import { Agent } from "agents";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
interface Env {
AI: Ai; // Workers AI binding
VECTORIZE: Vectorize; // Vectorize binding
OPENAI_API_KEY?: string; // Optional: OpenAI API key
}
interface RAGState {
documentsIngested: number;
queriesProcessed: number;
lastQuery: string | null;
}
export class RAGAgent extends Agent<Env, RAGState> {
initialState: RAGState = {
documentsIngested: 0,
queriesProcessed: 0,
lastQuery: null
};
async onRequest(request: Request): Promise<Response> {
const url = new URL(request.url);
// POST /ingest - Ingest documents
if (url.pathname === "/ingest") {
const { documents } = await request.json();
// documents: Array<{ id: string, text: string, metadata: any }>
const count = await this.ingestDocuments(documents);
return Response.json({
ingested: count,
total: this.state.documentsIngested + count
});
}
// POST /query - Query knowledge base
if (url.pathname === "/query") {
const { query, topK } = await request.json();
const results = await this.queryKnowledge(query, topK || 5);
return Response.json({
query,
matches: results.matches,
context: results.context
});
}
// POST /chat - RAG-powered chat
if (url.pathname === "/chat") {
const { message } = await request.json();
const response = await this.chat(message);
return Response.json(response);
}
return new Response("Not Found", { status: 404 });
}
// Ingest documents into Vectorize
async ingestDocuments(documents: Array<{ id: string; text: string; metadata?: any }>) {
const vectors = [];
for (const doc of documents) {
// Generate embedding with Workers AI
const { data } = await this.env.AI.run('@cf/baai/bge-base-en-v1.5', {
text: [doc.text]
});
vectors.push({
id: doc.id,
values: data[0],
metadata: {
text: doc.text,
...doc.metadata
}
});
}
// Upsert into Vectorize (batch operation)
await this.env.VECTORIZE.upsert(vectors);
// Update state
this.setState({
...this.state,
documentsIngested: this.state.documentsIngested + vectors.length
});
return vectors.length;
}
// Query knowledge base
async queryKnowledge(userQuery: string, topK: number = 5) {
// Generate query embedding
const { data } = await this.env.AI.run('@cf/baai/bge-base-en-v1.5', {
text: [userQuery]
});
// Search Vectorize
const results = await this.env.VECTORIZE.query(data[0], {
topK,
returnMetadata: 'all'
});
// Extract context from matches
const context = results.matches
.map(match => match.metadata?.text)
.filter(Boolean)
.join('\n\n');
// Update state
this.setState({
...this.state,
queriesProcessed: this.state.queriesProcessed + 1,
lastQuery: userQuery
});
return {
matches: results.matches.map(m => ({
id: m.id,
score: m.score,
metadata: m.metadata
})),
context
};
}
// RAG-powered chat
async chat(userMessage: string) {
// 1. Retrieve relevant context
const { context } = await this.queryKnowledge(userMessage);
// 2. Generate response with context
if (this.env.OPENAI_API_KEY) {
// Use OpenAI with AI SDK
const { text } = await generateText({
model: openai('gpt-4o-mini'),
messages: [
{
role: 'system',
content: `You are a helpful assistant. Use the following context to answer questions accurately:\n\n${context}`
},
{
role: 'user',
content: userMessage
}
]
});
return { response: text, context };
} else {
// Use Workers AI
const response = await this.env.AI.run('@cf/meta/llama-3-8b-instruct', {
messages: [
{
role: 'system',
content: `You are a helpful assistant. Use the following context to answer questions:\n\n${context}`
},
{
role: 'user',
content: userMessage
}
]
});
return {
response: response.response,
context
};
}
}
// Query with metadata filtering
async queryWithFilter(userQuery: string, filters: any) {
const { data } = await this.env.AI.run('@cf/baai/bge-base-en-v1.5', {
text: [userQuery]
});
const results = await this.env.VECTORIZE.query(data[0], {
topK: 5,
filter: filters, // e.g., { category: { $eq: "docs" } }
returnMetadata: 'all'
});
return results;
}
}
export default RAGAgent;
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |