> 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** 按钮
* **角色设置** 菜单（三个点）

这些控件在每个页面上的行为都相同。

<figure><img src="/files/65271d1b0950247f990a3b0f4aba4ac7603d4b0b" alt=""><figcaption></figcaption></figure>

***

## 控件概览

### 1. 角色版本控制

使用版本控制来保存并在你的角色不同定义之间切换。

* **它的作用**
  * 保存角色定义的一个带名称快照，这样你就可以在不丢失偏好设置的情况下测试新想法。
  * 可让你切换到任何已保存的版本，并从那里继续编辑。
* **典型用途**
  * 在尝试新的核心描述或个性时，保留一个稳定的生产版本。
  * 为不同受众或渠道准备不同变体。
* **良好实践**
  * 为版本取清晰的名称并添加简短备注，例如“v1.2 零售语气”或“v2.0 多语言测试”。
  * 在重大编辑之前，或在把角色交给队友之前，先保存一个版本。

更多信息请参阅 [角色版本控制](/api-docs/zh/convai-playground/get-started/character-versioning.md) 文档。

<figure><img src="/files/5ded1b4b9aae15de911b00d4895a400e2ac22130" alt=""><figcaption></figcaption></figure>

### 2. 更新按钮

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

* **状态**

  * **绿色**：表示有未保存的编辑。点击 **Update** 进行保存。

  <figure><img src="/files/4106dc9d1253a2a111403ee792c787b109017fb6" alt=""><figcaption></figcaption></figure>

  * **灰色**：所有内容都已保存。

  <figure><img src="/files/4a06773a2ad6e2be1856ddaa42302462e167edbf" alt=""><figcaption></figcaption></figure>
* **重要**
  * 如果你在按钮为绿色时刷新页面或离开页面，未保存的更改将会丢失。
  * 点击 **Update** 在任一标签页编辑后，点击保存，然后再继续测试。

### 3. 角色设置菜单

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

<figure><img src="/files/d8dbecead9391b0c4c078f9a2bb6ac7531f6a695" alt=""><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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/zh/convai-playground/get-started/global-character-controls.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.