> 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、发布和记忆页面上。

***

## 这些控件的位置

查看任意角色页面的右上方，您会看到：

* **版本管理** 图标
* **更新** 按钮
* **角色设置** 菜单（三个点）

这些控件在每个页面上的操作方式都相同。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FtXYxafaVN6HRIqGq9w5f%2Fimage.png?alt=media&amp;token=25f0f04e-a826-4566-af28-7f9eea8bd786" alt="Shared character toolbar with versioning, update, and settings controls"><figcaption></figcaption></figure>

***

## 控件概览

### 1. 角色版本管理

使用版本管理保存并切换角色定义的不同版本。

* **功能说明**
  * 保存角色定义的命名快照，让您可以测试新想法，同时保留偏好的配置。
  * 让您切换到任意已保存的版本，并从该版本继续编辑。
* **常见用途**
  * 在尝试新的核心描述或个性设定时，保留稳定的生产版本。
  * 为不同受众或渠道准备多个版本。
* **最佳实践**
  * 为版本取清晰的名称，并添加简短备注，例如“v1.2 零售语气”或“v2.0 多语言测试”。
  * 进行重大修改前，或将角色交给队友前，先保存一个版本。

如需了解更多信息，请参阅 [角色版本管理](https://docs.convai.com/api-docs/zh/convai-playground/get-started/character-versioning.md) 文档。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FhOiHEDFmsKkk3yTqe0fQ%2Fimage.png?alt=media&amp;token=8c8d5128-4b82-46c7-b027-eabf52395ab2" alt="Character versioning panel opened from the shared toolbar"><figcaption></figcaption></figure>

### 2. 更新按钮

将未保存的更改应用到角色。

* **状态**

  * **绿色**：存在未保存的编辑。点击 **更新** 以保存。

  <figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FSnaTabS5Ttrz6B1wHS0B%2FScreenshot%202025-08-10%20142530.png?alt=media&amp;token=9969a6cb-448b-4e14-9bd6-f428ac18195c" alt="Enabled Update button indicating unsaved character changes"><figcaption></figcaption></figure>

  * **灰色**：所有更改均已保存。

  <figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FOUaJkBcxk22QF2NAu2Qp%2Fimage.png?alt=media&amp;token=cfb0d2fe-ce09-4717-a53c-1eb6e56bf11c" alt="Disabled Update button indicating that character changes are saved"><figcaption></figcaption></figure>
* **重要提示**
  * 如果按钮为绿色时刷新页面或离开当前页面，未保存的更改将会丢失。
  * 编辑后，在任何选项卡上点击 **更新** ，然后再进行测试。

### 3. 角色设置菜单

打开三点菜单，即可访问影响整个角色的操作。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2F7F4oOLegHdqzoDguBa62%2Fimage.png?alt=media&amp;token=c848f07c-276c-4420-ac8e-4bf377536dda" alt="Character Settings menu with clone, share, and delete actions"><figcaption></figcaption></figure>

**克隆角色**

创建副本，以便安全地分支开展工作。

* **复制内容**：会复制所有角色配置选项卡（例如“描述”“个性”“语言”等），但不包括“记忆”选项卡。
* **变化内容**：克隆角色会获得新的角色 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=<question>&goal=<user_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.
