工具契约
一个动作的完整约定:接受什么输入、返回什么结果、可能怎样失败、谁有权调用。模型提出调用只是一次请求,执行器仍负责参数校验与授权判断;语法合法不等于业务合法。
生产方式:AI 生成AI 生成,仅供参考签发:晓黎学习复核:2026年11月8日被 2 个词条引用
定义:工具契约规定一个动作接受什么输入、返回什么结果、可能怎样失败,以及谁有权调用。模型提出调用只是一次请求,执行器仍然负责参数校验和授权判断;不能因为参数看起来像 JSON,就认为它已经安全或符合业务要求。校验与授权是两个步骤,语法合法不等于业务合法。见 JSON 数据结构基础、沙箱(Sandbox)。
错误也要有形状:不存在、无权访问、暂时不可用、输入无效应分开,而不是全部返回一个模糊字符串;只返回部分正文就必须有明确的截断标记。工具返回的资料不会自动升级为操作授权,工具结果也属于待解释的数据。见 提示注入(Prompt Injection)。
结课课把「输入合同、工具契约、状态结构、输出模板」并列为四类交付物。见 组件分工、工具调用(Tool Call)。
互链
链接来自概念卡正文里的双链,编译时能解到本期词条集的才成为站内链接。
- 工具调用(Tool Call)正文引用
- 沙箱(Sandbox)正文引用
- 提示注入(Prompt Injection)正文引用
- 组件分工正文引用
- JSON 数据结构基础正文引用
反链(2)
出现在哪些课时里(2)
判据与「课时正文里能不能点出来」是同一个:那一节确实提到了它。点课时走当前页跳转, 它是导航,不是词条链接。
- Tool:给模型一个有边界的动作Agent 系统:Harness、MCP、Skill 与 Memory
- 结课设计:一个可治理的最小 Agent 系统Agent 系统:Harness、MCP、Skill 与 Memory
关联图
只画这一条与它直接相连的词条,边与上面两区同源。可拖拽、可缩放,点节点是新标签。
以列表方式看这 7 个节点
出处
路径是本地知识库(Obsidian 库)里的位置,正文与概念卡逐字对应。
- 课程正文用法归纳Tool:给模型一个有边界的动作
packages/db/prisma/lesson-content/tool-contracts.md - 课程正文用法归纳结课设计:一个可治理的最小 Agent 系统
packages/db/prisma/lesson-content/agent-system-capstone.md - 课程正文用法归纳课程派生词条 · Agent 与工具生态
编译入库:2026年11月2日。词条由知识库编译而来, 修正要回到概念卡改,再重新编译。