npm create cloudflare@latest -- my-agent --template=cloudflare/agents-starter
cd my-agent
wrangler dev

import { Agent } from "cloudflare-agents";

export class MyAgent extends Agent {
  initialState = {
    messages: [],
    context: {}
  };

  async onMessage(connection, message) {
    // Process message
    const data = JSON.parse(message);

    // Update state (auto-persisted)
    this.setState({
      ...this.state,
      messages: [...this.state.messages, data]
    });

    // Send response
    connection.send(JSON.stringify({ response: "Received" }));
  }
}

import { AIChatAgent } from "cloudflare-agents";

export class ChatBot extends AIChatAgent {
  async onMessage(connection, message) {
    const response = await this.ai.complete({
      model: "@cf/meta/llama-2-7b-chat-int8",
      messages: this.state.messages
    });

    connection.send(response.text);
  }
}

// Run in 60 seconds
this.schedule(60);

// Run at specific time
this.schedule("2024-12-31T23:59:59Z");

// Cron schedule
this.schedule("0 * * * *"); // Every hour

// Query with template literals (safe from injection)
const users = await this.sql`
  SELECT * FROM users
  WHERE id = ${userId}
  AND active = ${true}
`;

// Client-side
const ws = new WebSocket("wss://your-domain.com/agents/MyAgent/instance-id");

ws.onmessage = (event) => {
  console.log(JSON.parse(event.data));
};

ws.send(JSON.stringify({ type: "chat", message: "Hello!" }));