> 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/character-customization/character-description.md).

# 角色描述

了解如何在 Convai Playground 中使用“角色描述”页面来定义角色身份、说话风格和独特特征。

## 简介

此 **角色描述** 页面用于定义 AI 角色的个性、背景故事和交流风格。Convai Playground 中的每个角色都有专属的角色描述页面，确保其拥有独特的身份，并可随着时间推移不断完善。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FKH9Wr554c28l0dMfMxaW%2FScreenshot%202025-08-10%20150107.png?alt=media&amp;token=93ab48ae-b2f3-4d94-a0e4-2874bd630f2f" alt=""><figcaption></figcaption></figure>

***

## 访问角色描述页面

点击任意 **角色卡片** 即可进入 **控制台**。这会打开角色档案，您可以在其中编辑和管理其核心属性。

## 主要功能和部分

### 1. 角色名称和 ID

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fy31XbmcW1CjDg3fW63q2%2FScreenshot%202025-08-10%20150421.png?alt=media&amp;token=e759c7ba-b0dd-4ca6-9fef-8674c5ceb05b" alt=""><figcaption></figcaption></figure>

* **角色名称** – 可编辑字段，用于设置角色的显示名称。
* **角色 ID** – 角色的唯一标识符；在 **Convai SDK** 和 API 集成中使用角色时必不可少。
* 您可以复制此 ID，以便在应用程序中使用。

{% hint style="success" %}
**支持提示**：如果您需要支持团队的帮助，请在报告角色相关问题时提供此 ID。
{% endhint %}

***

### 2. 核心描述 / 说话风格 / 具身表现

**核心描述**

* 补充角色的故事、性格特征、鲜明特点以及行为准则等信息。
* 字数限制： **1000 字**.

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2Fn75dEWhLuegjDyFlF2st%2Fimage.png?alt=media&amp;token=c4004f20-5ab7-4aef-af1f-779f668ed2a8" alt=""><figcaption></figcaption></figure>

**说话风格**

* **描述角色的说话方式** – 概述角色的语气、语速、正式程度和说话习惯。请包含角色常用的独特表达或短语。
* **对话示例** – 提供示例句，展现角色典型的说话风格，并包含能体现其个性的标志性表达。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FTc36yuhMOFa4nAlRd748%2FScreenshot%202025-08-10%20150129.png?alt=media&amp;token=23b0ab07-cf9e-4051-82e2-0ece49b97b06" alt=""><figcaption></figcaption></figure>

**角色化身**

* 目前正在开发中，敬请期待。

***

## 示例

如需灵感，请在控制台中查看 **示例角色** 。这些示例展示了不同角色的核心描述和说话风格是如何组织的。

<figure><img src="https://2402152281-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEtUJA212Zc1S9ACc8T4l%2Fuploads%2FMRb27L3gulM4N3R774j1%2Fimage.png?alt=media&amp;token=cb8dd01d-5a24-4208-91dd-b0889d06c8e4" alt=""><figcaption></figcaption></figure>

***

## 总结

角色描述页面是塑造 AI 角色身份的基础。清晰定义角色的个性、声音和独特特征，有助于确保互动始终一致且引人入胜。


---

# 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/character-customization/character-description.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.
