> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/convai-playground/get-started/global-character-controls.md).
# 全局角色控制
使用共享角色工具栏管理版本、保存更改、克隆或分享角色，并在删除前查看破坏性设置。
请使用 Convai Playground 中每个角色页面右上角的共享控制项。工具栏会出现在角色描述、头像、语言与语音、知识库、人格特质、核心 AI 设置、心态、智能体动作、叙事设计、外部 API、发布和记忆中。
***
## 在哪里找到这些控制项
查看任意角色界面的右上角。你会看到：
* **版本管理** 图标
* **Update** 按钮
* **角色设置** 菜单（三个点）
这些控制项在每个页面上的行为都相同。
***
## 控制项概览
### 1. 角色版本管理
使用版本管理来保存并在角色的不同定义之间切换。
* **它的作用**
* 保存角色定义的一个已命名快照，这样你就可以在不丢失偏好设置的情况下测试新想法。
* 让你切换到任意已保存版本，并从那里继续编辑。
* **典型用途**
* 在尝试新的核心描述或人格时，保留一个稳定的生产版本。
* 为不同受众或渠道准备不同变体。
* **最佳实践**
* 为版本起清晰的名称，并附上简短备注，例如“v1.2 零售语气”或“v2.0 多语言测试”。
* 在重大编辑之前，或在把角色交给队友之前先保存一个版本。
更多信息请参阅 [角色版本管理](/api-docs/zh/convai-playground/get-started/character-versioning.md) 文档。
### 2. 更新按钮
将你未保存的更改应用到角色。
* **状态**
* **绿色**：有未保存的编辑。点击 **Update** 进行保存。
* **灰色**：所有内容都已保存。
* **重要**
* 如果在按钮变为绿色时刷新或离开页面，你未保存的更改将会丢失。
* 点击 **Update** 在任意选项卡编辑后，然后继续测试。
### 3. 角色设置菜单
打开三个点菜单以访问会影响整个角色的操作。
**克隆角色**
创建一个副本，以便你可以安全地分支工作。
* **复制了什么**：会复制所有角色配置选项卡（例如描述、人格、语言等），记忆选项卡除外。
* **会发生什么变化**：克隆体会获得一个新的角色 ID。
* **何时使用**：大型实验、预发布与生产环境拆分、A/B 版本。
**分享角色**
让其他人 **测试** 你的角色。
* **它的作用：** 生成一个分享链接，让接收者可以与角色互动（例如聊天框或视频通话），但无法修改它。
* **它的工作方式：** 打开对话框以复制分享链接，并遵循你当前的可见性设置（公开、未列出或私有）。
**删除角色**
从你的角色中移除该角色。
{% hint style="warning" %}
删除是永久性的，且无法撤销。
{% endhint %}
* **删除前检查清单**
* 确认该角色未在任何上线体验中使用。
* 导出或复制你可能需要的任何内容。
* 考虑克隆以作归档，而不是删除。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.convai.com/api-docs/zh/convai-playground/get-started/global-character-controls.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
