MCP 实战练习
练习目标:把一个“文档搜索”能力设计成 MCP tool,并用 Harness 验证它不会在常见失败场景下误导 Agent。
任务
创建一个 search_docs 能力说明,至少包含:
- Tool 描述。
- 输入 schema。
- 输出 schema。
- 3 个成功示例。
- 4 个失败或边界示例。
- 安全边界说明。
验收标准
- 空查询不会触发搜索。
- 结果数量有上限。
- 无结果时给出下一步建议。
- 返回内容包含来源 URL。
- 错误信息不泄露本地路径、环境变量或密钥。
自检问题
- 这个 tool 是否有副作用?
- Agent 是否能根据错误继续行动?
- 返回内容是否足够小,可以放入上下文窗口?
- 如果数据源不可用,Harness 会如何失败?