Customize and extend the SDK

Replace SDK providers, extend the runtime with custom modules, and diagnose latency using built-in telemetry — for deployments where the defaults are not enough.

The Convai Unity SDK works out of the box for most training simulations, interactive experiences, and games. This section covers what to reach for when the defaults do not fit your deployment: replacing built-in providers with custom implementations, diagnosing performance issues with built-in telemetry, and adding custom modules to the runtime.

These pages assume C# proficiency and familiarity with Unity's component lifecycle. If you are still setting up your first scene, start with the Getting Started section.

Credentials, identity, and storage Replace the SDK's credential, identity, and persistence systems with your own implementations. Essential for CI pipelines, auth-backed identity, and cloud save integration.

Logging, metrics, and retry policy Tune log verbosity per subsystem, read server-side pipeline latency metrics, and configure retry behavior for resilient connections.

Runtime module system Understand when to build custom modules, how the module lifecycle works, and which SDK extension points are safe to use.