Skip to content

工具策略 ​

工具策略用来限定 Agent 可以调用哪些工具。目前支持一种规则:精确工具名称白名单。

在控制台左侧进入 策略。只有 Owner 和 Admin 可以创建和修改策略。

网关会做什么 ​

客户端声明的工具:lookup_order, issue_refund, send_email
策略白名单:      lookup_order
                       │
                       ▼
发给模型的工具:  lookup_order          (issue_refund、send_email 已移除)
  1. 过滤声明:请求里未被允许的工具声明,在发给模型前移除。
  2. 拒绝强制调用:请求强制指定(tool_choice)一个禁用工具时,直接拒绝。
  3. 拦截返回:模型返回了禁用工具的调用时,网关拦截。
  4. 无法校验不放行:网关无法判断时按拦截处理。

每次处理结果都记录在对应的 Trace 里,可以对比原始请求和生效请求。

新建策略 ​

点 新建策略:

设置选项
名称最多 120 个字符
范围整个组织:对本组织所有 Key 生效(包括以后新建的)
指定 API Key:只对选中的 Key 生效
工具规则仅允许列出的工具:填写精确名称,多个用逗号或换行分隔
阻止所有工具调用:请求不能调用任何工具

保存后可随时启用、停用、编辑或删除。删除后,新请求不再受这条规则限制。

多条策略怎么叠加 ​

  • 所有适用的白名单取 交集。
  • Key 级规则只能在组织规则基础上 收紧,不能放宽。

例:组织允许 a, b, c,某个 Key 的策略允许 b, c, d,这个 Key 最终只能调用 b, c。

注意 ​

  • 只匹配精确名称,不支持通配符(*、?)。
  • 策略控制的是经过网关的工具声明和模型返回的调用指令,不控制客户端实际执行什么。
  • 被过滤或拦截的请求按原规则计费,不额外收费,也不退款。
  • 目前不支持参数级限制和内容检测。

内容以控制台实际显示为准