返回目录 / Agent 工具
用语义检索从大型工具库中挑选少数候选
将工具描述本地编码为向量,通过一个窄 search 工具按当前任务检索相关能力。
目标
避免将数百个工具定义一次性塞入模型上下文。
步骤
- 为工具目录整理 name、description、参数 JSON 和权限标签;以文字化描述建索引。 [tool-search]
- 按 notebook 用
SentenceTransformer("all-MiniLM-L6-v2")生成本地 embedding,search query 对 top-k 候选做语义匹配。 [tool-search] - 只把命中候选交给受权限层控制的执行器;在小型标注集测 Precision@k 和漏召工具。 [tool-search]
验证方式
目录较大时上下文仍只含 search 和少数候选;拒绝低置信结果,避免错误工具被执行。
故障处理
若语义检索漏掉精确工具,加入名称/关键词索引或增加 top-k,再评估候选精度。
权限边界
前置条件
- Python、sentence-transformers、numpy;线上 Claude 调用另需 Anthropic API key。
权限边界
- 工具库只含已审核定义;执行器必须重新执行权限和参数校验。
限制
Notebook embedding 模型本地运行;工具检索不会自动授予权限,也不能当作可信授权层。
固定上游来源
- 仓库
- anthropics/anthropic-cookbook
- 文件路径
- tool_use/tool_search_with_embeddings.ipynb
- 固定提交
9c1e493ddd2b82df399d2a61b9c806c539e18be6- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT