AI & LLM Stack¶

1. Overview¶

Every game that onboards IntelliVerseX gets a complete AI-powered game layer — voice personas, AI host commentary, NPC dialog, in-game assistant, moderation, procedural content, player profiling, and standalone speech services — behind a single configuration surface (IVXAIConfig) and shared HTTP/WebSocket infrastructure.

Namespace: IntelliVerseX.AI.

2. Architecture (text diagram)¶

                    ┌─────────────────────────────────────────┐
                    │            IVXAIConfig                     │
                    │  (base URL, audio, language, trials)    │
                    └────────────────────┬──────────────────────┘
                                         │
         ┌───────────────────────────────┼───────────────────────────────┐
         │                               │                               │
         ▼                               ▼                               ▼
┌─────────────────┐           ┌─────────────────┐           ┌─────────────────┐
│ IVXAISessionMgr │           │ IVXAIApiClient  │           │ IVXAIWebSocket  │
│ Voice + Host    │◄─────────│ REST (voice/    │           │ Realtime STT/   │
│ sessions        │           │ host/content/   │           │ voice stream    │
└────────┬────────┘           │ npc/assistant)   │           └────────┬────────┘
         │                    └─────────────────┘                    │
         │                              │                            │
         ▼                              ▼                            ▼
┌─────────────────┐           ┌─────────────────┐           ┌─────────────────┐
│ IVXAINPCDialog  │           │ IVXAIAssistant  │           │ IVXAIVoiceServ. │
│ Manager         │           │ hints / KB       │           │ STT / TTS / list │
└────────┬────────┘           └────────┬────────┘           └────────┬────────┘
         │                              │                            │
         ▼                              ▼                            ▼
┌─────────────────┐           ┌─────────────────┐           ┌─────────────────┐
│ IVXAIContentGen │           │ IVXAIModerator  │           │ IVXAIProfiler   │
│ quests, stories │           │ classify/filter│           │ events, cohort  │
└─────────────────┘           └─────────────────┘           └─────────────────┘

Shared pieces: IVXAIApiClient, IVXAIAudioPlayer, IVXAIAudioRecorder, IVXAIEntitlementManager, DTOs under Models/.

3. AI Voice Sessions (existing)¶

IVXAISessionManager orchestrates voice personas (WebSocket + HTTP fallback) and AI host sessions:

• Voice: create session, stream captions/audio, entitlements, social proof, upsell/scarcity hints, session timer
• Host: commentary aligned with match/player context
• SetPlayerContext(IVXAIPlayerContext) serializes player profiling into voice session requests
• OnSpeechDetected, OnSpeechStopped — backend-reported speech activity

using IntelliVerseX.AI;

IVXAISessionManager.Instance.Initialize(userId, userName, authToken, language);
IVXAISessionManager.Instance.SetPlayerContext(playerContext);
IVXAISessionManager.Instance.OnSpeechDetected += () => { /* show mic active */ };

See also: AI Voice & Host.

4. AI NPC Dialog System (IVXAINPCDialogManager)¶

Events: OnNPCResponse, OnNPCAction, OnDialogStarted, OnDialogEnded, OnError.

npcMgr.Initialize(config);
npcMgr.RegisterNPC(profile);
npcMgr.StartDialog(npcId, playerId, playerContextJson, session => { });
npcMgr.SendMessage(sessionId, "Hello!", response => { });

5. AI In-Game Assistant (IVXAIAssistant)¶

Grounded Q&A and guided help using IVXAIGameContext (level, objective, phase, inventory, stats, custom JSON).

assistant.Initialize(config);
assistant.Ask("How do I beat this boss?", new IVXAIGameContext { CurrentLevel = "3-2" }, r => Debug.Log(r.Response));

6. AI Chat Moderation (IVXAIModerator)¶

moderator.Initialize(config);
moderator.ClassifyText(chatLine, result => {
    if (result.SuggestedAction == IVXModerationActionType.Block) RejectMessage();
});

7. AI Content Generation (IVXAIContentGenerator)¶

Events: OnContentGenerated, OnStreamingChunk, OnError. Use CancelGeneration to abort in-flight HTTP.

8. Player Behavior Profiling (IVXAIProfiler)¶

IVXAIProfiler.Instance.Initialize(config, playerId);
IVXAIProfiler.Instance.TrackEvent("match_end", new Dictionary<string, object> { ["score"] = 1200 });

9. Voice AI Services (IVXAIVoiceServices)¶

Standalone STT, TTS, voice listing, language detection, and streaming transcription (WebSocket) — usable without a full voice persona session.

Initialize with IVXAIConfig before use.

10. Configuration (IVXAIConfig)¶

Helpers: VoiceEndpoint, HostEndpoint, WebSocketUrl, per-session URL builders, Validate, IsLanguageSupported.

11. API Reference — Key Classes¶

Related¶

• AI Getting Started Guide — Quickstart for AI features
• AI Voice & Host — Full Reference — Complete voice session and host API
• Discord Social SDK — Moderation metadata bridge from IVXAIModerator