配置工具授权
设置工具调用是否需要用户确认，并核实策略在新会话中生效。
为已启用的工具选择直接执行或每次询问，让用户在操作发生前确认意图。本页以订单 MCP 的查询和退货工具为例；业务权限仍须由工具服务端校验。
准备工具
准备一个已能接入的服务智能体，并在「配置 → MCP 与凭据」连接名为 orders 的 MCP 服务器。示例要求它提供已启用的 list_orders 和 request_return。替换为你实际的服务器和工具名称，不要用示例名称配置不存在的工具。
确认卡不能代替身份认证。公网 MCP 服务必须先认证平台调用方，再按终端用户限定数据范围，见保护嵌入接入。
选择执行策略
| 策略 | 对普通已启用工具的效果 |
|---|---|
always_allow | 不询问，直接执行 |
always_ask | 暂停并等待用户确认，允许后执行；拒绝则不执行该调用 |
目前支持这两档。不要使用 auto：即使某处类型接受它，运行时也会拒绝执行。需要禁止使用一个工具时，关闭该工具；「每次询问」仍允许用户同意调用。
策略不绕过工具自身的强制交互、安全边界或业务检查。前端 custom 工具由你的页面执行，不经过这套确认策略。
设置工具与默认值
在当前控制台依次打开「服务智能体 → 你的智能体 → 接入与配置 → 配置 → 工具与授权」。
- 在「授权方式」找到
orders · 默认授权，选择「每次询问」。 - 将
list_orders设为「自动执行」，request_return设为「每次询问」。逐工具选择项只显示已配置的工具；未显示的工具可使用默认策略，或通过 API 添加逐工具配置。 - 保存配置。预期： 当前配置版本增加；原有会话继续使用原版本。
解析顺序为单工具 configs[].permission_policy → 工具集 default_config.permission_policy → 工具默认策略。未设置 MCP 策略时，服务器声明 annotations.readOnlyHint === true 才默认放行，否则默认询问。该提示仅影响缺省，显式配置优先。
内置工具集未设置默认策略时为 always_allow，但工具自身要求的交互仍然存在。对退款、删除和对外发送等动作，明确设置询问，不要仅依赖服务器提示。
验证确认过程
签发使用新版本的嵌入令牌并新建会话；若嵌入策略固定版本，先更新固定版本或在签发时指定新版本。保存智能体不会自动升级已有会话。
先让智能体调用查询工具，再请求一次测试退货。预期： 查询直接返回；退货显示 Kit 确认卡。拒绝后工具服务端不应执行退货；再次提出请求并允许后才执行。以工具服务端记录核实调用是否发生，不要只看智能体的回答。
Kit 自带确认卡，无须另写界面。嵌入用户的允许只针对这次调用，不会保存为永久工具权限。完整测试情境见测试嵌入接入。