CreateDigitalEmployee - 创建数字员工

创建数字员工

Hook 配置

通过 toolPolicy.hooks 配置数字员工 Hook。每项对应一个事件和一个处理器，按数组顺序加载和执行；同名 Hook 独立执行。只有 enable 为 true 且范围、事件和工具名称匹配时才执行。空数组表示不加载数字员工 Hook。

• schemaVersion：配置协议版本，取值为 v1。

• name：非空名称，仅允许英文字母、数字、下划线和连字符。

• scope：all（Chat 和 Mission）、chat 或 mission。

• event：TurnStart、TurnEnd、ToolStart 或 ToolEnd。

• match：工具名称数组，仅用于 ToolStart 和 ToolEnd；按实际名称精确匹配，不支持通配符。空数组不限制工具，其他事件忽略该字段。

• execution.type：prompt、bash、python3 或 hint。instruction 分别填写提示词、Bash 脚本、Python 3 脚本或追加到上下文的文本，必须为非空 UTF-8 文本。

• execution.timeoutSeconds：1–30 秒，全部尝试与等待共用该超时。

• execution.maxRetry：失败后的额外尝试次数，范围为 0–3。

• execution.failResult：重试后处理器返回值仍不合法时，按 allow 或 reject 处理。

全局自动放行策略

通过 toolPolicy.global.autoPassPolicy 配置命令自动放行规则。每项规则必须提供 version: "v1.0.0"，并在以下两种匹配方式中选择一种：

• fullCommand：精确匹配的非空完整命令。

• commandPrefix：命令前缀数组，必须且只能包含一个非空前缀。

fullCommand 与 commandPrefix 不能同时配置，也不能同时省略。此处规则采用命令格式；toolPolicy.aliyun.autoPassPolicy 则使用 RAM Action 字符串，两者格式不同。

以下为 toolPolicy 中这两部分的配置示例：

{
  "global": {
    "autoPassPolicy": [
      {
        "version": "v1.0.0",
        "fullCommand": "starops tool list"
      },
      {
        "version": "v1.0.0",
        "commandPrefix": [
          "starops sls"
        ]
      }
    ]
  },
  "hooks": [
    {
      "schemaVersion": "v1",
      "name": "tool-reminder",
      "enable": true,
      "scope": "all",
      "event": "ToolStart",
      "match": [
        "Bash"
      ],
      "execution": {
        "type": "hint",
        "instruction": "执行工具前确认目标资源和参数。",
        "timeoutSeconds": 10,
        "maxRetry": 0,
        "failResult": "reject"
      }
    }
  ]
}