Skip to content
This repository was archived by the owner on Mar 11, 2026. It is now read-only.

Commit 73c14cd

Browse files
author
astrbot-docs-agent[bot]
committed
docs: update for AstrBotDevs/AstrBot#4532
1 parent e9aa976 commit 73c14cd

File tree

3 files changed

+58
-0
lines changed

3 files changed

+58
-0
lines changed

.vitepress/config.mjs

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -157,6 +157,7 @@ export default defineConfig({
157157
collapsed: true,
158158
items: [
159159
{ text: "WebUI", link: "/webui" },
160+
{ text: "人格设定", link: "/persona" },
160161
{ text: "插件", link: "/plugin" },
161162
{ text: "内置指令", link: "/command" },
162163
{ text: "工具使用 Tools", link: "/function-calling" },
@@ -376,6 +377,7 @@ export default defineConfig({
376377
collapsed: true,
377378
items: [
378379
{ text: "WebUI", link: "/webui" },
380+
{ text: "Persona", link: "/persona" },
379381
{ text: "Plugins", link: "/plugin" },
380382
{ text: "Built-in Commands", link: "/command" },
381383
{ text: "Tool Use", link: "/function-calling" },

en/use/persona.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Persona
2+
3+
Persona is one of the core features of AstrBot, allowing you to define different identities, personalities, reply styles, and available tools for your bot.
4+
5+
## Persona Management
6+
7+
You can manage all personas through the **Persona Management** page in the AstrBot Control Panel (WebUI).
8+
9+
### Creating a Persona
10+
Click the **Create** button in the top right corner and fill in the following information:
11+
- **Persona ID**: A unique identifier.
12+
- **System Prompt**: Describes the bot's identity and behavioral guidelines.
13+
- **Dialog Pairs**: Preset conversation examples to help the model better understand the settings.
14+
- **Tools**: Tools that this persona can invoke.
15+
16+
### Import and Export
17+
In version 4.12.4, we introduced the import and export functionality for personas, making it easier for users to share and back up their settings.
18+
19+
- **Export**: In the persona card menu, click **Export JSON**. This will download a JSON file containing the persona settings.
20+
- **Import**: Click the **Import** button in the top right corner and select a previously exported JSON file. The system will automatically check for persona ID conflicts.
21+
22+
## Command Management
23+
24+
You can also manage and switch personas through commands in the chat.
25+
26+
- `/persona list`: Lists all personas in a tree structure.
27+
- `/persona <persona_id>`: Switches to the specified persona.
28+
- `/persona view <persona_id>`: Views detailed information about a persona.

zh/use/persona.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# 人格设定
2+
3+
人格设定(Persona)是 AstrBot 的核心功能之一,它允许你为机器人设定不同的身份、性格、回复风格以及可使用的工具。
4+
5+
## 人格管理
6+
7+
你可以通过 AstrBot 管理面板(WebUI)的 **人格管理** 页面来管理所有人格。
8+
9+
### 创建人格
10+
点击页面右上角的 **创建** 按钮,填写以下信息:
11+
- **人格 ID**: 唯一标识符。
12+
- **系统提示词 (System Prompt)**: 描述机器人的身份和行为准则。
13+
- **对话对 (Dialog Pairs)**: 预设的对话示例,帮助模型更好地理解设定。
14+
- **工具 (Tools)**: 该人格可以调用的工具。
15+
16+
### 导入与导出
17+
在 v4.12.4 版本中,我们引入了人格的导入与导出功能,方便用户分享和备份人格设定。
18+
19+
- **导出**: 在人格卡片的菜单中,点击 **导出 JSON**。这将下载一个包含该人格设定的 JSON 文件。
20+
- **导入**: 点击页面右上角的 **导入** 按钮,选择之前导出的 JSON 文件即可。系统会自动检查人格 ID 是否冲突。
21+
22+
## 指令管理
23+
24+
你也可以通过指令在聊天中管理和切换人格。
25+
26+
- `/persona list`: 以树状结构列出所有人格。
27+
- `/persona <人格名>`: 切换到指定人格。
28+
- `/persona view <人格名>`: 查看人格的详细信息。

0 commit comments

Comments
 (0)