外观
工具策略
工具策略用来限定 Agent 可以调用哪些工具。目前支持一种规则:精确工具名称白名单。
在控制台左侧进入 策略。只有 Owner 和 Admin 可以创建和修改策略。
网关会做什么
客户端声明的工具:lookup_order, issue_refund, send_email
策略白名单: lookup_order
│
▼
发给模型的工具: lookup_order (issue_refund、send_email 已移除)- 过滤声明:请求里未被允许的工具声明,在发给模型前移除。
- 拒绝强制调用:请求强制指定(
tool_choice)一个禁用工具时,直接拒绝。 - 拦截返回:模型返回了禁用工具的调用时,网关拦截。
- 无法校验不放行:网关无法判断时按拦截处理。
每次处理结果都记录在对应的 Trace 里,可以对比原始请求和生效请求。
新建策略
点 新建策略:
| 设置 | 选项 |
|---|---|
| 名称 | 最多 120 个字符 |
| 范围 | 整个组织:对本组织所有 Key 生效(包括以后新建的) 指定 API Key:只对选中的 Key 生效 |
| 工具规则 | 仅允许列出的工具:填写精确名称,多个用逗号或换行分隔 阻止所有工具调用:请求不能调用任何工具 |
保存后可随时启用、停用、编辑或删除。删除后,新请求不再受这条规则限制。
多条策略怎么叠加
- 所有适用的白名单取 交集。
- Key 级规则只能在组织规则基础上 收紧,不能放宽。
例:组织允许 a, b, c,某个 Key 的策略允许 b, c, d,这个 Key 最终只能调用 b, c。
注意
- 只匹配精确名称,不支持通配符(
*、?)。 - 策略控制的是经过网关的工具声明和模型返回的调用指令,不控制客户端实际执行什么。
- 被过滤或拦截的请求按原规则计费,不额外收费,也不退款。
- 目前不支持参数级限制和内容检测。