Action Type 是对业务操作逻辑的标准化语义封装，用于驱动跨系统的业务操作执行，和实现本体数据的合规变更。

前提条件

• 当前账号已拥有Action Type权限。
• 项目所在资源组需配置Doris计算集群。
• 已完成 REST API 数据源创建，并基于该数据源配置完成Webhook。

创建Action Type

1. 登录百度胜算控制台，在选中的工作空间操作列单击打开按钮，进入空间内。
2. 侧边导航选择本体构建>本体管理，再切换至 Action Type Tab页，单击创建按钮。
3. 在创建Action Type页面，首先在顶部对Action Type的基本信息进行配置，具体配置详情参考下表：

基本信息配置说明

配置项	说明
图标	提供了图标基础库，并支持自定义颜色。
英文名称	输入英文名称。支持英文、数字、下划线，长度为1～64个字符，仅能以英文开头，名称全局唯一，不可重名。
中文名称	输入中文名称。文件名称长度必须在1～254字符之间，不能出现/或者\，不能仅为"."，名称全局唯一，不可重名。
所属位置	输入项目路径，也可以单击右侧浏览按钮，选择所属项目。
工具描述	输入工具描述。长度为1～500个字符。用于帮助大模型理解工具能力与适用业务场景。
描述	输入描述。长度为1～500个字符。

4. 接着在下方规则模块，单击添加规则，默认规则为Webhook类型，Webhook类型包括：

   • 数据回写：用于将数据回写源系统；在规则流中的任意位置添加该节点，均会自动置顶至规则流首位执行。一个操作里只可创建一个数据回写类的Webhook。且Action中有数据回写Webhook，则该操作不支持撤销。
   • 副影响：副影响操作必须在规则流的最后执行。在单个操作中配置多个副作用 Webhook，它们将以任意顺序执行。

Webhook与Action引用关系的说明：

• Action引用Webhook时锁定到某一具体版本。
• Webhook编辑生成新版本后，已有Action不会自动切换版本。

5. 数据回写、副影响两类 Webhook 配置流程完全一致，分为 3 个步骤：

   1. 选择数据源：展示当前账号授权的全部RestAPI数据源，选中目标数据源后单击下一步。
   2. 选择Webhook：展示该数据源下的所有Webhook接口，支持查看Input/Output Parameters，选中后单击下一步。
   3. 配置映射：为Webhook入参配置Action Type参数，支持参数（动态绑定）和静态值（固定常量）两种映射类型。struct格式的参数不支持映射为静态值。完成后单击确定。
6. 配置完成后，单条规则卡片右上角提供配置规则和删除操作按钮。

7. 接着在下方参数模块，参数存在两种生成方式：

   • 自动生成：添加Webhook规则后自动生成对应参数，无需手动新增。
   • 手动添加参数：单击添加参数自定义参数。

参数配置项说明

配置项	说明
参数名称	必须以字母开头，仅支持字母、数字、下划线，长度为1～64个字符。
参数类型	下拉选择基础数据类型，包含string（默认值）、boolean、integer、long、double、date、timestamp、struct。 说明：参数格式不支持array，array格式参数需要通过String、Boolean、Integer、Long、Double、Date、Timestamp、Struct格式的参数+打开“多值”开关 满足。
字段定义	当参数类型选择struct时，需要配置字段定义。
别名	在用户界面预览上的名称。
描述	参数业务含义。长度为1～500个字符。
必填	开启后调用Action时该参数必须传入值。
允许多值	开启后支持传入数组批量数据。
值输入方式	支持以下两种方式： 用户输入（默认值）：数据格式与参数格式保持一致。 用户选择：选项的数据格式与参数格式保持一致。
用户输入配置	当值输入方式选择用户输入时，需配置以下内容： 数据校验规则：针对不同的数据类型，需要配置最小长度、最大长度或正则匹配，用于约束用户输入内容格式，不符合规则时将拦截提交。 默认值：全类型通用，可填写对应数据类型的常量值，用户未主动传入参数时，系统自动填充该默认值。
用户选择配置	当值输入方式选择用户选择时，需配置以下内容： 选项来源（二选一） 手动定义选项：自主录入固定下拉选项，适用于枚举值固定不变的场景； 从对象集获取：联动业务本体动态拉取选项，适用于选项会随业务数据更新的场景。 设置选项：选择手动定义选项时，在输入框填写对应类型值，单击添加选项，支持添加多个选项。 对象集：选择从对象集获取时，下拉选择起始业务对象集，作为下拉选项的数据来源。 添加属性筛选：单击添加属性筛选可配置过滤条件，仅拉取符合筛选规则的实体数据作为下拉选项。 Search Around：选择对象集后，单击Search Around，可基于当前对象集，按指定关系查找关联对象，选择关联对象，生成新的对象集。 选择属性：选择从对象集获取并选定对象集后，下拉选取目标属性，该属性的值将作为前端下拉展示的可选项。 允许 "其他" 值：开启后用户除选择预设下拉项外，还可手动输入列表以外的自定义值；关闭则仅能选择预设选项。

8. 配置完成后，单条参数卡片右上角提供删除按钮，正在被规则映射的参数无法删除。
9. 最下方执行配置区域，查看元信息权限，默认继承当前项目的权限体系。
10. 页面右侧同步展示用户界面预览，实时渲染所有参数最终填写表单。
11. 确认全部配置无遗漏后，单击页面左下角确定按钮，保存并生成全新 Action Type。

查看Action Type列表

登录百度胜算控制台，进入本体构建>本体管理，切换至 Action Type Tab页即可查看列表。

Action Type列表字段说明

