> 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/plugins-and-integrations/convai-unreal-engine-plugin/features/dynamic-context.md).

# Dynamic context

Dynamic context lets a Convai character know what is happening in your level right now — trainee health, current zone, equipment status, alarms, and narrative beats. You push updates from Blueprint through the `Convai|DynamicContext` node family on the `Convai Chatbot` component (`UConvaiChatbotComponent`).

Use dynamic context when a fact changes during gameplay and the character should be able to reference it in conversation. Use `Set Context State` for current conditions that can be replaced (for example, `Health` is `50`). Use `Add Context Event` for one-time moments (for example, `Alarm triggered in sector 4`).

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>How dynamic context works</strong><br>Understand state properties, events, debounce batching, and when the character may respond.</td><td><a href="/pages/HGItmryh4PHfi7WIN9UG">/pages/HGItmryh4PHfi7WIN9UG</a></td></tr><tr><td><strong>Dynamic context quick start</strong><br>Push your first state and event in Blueprint, then verify the character can use the updated context.</td><td><a href="/pages/uLheo1rAJDdMVNFZj7ZL">/pages/uLheo1rAJDdMVNFZj7ZL</a></td></tr><tr><td><strong>Static context at connection time</strong><br>Understand what data is fixed at session start and how it differs from live dynamic context.</td><td><a href="/pages/cf6u0S8978Cad9J2oR2W">/pages/cf6u0S8978Cad9J2oR2W</a></td></tr><tr><td><strong>Sync behavior and timing</strong><br>Understand when updates flush, how offline queueing works, and when to use immediate flush.</td><td><a href="/pages/R2QEV8nZly3I7Sd1ew7G">/pages/R2QEV8nZly3I7Sd1ew7G</a></td></tr><tr><td><strong>Dynamic context Blueprint reference</strong><br>Reference for every `Convai|DynamicContext` node, property, enum, and transport field.</td><td><a href="/pages/KeXDDGyIx8dXyg80DYwi">/pages/KeXDDGyIx8dXyg80DYwi</a></td></tr><tr><td><strong>Dynamic context usage examples</strong><br>Blueprint recipes for health tracking, zone changes, narrative events, and session resets.</td><td><a href="/pages/m4rqRxdMbmG8hRxTM7Q2">/pages/m4rqRxdMbmG8hRxTM7Q2</a></td></tr><tr><td><strong>Troubleshoot dynamic context</strong><br>Fix updates that arrive too late, trigger unexpected responses, or appear ignored after a flush.</td><td><a href="/pages/G3KIxXwGh1BmpM1vFq9B">/pages/G3KIxXwGh1BmpM1vFq9B</a></td></tr></tbody></table>

### Recommended reading order

1. [How dynamic context works](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/dynamic-context/how-dynamic-context-works.md) — learn the state and event model.
2. [Dynamic context quick start](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/dynamic-context/dynamic-context-quick-start.md) — push and verify your first update.
3. [Static context at connection time](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/dynamic-context/static-context-at-connection-time.md) — separate session-start facts from live updates.
4. [Sync behavior and timing](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/dynamic-context/sync-behavior-and-timing.md) — tune flushing, queueing, and immediate sync behavior.
5. Reference, examples, and troubleshooting pages — use when you need exact node behavior, applied patterns, or a fix.

{% content-ref url="/pages/HGItmryh4PHfi7WIN9UG" %}
[How dynamic context works](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/dynamic-context/how-dynamic-context-works.md)
{% endcontent-ref %}

{% content-ref url="/pages/uLheo1rAJDdMVNFZj7ZL" %}
[Dynamic context quick start](/api-docs/plugins-and-integrations/convai-unreal-engine-plugin/features/dynamic-context/dynamic-context-quick-start.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/plugins-and-integrations/convai-unreal-engine-plugin/features/dynamic-context.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.