Add Cloudflare Workflows integration guide for Agents

[agents-git-bot]

Summary

This PR adds comprehensive documentation for integrating Cloudflare Workflows with the Agents SDK, syncing changes from cloudflare/agents PR #683 (add task management and workflow integration).

Changes

• New guide: agents/guides/workflows-integration.mdx - Complete how-to guide demonstrating Cloudflare Workflows integration with Agents SDK
• Updated: agents/concepts/workflows.mdx - Added Cloudflare Workflows integration section with cross-references

What this guide covers

The new guide demonstrates how to:

• Integrate Cloudflare Workflows with Agents for durable, long-running tasks
• Implement step-based checkpointing with automatic retries
• Use step.sleep() for hibernation (hours/days with zero compute cost)
• Implement human-in-the-loop approval with step.waitForEvent()
• Handle RPC communication between Workflows and Agents
• Choose between ctx.waitUntil() and Cloudflare Workflows based on use case

Key features demonstrated

1. Quick Analysis - Using ctx.waitUntil() for sub-30s tasks in Durable Objects
2. Deep Analysis - Using Cloudflare Workflows for durable execution with:
   • Automatic retries with exponential backoff
   • Durable steps that checkpoint progress
   • Human approval gates that can wait days
   • Scheduled follow-up tasks
   • Real-time progress updates via RPC

Related

• Source PR: add task management and workflow integration agents#683
• Example code: https://github.com/cloudflare/agents/tree/main/examples/task-runner

🤖 Generated with Claude Code

[github-actions]

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, @whoiskatrin, @cloudflare/pcx-technical-writing, @cloudflare/ai-agents

[github-actions]

Preview URL: https://b8f46bf7.preview.developers.cloudflare.com
Preview Branch URL: https://sync-docs-pr-683.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link	Updated Link
https://developers.cloudflare.com/agents/guides/workflows-integration/	https://sync-docs-pr-683.preview.developers.cloudflare.com/agents/guides/workflows-integration/
https://developers.cloudflare.com/agents/concepts/workflows/	https://sync-docs-pr-683.preview.developers.cloudflare.com/agents/concepts/workflows/

[agents-git-bot]

Documentation Updates Added

I have enhanced the documentation sync with the following improvements:

New Files

• src/content/docs/agents/concepts/tasks.mdx - Complete Tasks concept documentation covering:

  • TaskContext API (emit, setProgress, signal)
  • Task management methods
  • Client updates via WebSocket
  • Task lifecycle states
  • Links to durable tasks

• src/content/docs/agents/guides/task-runner.mdx - Comprehensive step-by-step guide including:

  • Complete setup instructions
  • Quick tasks vs durable tasks comparison
  • Working code examples for both Agent and Workflow
  • React client implementation
  • Real-time updates explanation

Enhanced Files

• src/content/docs/agents/concepts/durable-tasks.mdx - Added:
  • Important note about retry semantics (entire method wrapped in single workflow step)
  • Expanded "When to use durable tasks" with AgentWorkflow guidance
  • Better distinction between three task patterns: @task(), @task({ durable: true }), and AgentWorkflow

All documentation follows Cloudflare Style Guide requirements:
✅ Uses TypeScriptExample component for code blocks
✅ Uses WranglerConfig component for configuration
✅ Uses PackageManagers component for install commands
✅ Proper use of admonitions (:::note)
✅ Full relative links with trailing slashes
✅ No contractions or exclamation marks

🤖 Generated with Claude Code