Hooks 规则

更新时间:
复制 MD 格式

入口:管理后台安全管控 → Hooks 规则。

每个事件只能配置一个策略组。需要在同一事件下调用多个服务时,由开发人员把这些规则放入同一个配置数组。所有启用的策略组默认对全员生效。

添加事件与规则

  1. 点击新增策略组,填写策略组名称和策略说明,便于日后辨认用途。

  2. 在触发时机中选择事件。已经配置过的事件不能重复添加;要调整已有规则,请回到列表点击该策略组的编辑。

  3. 在JSON 配置中粘贴开发人员提供的规则数组。点击格式化可整理显示格式;配置不符合 JSON 数组格式时,页面会提示错误。

  4. 根据是否已准备好投入使用,设置保存后启用 Hooks 策略组开关,点击保存策略组。

  5. 回到列表,核对事件、配置摘要和启用状态。

管理后台:编辑策略组的触发时机和规则配置。

选择触发时机

请选择与你的业务操作对应的事件:

  • SessionStart:会话开始。

  • PreUserPromptSubmit:用户提交提示词前。

  • UserPromptSubmit:用户提交提示词。

  • PreToolUse:工具执行前。

  • PostToolUse:工具执行后。

  • Stop:Agent 停止响应。

  • PreCompact:上下文压缩前。

  • PostCompact:上下文压缩后。

  • ConnectorAdded:连接器添加时。

  • ExpertSuiteAdded:专家套件添加时。

  • SkillAdded:技能添加时。

  • Notification:通知。

修改、启停和删除

  • 修改规则:找到策略组,点击编辑,调整名称、说明或配置,保存后核对列表。

  • 临时停止:关闭列表中的启用状态开关;需要恢复时重新开启。

  • 删除规则:点击删除,核对策略组名称后确认。删除后,该配置不再下发。

  • 查找规则:可按名称或配置内容搜索,也可按事件和启用状态筛选。

管理后台:按事件维护策略组及其启用状态。

规则由谁编写

规则内容由企业开发人员准备。配置格式、HTTP 调用约定以及事件的请求和响应,请查看 安全管控 → Hooks 规则。

配置会以明文保存,填入 Header、令牌等敏感内容前请确认企业的使用要求。保存成功只表示配置已保存;确认业务服务能正常接收请求时,请在客户端触发对应操作,并检查企业服务的调用记录。