列表项	说明
英文名称	图标加英文名称。
中文名称	中文名称。
所属位置	当前Action Type所属位置。
规则	规则类型Webhook。
成熟度状态	当前Action Type的状态。状态类型包含实验中、已启用和已废弃。支持按状态筛选对象类型，并可对状态进行编辑修改。
发布状态	当前Action Type的发布状态。发布状态类型包含未发布、已发布、已发布有更新和失败。支持按发布状态筛选对象类型。
操作	单击操作列不同按钮，对当前Object Type进行不同操作。 详情：单击详情按钮，进入详情界面，详细操作可参见查看Action Type详情。 发布：单击发布按钮，将当前Action Type发布至运行环境。 编辑：单击编辑按钮，可对当前Action Type进行编辑操作。 删除：单击删除按钮，仅允许删除实验中和已废弃的Action Type，删除后进入回收站并同步删除底层索引，恢复时仅恢复元数据且索引状态为未索引，若存在重名则不允许恢复。进入回收站后，30天后自动彻底删除。
批量操作	选择多个Object Type后，可批量修改成熟度状态、发布和删除。 批量修改成熟度状态：单击批量修改状态按钮，可对选中的Action Types进行状态修改。 批量发布：单击批量发布按钮，可对选中的Action Types进行发布。 批量删除：单击批量删除按钮，仅允许删除实验中和已废弃的Action Types，删除进入回收站后，30天后自动彻底删除。

查看Action Type列表

1. 登录百度胜算控制台，在选中的工作空间操作列单击打开按钮，进入空间内。
2. 侧边导航选择本体构建>本体管理，再切换至 Action Type Tab页，即可查看Action Type列表的详细信息，也可根据中英文名称进行搜索查看，具体字段说明可参考下表。

Action Type列表字段说明

列表项	说明
英文名称	展示创建时配置的图标加英文名称。
中文名称	展示创建时配置的中文名称。
所属位置	展示当前Action Type所属位置。单击所属位置可跳转至目标位置。
规则	展示规则类型Webhook。
成熟度状态	当前Action Type的状态。状态类型包含实验中、已启用和已废弃。支持按状态筛选对象类型，并可对状态进行编辑修改。
发布状态	当前Action Type的发布状态。发布状态类型包含未发布、已发布、已发布有更新和失败。支持按发布状态筛选对象类型。
操作	单击操作列不同按钮，对当前Object Type进行不同操作。 详情：单击详情按钮，进入详情界面，详细操作可参见查看Action Type详情。 发布：单击发布按钮，将当前Action Type发布至运行环境。 编辑：单击编辑按钮，可对当前Action Type进行编辑操作。 删除：单击删除按钮，仅允许删除实验中和已废弃的Action Type，删除后进入回收站并同步删除底层索引，恢复时仅恢复元数据且索引状态为未索引，若存在重名则不允许恢复。进入回收站后，30天后自动彻底删除。
批量操作	选择多个Object Type后，可批量修改成熟度状态、发布和删除。 批量修改成熟度状态：单击批量修改状态按钮，可对选中的Action Types进行状态修改。 批量发布：单击批量发布按钮，可对选中的Action Types进行发布。 * 批量删除：单击批量删除按钮，仅允许删除实验中和已废弃的Action Types，删除进入回收站后，30天后自动彻底删除。

查看Action Type详情

1. 登录百度胜算控制台，在选中的工作空间操作列单击打开按钮，进入空间内。
2. 本体构建>本体管理，再切换至 Action Type Tab页，单击目标对象类型的英文名称或单击操作列详情按钮，进入Object Type详情页。
3. 详情页包含概览、规则、参数和执行设置四个页签，各页签说明如下：

概览

在概览页可查看当前Action Type的基本信息以及Action Type视图。

基本信息

展示当前 Action Type 全部基础配置内容，以下是基本信息参数的说明：

基本信息的参数说明

参数	说明
英文名称	展示当前Action Type的英文名称。支持修改英文名称。
中文名称	展示当前Action Type的中文名称。支持修改中文名称。
所属位置	展示当前Action Type所属的位置，单击可跳转至所属位置。
本体名称	当前工作空间的名称，当前工作空间中唯一。
工具描述	Action Type 作为工具被调用时展示给模型的描述。支持修改工具描述。
描述	展示当前Action Type的描述。支持修改描述，长度为1～500个字符。
成熟度状态	当前Action Type的状态。状态类型包含实验中、已启用和已废弃。支持可对状态进行编辑修改。
API名称	系统自动生成API名称。
RID	保存后，由系统自动生成的RID。

Action Type视图

• 参数模块：展示该 Action Type 下全部已配置参数，包含参数类型、参数名称；
• 规则模块：展示所有 Webhook 规则卡片，标注 Webhook 名称、接口版本；
• 图表工具栏：提供全屏查看、缩放、重置视图功能，参数 / 规则数量较多时可便捷浏览完整关联链路。

规则

切换至规则页签，可查看当前 Webhook 规则的名称、接口版本、绑定数据源，同时完整展示接口入参与 Action Type 参数之间的映射绑定关系。

参数

切换至参数页签，页面分为参数列表和用户界面预览两大区域：

• 参数列表

  • 展示当前 Action Type 全部参数，每条参数卡片标注数据类型、参数名称、来源绑定的 Webhook 规则；
  • 展开卡片可查看完整配置：参数名称、参数类型、别名、描述、是否必填、允许多值、值输入方式、数据校验规则等全部配置信息。

• 用户界面预览

  • 实时渲染用户调用该 Action Type 时展示的填写表单，直观呈现参数输入组件、必填标识、结构体 / 数组嵌套样式，用于提前校验表单展示效果。

执行设置

切换至执行设置页签，查看元信息权限。默认继承当前项目的权限体系，无需额外配置；该 Action Type 的查看、编辑、调用权限与所属项目权限保持一致。