操作场景
SOUL 管理页面用于定义 AI 助手的身份、行为准则与回答风格。管理端已发布的 SOUL 模板即为用户端创建或编辑 Claw 时的 SOUL 可选集。本文介绍如何新建、编辑和删除 SOUL。
背景信息
SOUL（System Objective Understanding Layer）是 DatabaseClaw 的核心配置之一，用于定义 AI 助手的身份角色、行为准则、回答风格和能力边界。通过 SOUL 配置，您可以精确控制 AI 助手在特定业务场景下的响应策略、专业领域和操作权限。一个规范的 SOUL 配置通常包含以下结构：
身份定义：AI 助手的角色定位。
行为准则：回答时应遵循的规范。
回答风格：语言风格和交互方式。
能力边界：明确可以做和不可以做的事情。
SOUL 分为预设和自定义两类，预设 SOUL 由系统提供，不可编辑和删除。
前提条件
已被授予
QcloudDatabaseClawAdminFullAccess CAM 策略。操作步骤
查看 SOUL 列表
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > SOUL 管理页面。
4. 页面以卡片展示所有 SOUL，区分预设和自定义两类。支持按名称或描述搜索。
新建 SOUL
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > SOUL 管理页面。
4. 在页面上方单击新建 SOUL，在弹窗中填写以下信息。
参数 | 是否必填 | 说明 |
SOUL 名称 | 是 | SOUL 的名称，便于后续识别和选择。 支持输入1-128字符。 |
SOUL 描述 | 否 | 描述该 SOUL 的功能和使用场景。 |
SOUL 内容 | 否 | 定义 AI 助手的身份、行为准则与能力边界。支持 Markdown 格式，最大100KB。 |
5. 单击确定并发布完成创建。
新建的 SOUL 默认为已开启状态，开启后用户端可见。
查看 SOUL 详情
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > SOUL 管理页面。
4. 单击目标 SOUL 卡片，即可在右侧面板中查看该 SOUL 的详细信息。
顶部概览
参数 | 说明 |
SOUL 名称 | SOUL 的名称。 |
运行状态 | SOUL 当前的运行状态，如启用中（绿色标识）。 |
关联信息 | 已关联的用户数、关联的 Claw 实例使用数。 |
创建时间 | SOUL 的创建时间，如2026-04-11 22:09:05创建。 |
来源标签 | SOUL 来源类型，如自定义。 |
SOUL 信息页签
参数 | 说明 |
描述 | SOUL 的功能描述文本。 |
创建时间 | SOUL 的创建时间。 |
SOUL 内容 | SOUL 的内容展示。 |
启用/禁用 SOUL
启用：单击 SOUL 卡片上的开关启用 SOUL。启用后用户端创建或编辑模板时可选择该 SOUL。
禁用：单击 SOUL 卡片上的开关禁用 SOUL，系统将展示影响范围（被多少实例使用、涉及多少用户），需勾选确认后，单击确认。禁用后新创建的模板不可选择该 SOUL。
编辑/复制/删除 SOUL
编辑：在 SOUL 卡片右下方单击
复制：在 SOUL 卡片右下方单击
删除：在 SOUL 卡片右下方单击
注意：
仅自定义类型 SOUL 可编辑和删除，系统预设 SOUL 不可编辑、不可删除。
删除 SOUL 后不可恢复。如仅需临时停用，建议使用禁用功能。
用户端对 SOUL 的编辑存储在实例上，不影响管理端的 SOUL 模板。
相关操作
对应的 API 接口
API 名称 | 说明 |
CreateSOUL | 创建 SOUL 模板。 |
ModifySOUL | 修改 SOUL 模板。 |
DeleteSOUL | 删除 SOUL 模板。 |
DescribeSOULList | 查询 SOUL 列表。 |
DescribeSOULDetail | 查询 SOUL 详情。 |
常见问题
SOUL 内容有什么编写建议？
建议按“身份定义、行为准则、回答风格、 能力边界”结构编写，使用 Markdown 格式增强可读性。
删除 SOUL 后已使用该 SOUL 的实例会受影响吗？
不会。实例创建时已将 SOUL 内容复制到实例级别，管理端删除 SOUL 模板不影响已有实例的运行。
