Skip to content

MCP 实战练习

练习目标:把一个“文档搜索”能力设计成 MCP tool,并用 Harness 验证它不会在常见失败场景下误导 Agent。

任务

创建一个 search_docs 能力说明,至少包含:

  • Tool 描述。
  • 输入 schema。
  • 输出 schema。
  • 3 个成功示例。
  • 4 个失败或边界示例。
  • 安全边界说明。

验收标准

  • 空查询不会触发搜索。
  • 结果数量有上限。
  • 无结果时给出下一步建议。
  • 返回内容包含来源 URL。
  • 错误信息不泄露本地路径、环境变量或密钥。

自检问题

  1. 这个 tool 是否有副作用?
  2. Agent 是否能根据错误继续行动?
  3. 返回内容是否足够小,可以放入上下文窗口?
  4. 如果数据源不可用,Harness 会如何失败?

延伸

把这个 tool 接入 工作流编排,再用 评测与质量 定义回归用例。

基于 MIT 许可发布