Sync docs for PR #683: add task management and workflow integration

[agents-git-bot]

Summary

Adds comprehensive documentation for task runner with Cloudflare Workflows integration based on the new example added in cloudflare/agents.

Changes

• New Guide: Created /agents/guides/task-runner-workflows.mdx - A complete how-to guide showing how to build a task runner that integrates Agents with Workflows
• Updated API Reference: Enhanced /agents/api-reference/run-workflows.mdx to link to the new guide

Key topics covered

• Two patterns for background tasks: Quick Analysis (Agent-based) and Deep Analysis (Workflow-based)
• When to use each pattern (comparison table)
• Complete implementation walkthrough with TypeScript examples
• Workflow configuration with durable steps and automatic retries
• Real-time progress tracking via WebSocket
• React client integration with useAgent hook

Source

Based on PR cloudflare/agents#683: add task management and workflow integration
cloudflare/agents#683

Generated with Claude Code https://claude.com/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://0cdf433d.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/task-runner-workflows/	https://sync-docs-pr-683.preview.developers.cloudflare.com/agents/guides/task-runner-workflows/
https://developers.cloudflare.com/agents/api-reference/run-workflows/	https://sync-docs-pr-683.preview.developers.cloudflare.com/agents/api-reference/run-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

[github-actions]

CI run failed: build logs