Production Agent
现代 Agent Engineering 学习路线：Production Agent
0 子目录4 文档
文档
4生产交付推荐阅读生产交付推荐阅读 OpenAI：A practical guide to building agents：从单 Agent、工具到 guardrail 和多 Agent 的落地框架。 OpenAI Agents SDK：tool、handoff、session、guardrail、tracing。 LangGraph：durable execution、state、checkpoint 与 human in the loop。 SWE 生产级 Agent：用户、任务与成功标准生产级 Agent：用户、任务与成功标准 1. 从问题定义开始 先写清： 谁使用； 在什么场景； 输入是什么； 期望产物； 可接受时间与成本； 哪些动作有副作用； 人工在哪些节点参与； 成功如何验证。 “做一个通用 Agent”缺少任务分布，无法选择工具、Memory 和 Eval。 2. Success Contract 成功标准分为机器检查、模型 rubric 和人工验收。尽量把关键事实放到机器检查。 3. 产品边界 支持的任务类型重试、超时、成本预算、部署与运维重试、超时、成本预算、部署与运维 1. 预算 每次 run 设置： 最大模型 turn； 最大工具调用； token/金额； wall clock deadline； 单工具超时； 子 Agent 数和并发； 最大重试； 最大产物大小。 预算到达时保存 partial result 和 checkpoint，给出明确终止原因。 2. 重试 按 provider、tool、业务动作分别配置。指数退避加入 jitter，尊重限流响应。非幂等README、运行手册与交付检查表README、运行手册与交付检查表 1. README 至少包含： 1. 产品解决什么问题； 2. 支持与非目标场景； 3. 架构图； 4. 环境与依赖； 5. 配置变量； 6. 本地运行； 7. 工具和权限； 8. 测试与 Eval； 9. 部署； 10. 数据和日志； 11. 扩展 Skill/Tool； 12. 已知限制。 提供一条从 clone 到完成最小任务的 happy path。 2. Runbook 运维手册按症状组织：