操作手册

1.有灵妙启人设创作智能体介绍

1.1 产品介绍

有灵妙启人设创作智能体是一个智能 NPC 自定义创作工具，用户通过输入角色信息可轻松定制具有记忆、个性、表情、语音、行为的虚拟角色，并且通过 API 的方式可以将角色应用于项目中。

1.2 平台能力

• 零代码复刻角色，实现自定义人设设置，定制专属人设对话；
• 海量官创建角色，覆盖游戏、古今名人、影视、动漫人物等；
• 支持知识库+世界观的设置，配置专属角色对话；
• 角色对话连贯性、角色扮演一致性高，对话拟人化口语化；

1.3 模块介绍

• 角色广场：展示官方和用户公开的角色，覆盖游戏、古今名人、影视、动漫人物等；
• 聊一聊：可在广场选择内或自建的角色开启自由对话，支持聊天记录查看。
• 创建角色：用户从该入口创建的各种自定义角色。
• 账户管理：支持用户查看账户信息，支持实名认证。
• API KEY：每个账号最多同时可拥有 10 个有效的 API-KEY，当前发布版本暂不提供 API 调用。

2.角色广场

广场展示官方提供的角色，选择你想要对话的角色，点击卡片即可与 TA 们开启对话。

3.如何创建角色

• 自由创建：高度自定义，用户可自定义角色信息、记忆、世界观等信息
• AI 帮我创作：小白友好，提供模板格式，引导创作者填写角色信息。

3.1 基础信息

支持高度自定义的创建角色。其中人设基本信息，包括头像、角色名称、角色基本信息、世界观、角色性格、对话开场白、对话示例、角色类型，如果没有特别的要求，只要完成这里必填属性的完善，就可以快速创建一个角色了！

3.1.1 角色基本描述

关于这个角色的设定。详细信息非常重要，你需要在基本信息完成对角色的所有定义。详细信息支持录入和 AI 自动模版生成。

配置建议

• 明确指代关系，使用“角色名称”来指代角色，使用“我”指代玩家。
• 描述指令的内容不要出现前后矛盾。 避免角色出现混淆。
• 尽量用精炼明确的词汇描述角色，并且用简单句式，不要用太长、太绕的句子。
• 英文字母、希腊字母、标点符号、特殊符号、空格、回车等算 1 个字符。

3.1.2 世界观设置

可作为角色基础信息的补充，相关信息都会作为 prompt 影响角色的表现。 注意：英文字母、希腊字母、标点符号、特殊符号、空格、回车等算 1 个字符。

3.1.3 角色性格

• 角色性格特征设定后，将大幅提升角色扮演一致性。
• 支持 MBTI 角色设定；
• 支持性格标签设定；
• 支持自定义手动录入。

3.1.4 对话开场白

角色和用户说的第一句话。开场白非常重要，它会为用户后续和角色的对话进行引导，并且会影响到后续的对话。 配置建议：

• 可以通过开场白引导用户回复，避免用户一开始无话可说。
• 可以体现角色的说话风格，比如用（）内容表示动作，说话语气体现出是强势或温柔。
• 可以体现场景和人物设定，比如，以及情侣、子女、同事关系。

3.1.5 对话示例

角色说话的示例。当你希望角色能够遵循一定的对话格式，或当你希望角色表现出来的说话示例和风格很难用一句话描述清楚时，可尝试构建对话示例来引导角色。 配置建议：

• 尽量覆盖你所设定的对话情境下，可能出现的场景问题和提问类型。广泛的覆盖能够更避免出现未考虑的场景。
• 角色回复的内容，不同的表现形式以及你希望出现的比例，也可以在示例中表现。

3.1.6 知识库

支持前端输入或者文件上传， 配置建议：

• 创建的角色需要对部分的知识有独有的理解和回复，可以自建知识库。
• 为了保证回复的准确性，强烈建议一行配置一条知识，单条知识字数上限建议控制在 300 以内。
• 内容请以一行一条知识的方式，创建知识，请用换行符或者标点进行切分；
• 最好用陈述句形式的知识，尽量用简短的句子便于模型理解。

3.1.6 关于模型

• 自研玉言 character1.0：适合角色扮演场景下使用，口语化、拟人化、趣味性比较强；
• 三方角色对话模型：支持接入三方角色对话模型，提供 MoE 专家模型为用户匹配最佳模型。

模型参数配置：

• 回复多样性/创造性（ temperature）：取值范围 0 ～ 1， 数值越高，模型生成的回复多样性/创作性越大；数值越低，生成的回复更集中，确定性更强，默认值为 0.7；
• 回复发散性（Top P）：体现角色回复用词的发散性。数值越高，角色回复的用词发散性越高，人设回复越不稳定。建议该参数的值范围为 0.9-1.0，默认值为 0.9。

3.1.7 权限设置

分享：

• 选择角色是否允许分享给平台其他用户聊天，或仅支持自己使用。

公开：

• 不公开：仅自己可见
• 公开：所有人可见，当前版本暂不提供；

4.和角色聊一聊

用户可以通过点击“创作者中心”或“角色广场”角色进行聊天，对话页面可以回溯你与所有角色的历史记录。 （1）聊天列表：展示用户与角色的聊天记录，按照最后一次聊天时间进行倒序排列。

（2）重置聊天：点击重置聊天，将会清空模型的上下文记忆。

（3）角色信息：点击查看角色信息。

（4）清屏：该操作将清空界面上与该角色的所有聊天历史记录。

（5）更多操作

• 编辑角色：当你对角色有编辑权限时，显示编辑角色入口，点击可对角色的信息字段进行编辑；
• 保存消息：点击你可以选择你需要保存为长截图的聊天信息。

（6）hover 在角色消息框时，显示角色回复消息的更多操作

• 点赞/点踩：如果遇到您认为精彩的或者不合适的回复，可以点赞 或 点踩，从而提升 NPC 的表现；
• 换一换：你对角色回复内容不满意时，可选择切换其他的回复或则重新录入回复内容，从而提升角色的聊天效果；（只有 bot 回复的最后一句，因换之前的对话记录会影响历史对话）

（7）聊天框：支持你通过点击或 Enter 键发送消息。

5. 创作者中心

支持用户按列表的方式进行查看历史创建的角色，并且选择角色进行聊一聊，同时支持用户修改角色的配置及查看觉得数据统计结果。 创建成功之后，角色列表新增一个角色，鼠标 hover 角色卡片，支持聊天、编辑、公开和删除角色/群聊。

（1）和 TA 聊天：点击进入聊天界面

（2）编辑：点击进入角色资料编辑页面

（3）更多：API 接入、分享角色、删除角色，其中角色删除后，角色的资料和聊天信息都会被清空。

6. 账户管理

支持用户信息查看，其中申请 API KEY 需要完成实名认证。

7. API KEY

用户在使用 API 之前，需要在平台上先完成实名认证、注册、创建 API- Key 等流程。 未来 API 调用接入，将通过 API-KEY 进行鉴权，当前版本暂时不提供 API 方式调用，支持用户通过页面创建角色进行体验。 注意：基于安全策略，API-Key，生成后，请将此密钥保存在安全且易于访问的地方，API-KEY 在第一次生成后将无法再次查看，用户将无法通过管理界面再次查看它。如果您丟失了这个密钥，用户将需要生成一个新的密钥。 其中，总 API-Key 创建上限：10 个，密钥长度：64 位。 注意：API-KEY，同一个用户 API-KEY 的名字不能重复.