Skip to content

Conversation

@threepointone
Copy link
Contributor

Summary

This PR adds comprehensive documentation explaining the layered architecture of the Agent class from the Agents SDK.

The new documentation covers:

  • Layer 0: Durable Object - The base primitives (constructor, RPC, fetch, WebSockets, alarms, storage)
  • Layer 1: PartyKit Server - The opinionated wrapper providing developer-friendly callbacks
  • Layer 2: Agent - The full-featured agent implementation with state persistence, scheduling, MCP, email handling, and more

This helps developers understand how Agents are built on top of Durable Objects and PartyKit's Server class, empowering them to make the most of the SDK and avoid common pitfalls.

Source

Synced from cloudflare/agents PR #636

Test plan

  • Documentation follows cloudflare-docs conventions
  • All internal links are valid
  • Code examples use TypeScriptExample component
  • Content is placed in the appropriate location (/agents/concepts/)
  • Frontmatter includes appropriate metadata

🤖 Generated with Claude Code

@github-actions github-actions bot added size/l November 2025 product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. labels Nov 5, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Nov 5, 2025

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/agents/ @irvinebroque, @rita3ko, @elithrar, @thomasgauvin, @threepointone, @cloudflare/pcx-technical-writing

@github-actions
Copy link
Contributor

github-actions bot commented Nov 7, 2025

@Oxyjun Oxyjun enabled auto-merge (squash) November 7, 2025 18:20
@Oxyjun Oxyjun merged commit 99c6fe2 into production Nov 7, 2025
8 checks passed
@Oxyjun Oxyjun deleted the sync-docs-pr-636 branch November 7, 2025 18:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

November 2025 product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. size/l

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants