连接时的静态上下文

在 ConvaiCharacter 上配置 InitialDynamicInfoText 和 InitialDynamicInfoKeepInContext，以便在每次对话开始时一次性发送固定的场景事实。

每个 Convai 角色都有两个字段—— 初始动态信息文本 和 初始动态信息保留在上下文中 ——它们会在会话连接的那一刻将一块固定的上下文注入到会话请求中。该上下文会在第一条响应之前仅发送给 Convai 一次，并且独立于运行时动态上下文更新。

将此机制用于在对话开始前就已成立且在会话期间不会改变的事实：设施名称、角色的职责、训练场景类型，或演练的初始条件。对会话过程中会变化的内容使用运行时动态上下文（ConvaiDynamicContextCommand 或 IConvaiDynamicContext）。

检视器配置

这两个字段都位于 ConvaiCharacter 组件下的 动态信息（连接请求） 标题下。

ConvaiCharacter 的动态信息字段中——初始动态信息文本会在会话开始时发送一次；启用“保持在上下文中”可在整个会话期间的所有 LLM 回合中保留这些事实。

字段	类型	默认值	描述
初始动态信息文本	字符串	（空）	作为会话连接请求的一部分发送的自由文本块。没有格式限制——可写普通句子或键值行。
初始动态信息保留在上下文中	bool	false	当 true，Convai 会在整个会话期间的所有 LLM 回合中保留这段文本。当 false时，该文本只会告知第一条响应。

初始动态信息的“保持在上下文中”默认值为 false. 禁用时，Convai 只会使用初始上下文文本来影响角色的第一条响应——它不会在多轮之间保留。如果你希望角色在长会话中始终引用初始事实，请启用此字段。将其保持为禁用，是角色在第一次交互后似乎“忘记”场景上下文的常见原因。

示例配置

对于消防抑制认证演练，将 初始动态信息文本 设置为：

设施：海上平台 Alpha
场景：消防抑制认证演练
受训者角色：接受评估的操作员

启用 初始动态信息保留在上下文中.

角色会在整个对话过程中引用这些事实。你无需通过运行时动态上下文重新发送它们——它们会在整个会话生命周期内保留。

与运行时动态上下文的关系

初始上下文和运行时动态上下文是互补的——而不是替代关系。

	初始动态信息	运行时动态上下文
发送时间	一次，在 ConnectAsync	在会话期间，按需
内容	设计时设置的固定事实	运行时设置的实时状态和事件
适用于	设施名称、场景类型、角色	受训者位置、设备状态、危险等级
可在运行时修改	否——每次连接只发送一次	是——通过 SetState, AddEvent, Reset

这两种机制会同时进入角色的认知中。初始上下文提供稳定基础；运行时动态上下文则在其上叠加实时更新。

// 这些是对初始上下文的补充——而不是替代它
_character.DynamicContext.SetState("Station", "化学品存储区");
_character.DynamicContext.SetState("HazardLevel", "极高");
_character.DynamicContext.AddEvent("受训者绕过了手动锁定程序");

什么 重新发送；只会清除运行时跟踪的状态和事件。 不会清除

调用 重新发送；只会清除运行时跟踪的状态和事件。 在运行时动态上下文层上的操作会清除所有已跟踪的状态和事件。它不会 上的初始动态信息文本 影响初始动态信息：

• 初始动态信息文本 是在连接时发送的，无法通过任何运行时调用撤回或重新发送。
• 系统提示词事实 在 Convai 控制面板中的内容不属于动态上下文层。运行时没有任何 SDK 调用会影响它们。
• 会话内 LLM 记忆 ——角色会在同一会话的多轮对话中保留上下文。 重新发送；只会清除运行时跟踪的状态和事件。 会清除动态上下文跟踪器并向 Convai 发送 Reset 消息，但不会清除模型的会话内对话记忆。

要为新会话更改初始上下文，请结束当前对话，更新 初始动态信息文本 字段，并重新连接。初始上下文每个会话仅发送一次 ConnectAsync 调用设置。

脚本访问

这两个字段都可通过 C# 属性读取，位于 ConvaiCharacter:

string initialText = _character.InitialDynamicInfoText;
bool keepInContext = _character.InitialDynamicInfoKeepInContext;

这些属性在运行时为只读。请在场景播放前通过检视器设置这些值，或通过 SerializedObject 在自定义编辑器工具中。

下一步

命令组件参考动态上下文脚本 API同步行为与时序