> 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/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/static-context-at-connection-time.md).

# 连接时的静态上下文

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

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

### 检视器配置

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

<figure><img src="/files/4903eadedaba2d38e64e9bc4f1459b1ce5104745" alt="Unity Inspector showing the Dynamic Info (Connection Request) section on ConvaiCharacter with Initial Dynamic Info Text and Initial Dynamic Info Keep In Context fields"><figcaption><p>ConvaiCharacter 的动态信息字段中——初始动态信息文本会在会话开始时发送一次；启用“保持在上下文中”可在整个会话期间的所有 LLM 回合中保留这些事实。</p></figcaption></figure>

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

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

#### 示例配置

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

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

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

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

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

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

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

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

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

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

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

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

{% hint style="info" %}
要为新会话更改初始上下文，请结束当前对话，更新 **初始动态信息文本** 字段，并重新连接。初始上下文每个会话仅发送一次 `ConnectAsync` 调用设置。
{% endhint %}

### 脚本访问

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

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

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

### 下一步

{% content-ref url="/pages/fe2e3da29009b41a36bf622ae1efd7921e09aab7" %}
[命令组件参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/command-component-reference.md)
{% endcontent-ref %}

{% content-ref url="/pages/5c3f9bcc544ac6f441fe54139ac1c670eeb5c958" %}
[动态上下文脚本 API](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/dynamic-context-scripting-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/bb1aef3496a2be08987c770aa7b8072e7d8c5cd6" %}
[同步行为和时序](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/sync-behavior-and-timing.md)
{% endcontent-ref %}


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/features/dynamic-context/static-context-at-connection-time.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.