Skip to content

Conversation

@agents-git-bot
Copy link

@agents-git-bot agents-git-bot bot commented Nov 24, 2025

Summary

Syncs Agent System documentation from cloudflare/agents PR #675.

This PR adds comprehensive documentation for the new Agent System feature:

  • Getting Started: Setup guide with Worker configuration, Durable Objects binding, LLM provider configuration, and both dashboard and programmatic API usage
  • Architecture: Detailed explanation of the three-layer architecture (Worker handler, Agency DO, SystemAgent DO), middleware pipeline, subagent orchestration, and HITL support
  • API Reference: Complete TypeScript/Worker API documentation including AgentSystem, blueprints, middleware, tools, providers, HTTP routes, and event types

The Agent System provides a framework for building stateful, multi-agent AI systems on Cloudflare Workers with:

  • Built-in middleware for planning (todo lists), file management, and hierarchical agent orchestration
  • Agency-based organization for managing multiple agent blueprints and threads
  • Real-time event streaming via WebSocket
  • Human-in-the-loop (HITL) support for tool approval
  • Subagent spawning for complex multi-agent workflows

Source PR

Documentation Structure

src/content/docs/agents/agent-system/
├── index.mdx (overview)
├── getting-started.mdx
├── architecture.mdx
└── api-reference.mdx

Cloudflare Docs Style Compliance

This documentation follows Cloudflare docs standards:

  • ✅ Uses TypeScriptExample component for code blocks
  • ✅ Uses WranglerConfig component for configuration examples
  • ✅ Uses PackageManagers component where applicable
  • ✅ Full relative links with trailing slashes
  • ✅ Proper frontmatter with pcx_content_type and sidebar ordering
  • ✅ No contractions or non-standard formatting
  • ✅ Clear section structure following Diátaxis framework (getting started guide, concept/architecture, reference)

🤖 Generated with Claude Code

@github-actions github-actions bot added the product:agents Build and deploy AI-powered Agents on Cloudflare that can act autonomously. label Nov 24, 2025
@github-actions
Copy link
Contributor

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 24, 2025

CI run failed: build logs

This sync adds comprehensive documentation for the new Agent System feature:

- Getting started guide with setup and configuration
- Architecture documentation explaining the system components
- Complete API reference for TypeScript/Worker API and HTTP surface

The Agent System provides a framework for building stateful, multi-agent AI systems on Cloudflare Workers with built-in middleware for planning, file management, and hierarchical agent orchestration.

Source PR: cloudflare/agents#675
@agents-git-bot agents-git-bot bot changed the title agents system Sync: agents system Nov 25, 2025
Synced from cloudflare/agents PR #675: agents system

This adds comprehensive documentation for the Agent System framework,
including:
- Getting started guide with setup and configuration
- Architecture documentation explaining the framework design
- Complete API reference for all components

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants