# Workflows

Build durable, multi-step applications using the Workers platform

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/workflows/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [Cloudflare Workflows 概览](https://cloudflaredoc.ubitools.com/workflows/index.md): 在 Cloudflare Workers 上构建持久、多步骤的应用，支持自动重试和状态持久化。

## Python Workflows SDK 概览

- [Python Workflows SDK 概览](https://cloudflaredoc.ubitools.com/workflows/python/index.md): 使用 Python SDK 在 Workers 平台上通过 WorkflowEntrypoint 构建 Cloudflare Workflows。
- [与 Workflow 交互](https://cloudflaredoc.ubitools.com/workflows/python/bindings/index.md): 使用 FFI 绑定从 Python Workers 触发和管理 Workflows，访问 Cloudflare 资源。
- [DAG 工作流](https://cloudflaredoc.ubitools.com/workflows/python/dag/index.md): 在 Python 中使用声明式步骤依赖关系定义有向无环图 (DAG) Workflows。
- [Python Workers API 参考](https://cloudflaredoc.ubitools.com/workflows/python/python-workers-api/index.md): Python Workflows SDK 参考，包括 WorkflowEntrypoint、步骤方法和配置选项。

## 视频

- [视频](https://cloudflaredoc.ubitools.com/workflows/videos/index.md): 使用 Cloudflare Workflows 构建应用的视频教程和演练。

## 示例

- [示例](https://cloudflaredoc.ubitools.com/workflows/examples/index.md): 演示常见 Cloudflare Workflows 模式与集成的代码示例。
- [在 Cloudflare 上构建 Agents](https://cloudflaredoc.ubitools.com/agents/index.md): 在 Cloudflare 上构建 AI 驱动的 Agents
- [导出并保存 D1 数据库](https://cloudflaredoc.ubitools.com/workflows/examples/backup-d1/index.md): 将 D1 数据库导出并保存到 R2 存储
- [动态 Workflows](https://cloudflaredoc.ubitools.com/dynamic-workers/usage/dynamic-workflows/index.md): 通过将 Workflows 与 Dynamic Workers 结合，为每个用户或租户运行不同的 Workflow 逻辑
- [支付购物车并发送发票](https://cloudflaredoc.ubitools.com/workflows/examples/send-invoices/index.md): 购物车结账并付款后发送发票
- [将 Workflows 与 Twilio 集成](https://cloudflaredoc.ubitools.com/workflows/examples/twilio/index.md): 将 Workflows 与 Twilio 集成。了解如何通过 API 和 Webhook 接收和发送短信及电话。
- [使用 waitForEvent 实现人工审批图片标签](https://cloudflaredoc.ubitools.com/workflows/examples/wait-for-event/index.md): 使用 waitForEvent API 的人工审批 Workflow

## Workflows REST API 参考

- [Workflows REST API 参考](https://cloudflaredoc.ubitools.com/api/resources/workflows/methods/list/index.md): 用于以编程方式管理和触发 Cloudflare Workflows 的 REST API 参考。

## build

- [从 Pages 调用 Workflows](https://cloudflaredoc.ubitools.com/workflows/build/call-workflows-from-pages/index.md): 使用 service bindings 或 fetch 调用从 Pages Functions 绑定并触发 Cloudflare Workflows。
- [事件与参数](https://cloudflaredoc.ubitools.com/workflows/build/events-and-parameters/index.md): 使用事件和参数向 Workflows 传递数据，包括请求详情、数据库记录和 Webhook 负载。
- [本地开发](https://cloudflaredoc.ubitools.com/workflows/build/local-development/index.md): 使用 Wrangler 模拟的运行时在本地开发和测试 Cloudflare Workflows。
- [Workflows 设计准则](https://cloudflaredoc.ubitools.com/workflows/build/rules-of-workflows/index.md): 构建 resilient Workflows 的最佳实践，包括幂等性、状态管理和错误处理。
- [休眠与重试](https://cloudflaredoc.ubitools.com/workflows/build/sleeping-and-retrying/index.md): 为 Workflows 步骤配置休眠时长和重试逻辑，包括相对和绝对休眠计时器。
- [步骤上下文](https://cloudflaredoc.ubitools.com/workflows/build/step-context/index.md): 使用 WorkflowStepContext 对象访问 Workflows 步骤中的运行时信息，包括步骤名称和重试次数。
- [测试 Workflows](https://cloudflaredoc.ubitools.com/workers/testing/vitest-integration/test-apis/#workflowsindex.md): 使用 Vitest 集成编写和运行 Cloudflare Workflows 的自动化测试。
- [触发 Workflows](https://cloudflaredoc.ubitools.com/workflows/build/trigger-workflows/index.md): 通过 Workers 绑定（binding）、REST API 或 Wrangler CLI 触发 Workflows。
- [可视化 Workflows](https://cloudflaredoc.ubitools.com/workflows/build/visualizer/index.md): 在 Cloudflare 仪表板中查看 Workflow 步骤、条件分支和并行逻辑的可视化图表。
- [Workers API 参考](https://cloudflaredoc.ubitools.com/workflows/build/workers-api/index.md): Workflows Workers API 参考，包括 WorkflowEntrypoint、步骤方法和实例管理。

## get-started

- [构建持久 AI Agent](https://cloudflaredoc.ubitools.com/workflows/get-started/durable-agents/index.md): 使用 Cloudflare Workflows 构建研究 GitHub 仓库的持久 AI agent，支持自动重试。
- [构建你的第一个 Workflow](https://cloudflaredoc.ubitools.com/workflows/get-started/guide/index.md): 在 Workers 平台上创建并部署你的第一个 Cloudflare Workflow，实现持久多步骤执行。

## observability

- [指标与分析](https://cloudflaredoc.ubitools.com/workflows/observability/metrics-analytics/index.md): 通过仪表板或 GraphQL Analytics API 查询 Workflows 执行指标、错误率和步骤时长。

## reference

- [发布说明](https://cloudflaredoc.ubitools.com/workflows/reference/changelog/index.md): Cloudflare Workflows 的最新发布说明和变更。
- [事件订阅](https://cloudflaredoc.ubitools.com/workflows/reference/event-subscriptions/index.md): 订阅 Workflows 生命周期事件，包括实例完成和失败通知。
- [术语表](https://cloudflaredoc.ubitools.com/workflows/reference/glossary/index.md): Cloudflare Workflows 文档中使用的关键术语定义。
- [限制](https://cloudflaredoc.ubitools.com/workflows/reference/limits/index.md): Cloudflare Workflows 的限制，包括最大步骤数、payload 大小和实例并发。
- [定价](https://cloudflaredoc.ubitools.com/workflows/reference/pricing/index.md): Cloudflare Workflows 基于 CPU 时间、请求、存储和步骤的定价，包含在 Workers Free 和 Paid 计划中。
- [Wrangler 命令](https://cloudflaredoc.ubitools.com/workflows/reference/wrangler-commands/index.md): 用于管理、部署和与 Cloudflare Workflows 交互的 Wrangler CLI 命令。