Agent 不是“让模型自由发挥”，而是一个由模型负责决策、由程序负责执行和约束的循环系统。可靠的 Agent 必须有明确目标、可控工具和可追踪状态。
一、基本执行循环
text
用户目标 → 任务拆解 → 模型决策 → 调用工具 → 观察结果 → 继续或结束一次循环通常包含：
context：目标、历史消息、约束和当前状态。tool：模型可以调用的函数，输入输出必须有明确结构。observation：工具执行结果，包括成功、失败和权限信息。stop condition：完成、超时、达到步数上限或需要人工确认。
二、常见架构
| 架构 | 适用场景 | 主要风险 |
|---|---|---|
| 单 Agent + 工具 | 查询、总结、简单自动化 | 循环失控、工具误用 |
| Planner-Executor | 多步骤任务 | 计划与现实状态脱节 |
| 多 Agent 协作 | 角色分工、并行研究 | 通信成本和责任边界模糊 |
| 工作流 + Agent 节点 | 流程稳定、局部需要推理 | 灵活性与维护成本的平衡 |
优先从“工作流 + 少量 Agent 节点”开始。能用确定性代码表达的步骤，不必交给模型。
三、工具设计原则
- 工具只做一件事，参数使用结构化模式校验。
- 工具执行前检查权限、范围和用户确认要求。
- 工具执行后返回可供模型理解的结果，同时记录原始日志。
- 失败结果要说明原因和下一步，而不是只返回空字符串。
- 设置超时、重试、预算和最大循环次数。
四、状态与评测
把短期消息、任务状态、长期记忆和外部业务数据分开管理。不要把所有内容无限追加到上下文中；应通过摘要、检索和状态快照控制成本。
评测至少覆盖任务成功率、工具调用准确率、事实正确性、延迟、成本和安全拒答。保留一组固定样例做回归测试，任何提示词或工具变更都重新运行。
Agent 的工程核心是边界：让模型负责选择，让代码负责约束，让日志负责解释。
专题阅读
按“先理解控制流，再补齐生产化能力”的顺序阅读。现有 20 篇保留原路径，新文章从 21 章开始。
01 基础与工具
02 安全与运行时
- 03、Permission — 执行前做权限判断
- 04、Hooks — 挂在循环上，不写进循环里
- 10、System Prompt — 运行时组装，不硬编码
- 23、Agent Security — 从提示注入到沙箱隔离
03 状态、任务与可靠性
- 05、TodoWrite — 没有计划的 Agent，做着做着就偏了
- 08、Context Compact — 上下文总会满，要有办法腾地方
- 09、Memory — 压缩会丢细节，要有一层不丢的
- 11、Error Recovery — 错误不是结束，是重试的开始
- 12、Task System — 目标太大，拆成小任务
- 24、Durable Execution — 让长任务可暂停、可恢复
- 25、Cost and Reliability — 让 Agent 跑得稳、算得清
04 多 Agent 与外部协作
- 06、Subagent — 大任务拆小，每个拿到的都是干净上下文
- 15、Agent Teams — 一个搞不定，组队来
- 16、Team Protocols — 队友之间要有约定
- 17、Autonomous Agents — 自己看板，自己认领
- 18、Worktree Isolation — 各干各的，互不干扰
- 19、MCP Tools — 外接工具，标准协议
05 评测与产品交互
06 调度与综合
- 07、Skill Loading — 用到的时候才加载
- 13、Background Tasks — 慢操作放后台
- 14、Cron Scheduler — 按时间表生产工作
- 20、Comprehensive Agent — 全部机制归到一个循环
评论
正在加载评论…