AI & LLM Stack — Getting Started¶

// All AI managers check config.MockMode before making HTTP calls.
// When enabled, they return sample/placeholder data instantly.

// You can also toggle at runtime:
aiConfig.SetApiKey("");  // Ensure no accidental real calls

using IntelliVerseX.AI;
using UnityEngine;

public class MyNPCExample : MonoBehaviour
{
    [SerializeField] private IVXAIConfig _aiConfig;

    private void Start()
    {
        var npc = IVXAINPCDialogManager.Instance;
        npc.Initialize(_aiConfig);

        // Register an NPC personality
        npc.RegisterNPC(new IVXAINPCProfile
        {
            NpcId = "blacksmith",
            DisplayName = "Gorrak the Smith",
            PersonaPrompt = "Gruff but kind dwarf blacksmith. Expert in rare metals.",
            MaxTurns = 20
        });

        // Start a conversation
        npc.StartDialog("blacksmith", "player_123", null, session =>
        {
            Debug.Log($"Dialog started: {session.SessionId}");

            // Send a message
            npc.SendMessage(session.SessionId, "Can you repair my sword?", response =>
            {
                Debug.Log($"NPC says: {response.Text}");
            });
        });
    }
}

using IntelliVerseX.AI;
using UnityEngine;

public class AIIntegration : MonoBehaviour
{
    [SerializeField] private IVXAIConfig _aiConfig;

    private void OnEnable()
    {
        IVXBootstrap.Instance.OnBootstrapComplete += OnReady;
    }

    private void OnReady()
    {
        string userId = IVXBootstrap.Instance.UserId;
        string token = IVXBootstrap.Instance.AuthToken;

        // NPC Dialog
        IVXAINPCDialogManager.Instance.Initialize(_aiConfig);
        IVXAINPCDialogManager.Instance.SetAuthToken(token);

        // In-Game Assistant
        IVXAIAssistant.Instance.Initialize(_aiConfig);
        IVXAIAssistant.Instance.SetAuthToken(token);

        // Chat Moderation
        IVXAIModerator.Instance.Initialize(_aiConfig);
        IVXAIModerator.Instance.SetAuthToken(token);

        // Content Generation
        IVXAIContentGenerator.Instance.Initialize(_aiConfig);
        IVXAIContentGenerator.Instance.SetAuthToken(token);

        // Player Profiling
        IVXAIProfiler.Instance.Initialize(_aiConfig, userId);
        IVXAIProfiler.Instance.SetAuthToken(token);
        IVXAIProfiler.Instance.StartAutoTracking();

        // Voice Services (STT/TTS)
        IVXAIVoiceServices.Instance.Initialize(_aiConfig);
        IVXAIVoiceServices.Instance.SetAuthToken(token);

        Debug.Log("[AI] All AI managers initialized.");
    }
}

IVXAIModerator.Instance.FilterMessage(playerInput, filtered =>
{
    if (string.IsNullOrEmpty(filtered))
    {
        ShowWarning("Message blocked by moderation.");
        return;
    }
    BroadcastToChat(filtered);
});

IVXAIContentGenerator.Instance.GenerateQuest(
    new IVXQuestTemplate { Genre = "sci-fi", Difficulty = "hard" },
    $"Player level: {playerLevel}, Items: {string.Join(",", inventory)}",
    quest =>
    {
        if (quest != null)
            questLog.Add(quest);
    });

var ctx = new IVXAIGameContext
{
    CurrentLevel = "3-2",
    CurrentObjective = "Defeat the ice dragon",
    PlayerStats = new Dictionary<string, float> { ["health"] = 45f }
};

IVXAIAssistant.Instance.Ask("How do I beat this boss?", ctx, response =>
{
    ShowHintUI(response.Response);
});

IVXAIProfiler.Instance.TrackEvent("match_complete", new Dictionary<string, object>
{
    ["score"] = 1200,
    ["duration_seconds"] = 180,
    ["mode"] = "ranked"
});

IVXAIProfiler.Instance.GetPersonalizationHints(hints =>
{
    foreach (var hint in hints)
        Debug.Log($"Suggestion: {hint.Message} (priority: {hint.Priority})");
});

IVXAINPCDialogManager.Instance.OnError += msg => Debug.LogWarning($"NPC error: {msg}");
IVXAIAssistant.Instance.OnError += msg => Debug.LogWarning($"Assistant error: {msg}");
IVXAIModerator.Instance.OnContentBlocked += (text, reason) => Debug.Log($"Blocked: {reason}");
IVXAIContentGenerator.Instance.OnError += msg => Debug.LogWarning($"Content error: {msg}");
IVXAIVoiceServices.Instance.OnError += msg => Debug.LogWarning($"Voice error: {msg}");