AI Agent Engineer

AI Agent Engineer
个人学习进度

标记这门课程

课程正文公开可读；登录后可保存个人进度。

工作流自动化学习目录

10 min read

工作流自动化

资料边界

本库协议与运行边界核验于 2026-07-22。Open Workflow Specification 官网当前标注 1.0.3；CloudEvents 仓库列出的稳定发布仍为 1.0.2，主线另有 WIP；OpenTelemetry Semantic Conventions 页面为 1.43.0，其中消息语义约定仍标注 Development。课程不会把某个产品的默认值写成通用保证，实际采用产品前应再次核对其版本文档。

知识库简介

工作流自动化把“何时开始、按什么顺序做什么、失败后如何继续”变成可检查的执行合同。它适合订单履约、文档处理、数据管道、审批和 Agent 外壳等路径可预先约束的过程。

工作流不是把一串函数按顺序调用那么简单。可靠工作流还要面对重复事件、进程崩溃、并发领取、下游超时、未知执行结果、版本升级和人工等待。学习重点因此是：显式状态、有限重试、持久恢复、幂等副作用、可补偿动作、可审计审批和可观测运行。

与 Agent 的边界

确定性工作流负责允许的节点、状态迁移、预算、审批和提交；Agent 或 LLM 只在某个有输入/输出合同的节点内提出候选结果。模型输出必须先经过 schema、业务规则和权限检查，不能直接决定任意下一步或执行未授权副作用。

事件身份不是权限

source + event_id、trace_id 和模型给出的 tenant 字段可帮助关联、去重或诊断，但都不是可信身份。入口先验证发送者/签名与回放窗口，执行前再由服务端按当前 actor、策略和资源 ACL 授权；任一环节不满足即 fail closed。

flowchart LR
    A["可信投递入口"] --> B["结构化事件身份与去重"]
    B --> C["版本化实例 + checkpoint"]
    C --> D["受限 action / operation intent"]
    D --> E["服务端授权或人工审批"]
    E --> F["副作用 receipt"]
    F --> G["查询/对账最终 outcome"]
    G --> H["审计、指标与恢复"]

在总路线中的位置

本库位于“单 Agent 与工具”阶段的工程收束点：

学习目标

完成后应能：

  • 判断简单脚本、确定性工作流与开放式 Agent 各自适合的边界。
  • 将需求表示为触发器、步骤、条件、并行、汇合和终止状态。
  • 为事件和步骤设计版本化数据合同，并区分结构验证与业务验证。
  • 设计调度时区、超时层级、有限重试、抖动、重试预算和背压。
  • 从检查点恢复长流程，并用幂等记录处理重复与“结果未知”。
  • 区分事件身份、业务 operation_id、执行 attempt_id、回执与最终 outcome，不把诊断 ID 当作授权或成功证明。
  • 区分技术重试、业务补偿、人工审批和人工修复。
  • 用事件、日志、指标和 trace 定位单次故障与系统性退化。
  • 编写运行手册，安全发布工作流新版本并处置积压与补偿失败。

前置知识

  • 能读 Python 函数、异常、JSON 文件和基本测试。
  • 理解 API 认证与凭据安全、HTTP 请求/响应和状态码的基本概念。
  • 能阅读 JSON Schema 基础契约，并知道结构校验不等于业务授权。
  • 知道 Tool Calling 是“请求执行工具”的结构化协议，不等于可靠执行。
  • 不要求先懂消息队列、数据库事务或分布式系统；课程会先解释术语。

推荐学习顺序

  1. 触发器、步骤与 DAG：先把业务过程建模，并确定工作流与 Agent 的责任边界。
  2. 数据契约与版本演进：让事件和步骤通过可验证、可升级的合同通信。
  3. 条件、并行与汇合：明确分支、并行安全和部分失败语义。
  4. 调度、超时、重试与背压：控制何时运行、等多久、重试多少以及过载怎么办。
  5. 持久状态、恢复与幂等：在进程中断和重复投递后继续，而不重复逻辑副作用。
  6. 补偿、审批与人工处理：处理跨系统副作用、知情批准和无法自动恢复的实例。
  7. 可观测性、测试与发布：用轨迹、故障注入、发布门槛和运行手册验收生产能力。
  8. 离线 DAG 工作流项目：实现并验证一个可暂停、恢复、重试、补偿和去重的离线订单流程。

动手实践与项目入口

项目入口是 离线 DAG 工作流项目：

项目不连接云服务、不读取密钥、不创建仓库内持久产物。演示运行使用临时目录；生产系统仍需事务型状态库、持久幂等表、消息系统、密钥管理和真正的权限控制。

掌握标准

  • 能把一个真实流程画成 DAG，并标出触发器、分支、汇合、等待和终止状态。
  • 能说明为何“至少一次处理”要求业务幂等，而不能靠进程内字典声称 exactly-once。
  • 能为暂时错误、永久错误、未知结果和业务拒绝分别设计处理路径。
  • 能解释重试为何不能替代补偿，补偿为何也不保证回到原始物理状态。
  • 能验证审批绑定了实例、步骤、载荷指纹、定义版本、状态版本和有效期。
  • 能从检查点恢复已暂停流程，且已提交副作用不会重复产生。
  • 能写出覆盖重复触发、崩溃窗口、补偿失败、审批过期和版本不兼容的测试。
  • 能用运行手册安全执行部署、暂停、排空、回滚定义和人工处置。

与其他知识库的关系

事实、实现与建议如何区分

  • 规范事实：来自 CloudEvents、JSON Schema、RFC 等规范；笔记会写明版本。
  • 产品事实：例如 Temporal 通过事件历史与重放恢复工作流，这是该产品的实现合同，不代表所有编排器都相同。
  • 工程建议：例如日志字段 allowlist、两阶段发布、重试预算，是本库给出的设计策略；应结合业务风险验证。

主要参考资料

Backlinks