# 角色模拟能力使用说明

# 概念术语

●应用，即集成角色模拟服务的第三方应用程序。您需要在车联AI-Saas平台注册您的应用程序，获取唯一的身份凭证，作为后续调用 API 时的认证依据。

●玩家，即与角色对话的终端用户。您需要为每一位使用对话功能的用户创建玩家帐号。除非您在应用层自定义了特殊逻辑，否则默认情况下，每个玩家都可以与应用下的任意角色进行对话。

●角色，即人格。角色必须创建在某个玩家帐号下。您可以使用固定的玩家帐号来集中管理所有角色，也可以允许玩家自定义角色，将角色创建在不同玩家帐号下。

●会话，包含一轮或多轮对话。玩家退出对话功能时，视为本次会话的终结。当玩家再次访问对话功能时，视为新会话的开始。

●对话，包含一次玩家的输入，和一次角色模拟服务的对话输出。

●短期记忆，包含对话记忆和观察记忆。
对话记忆指，玩家和角色经历的每一轮对话。对话记忆将持续影响角色的后续对话及行为反应。对话记忆由我们的服务自动创建。
观察记忆指，角色视角下的剧情场景、背景知识、对话人身份信息等。您可以在调用对话接口前，为角色创建一条观察记忆，帮助角色了解场景上下文，并按照剧情展开对话。

# 使用流程

创建应用 -> 开通服务（领取试用包或购买套餐）-> 创建玩家帐号 -> 创建角色（人格） -> 生成对话

# 生成对话流程

1.注册玩家帐号
您需要为每一位使用对话功能的用户创建玩家帐号。
涉及接口：player/if_register()、player/register()

2.（可选）初始化对话场景
您可以在每次会话开启前，为角色创建一条“短期记忆”，帮助角色理解当前对话的场景或前情提要。
涉及接口：interactive/generate

3.（可选）发起对话
您可以使用这项特性，创作角色“主动”向玩家发言的效果。
涉及接口：interactivews

4.响应对话
当玩家发言后，驱动角色回应
涉及接口：interactivews

5.（可选）全新会话
当角色生成的对话出现重复生成等异常时，您可以使用这项功能，清除角色模拟服务缓存中的对话历史，对角色进行重置。
涉及接口：interaction/clear-cache