Getting Started

AI Providers is independent. You can import it alone or alongside other Beka Forge tools. The first successful setup is: create or select a provider asset, enter a local API key, and send a minimal prompt.

Requirements and scope

  • Unity 2021.3 LTS or newer.
  • No hard dependency on Dialogue Graph System or AI Extension.
  • Runtime assembly: AiProviders.Runtime.
  • Editor assembly: AiProviders.Editor.

First-time editor flow

  1. Import Assets/AiProviders.
  2. Open Tools > BekaForge > AI Providers.
  3. Create or select a provider asset.
  4. Store the API key locally for that provider GUID.
  5. Run the provider test request.
  6. Use the provider asset from editor tooling or runtime code.

Provider settings panel

AI Providers panel with provider selection and local API key

This is the first editor surface most users touch: choose a provider, enter a local key, test the connection, and save the default configuration.

Minimal blocking request

using AiProviders.Runtime;
using System.Collections.Generic;

var chat = new LlmChatRequest
{
    messages = new List<LlmMessage>
    {
        new LlmMessage { role = LlmMessageRole.System, content = "You are a helpful assistant." },
        new LlmMessage { role = LlmMessageRole.User, content = "Hello!" }
    }
};

if (AiProvidersService.TrySendPrompt(provider, chat, out string response, out string error))
{
    Debug.Log(response);
}

When to prefer the coroutine path

The blocking path is primarily editor-oriented. For runtime usage, prefer SendPromptCoroutine so the caller is not stuck inside a busy wait loop.