实践练习

练习1：带升级逻辑的多工具智能体

目标： 设计一个带有工具集成、结构化错误处理和升级的智能体循环。

步骤：

1. 定义3-4个带详细描述的MCP工具（包含两个类似工具以测试工具选择）
2. 实现一个检查 stop_reason（"tool_use" / "end_turn"）的智能体循环
3. 添加结构化错误响应：errorCategory、isRetryable、描述
4. 实现一个拦截器钩子，阻止超过阈值的操作并路由到升级
5. 使用多方面请求进行测试

考点： 1（智能体架构），2（工具和MCP），5（上下文和可靠性）

---

练习2：为团队开发配置Claude Code

目标： 配置CLAUDE.md、自定义命令、路径特定规则和MCP服务器。

步骤：

1. 创建带有通用标准的项目级CLAUDE.md
2. 为不同代码区域创建带YAML前置内容的 .claude/rules/ 文件（paths: ["src/api/**/*"]、paths: ["**/*.test.*"]）
3. 在 .claude/skills/ 下创建带有 context: fork 和 allowed-tools 的项目技能
4. 在 .mcp.json 中配置带有环境变量的MCP服务器 + 在 ~/.claude.json 中配置个人覆盖
5. 在不同复杂度的任务上测试规划模式vs直接执行

考点： 3（Claude Code配置），2（工具和MCP）

---

练习3：结构化数据提取管道

目标： JSON Schemas、tool_use 用于结构化输出、验证/重试循环、批处理。

步骤：

1. 定义带JSON Schema的提取工具（必填/可选字段、带"其他"的枚举、可空字段）
2. 构建验证循环：出错时，用文档、错误提取和具体验证错误重试
3. 为不同结构文档添加少样本示例
4. 通过Message Batches API使用批处理：100个文档，通过 custom_id 处理失败
5. 路由到人工：字段级置信度分数、文档类型分析

考点： 4（提示词工程），5（上下文和可靠性）

---

练习4：设计和调试多智能体研究管道

目标： 子智能体编排、上下文传递、错误传播、带来源跟踪的综合。

步骤：

1. 一个协调者带2+子智能体（allowedTools 包含 "Task"，上下文在提示词中明确传递）
2. 通过在单个响应中进行多次 Task 调用并行运行子智能体
3. 要求结构化子智能体输出：声明、引用、来源URL、发布日期
4. 模拟子智能体超时：向协调者返回结构化错误上下文，并继续使用部分结果
5. 使用冲突数据测试：保留两个值及归因；分离已确认vs有争议的发现

考点： 1（智能体架构），2（工具和MCP），5（上下文和可靠性）

---