README · Cloudflare Deploy · openai/skills · Skills Docs

README · Cloudflare Deploy · openai/skills · Skills Docs

Use Case	Class	Key Features
AI chat interface	`AIChatAgent`	Auto-streaming, tools, message history, resumable
MCP tool provider	`Agent` + MCP	Expose tools to AI systems
Custom logic/routing	`Agent`	Full control, WebSockets, email, SQL
Real-time collaboration	`Agent`	WebSocket state, broadcasts
Email processing	`Agent`	`onEmail()` handler

import { AIChatAgent } from "agents";
import { openai } from "@ai-sdk/openai";

export class ChatAgent extends AIChatAgent<Env> {
  async onChatMessage(onFinish) {
    return this.streamText({
      model: openai("gpt-4"),
      messages: this.messages,
      onFinish,
    });
  }
}

import { Agent } from "agents";

export class MyAgent extends Agent<Env> {
  onStart() {
    this.sql`CREATE TABLE IF NOT EXISTS users (id TEXT PRIMARY KEY)`;
  }
  
  async onRequest(request: Request) {
    return Response.json({ state: this.state });
  }
}

Task	Files to Read
Quick start	README only
Build chat agent	README → api.md (AIChatAgent) → patterns.md
Setup project	README → configuration.md
Add React frontend	README → api.md (Client Hooks) → patterns.md
Build MCP server	api.md (MCP) → patterns.md
Background tasks	api.md (Scheduling, Task Queue) → patterns.md
Debug issues	gotchas.md