Skip to main content

Hooks 规则

Hooks 用来在客户端或 Agent 的指定事件发生时调用企业的 HTTP 服务。管理员在这里选择事件、添加规则并控制是否启用。例如，可以在会话开始时通知企业业务系统。

Hooks 用来在客户端或 Agent 的指定事件发生时调用企业的 HTTP 服务。管理员在这里选择事件、添加规则并控制是否启用。例如，可以在会话开始时通知企业业务系统。 入口：管理后台【安全管控 → 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、令牌等敏感内容前请确认企业的使用要求。保存成功只表示配置已保存；确认业务服务能正常接收请求时，请在客户端触发对应操作，并检查企业服务的调用记录。