Getting Started

# Install the AI Gateway client library
dotnet add package Noundry.AIG.Client

using Noundry.AIG.Client;
using Noundry.AIG.Client.Builders;
using Noundry.AIG.Client.Configuration;
using Noundry.AIG.Core.Extensions;
using Noundry.AIG.Core.Models;
using Noundry.AIG.Providers;

// Configure the client
var httpClientFactory = new SimpleHttpClientFactory();
var providerFactory = new ProviderFactory(httpClientFactory);

var options = new AigClientOptions
{
    UseLocalProviders = true,
    ProviderConfigs = new Dictionary<string, ProviderConfig>
    {
        ["openai"] = new ProviderConfig
        {
            ApiKey = Environment.GetEnvironmentVariable("OPENAI_API_KEY")
        },
        ["anthropic"] = new ProviderConfig
        {
            ApiKey = Environment.GetEnvironmentVariable("ANTHROPIC_API_KEY")
        }
    }
};

var aigClient = new AigClient(providerFactory, options);

// Send a request using PromptBuilder
var prompt = new PromptBuilder()
    .WithModel("anthropic/claude-sonnet-4")
    .WithTemperature(0.7f)
    .AddSystemMessage("You are a helpful AI assistant.")
    .AddUserMessage("Explain quantum computing in simple terms.")
    .Build();

var response = await aigClient.SendAsync(prompt);
Console.WriteLine(response.GetTextContent());

// Create a chain that generates, writes, and translates content
var chain = new ChainPromptBuilder()
    .WithDefaultModel("anthropic/claude-sonnet-4")

    // Step 1: Generate a random topic
    .AddStep("Generate Topic", _ =>
        new PromptBuilder()
            .AddUserMessage("Give me a random creative writing topic."))

    // Step 2: Write about the topic (uses previous output)
    .AddStep("Write Content", previousOutput =>
        new PromptBuilder()
            .AddUserMessage($"Write a short paragraph about: {previousOutput}"))

    // Step 3: Translate to Spanish
    .AddStep("Translate", previousOutput =>
        new PromptBuilder()
            .WithModel("openai/gpt-4")  // Can use different models per step
            .AddUserMessage($"Translate to Spanish:\n{previousOutput}"));

// Execute the chain
var result = await chain.ExecuteAsync(aigClient);

if (result.Success)
{
    Console.WriteLine($"Final output: {result.FinalOutput}");

    // Inspect each step
    foreach (var step in result.Steps)
    {
        Console.WriteLine($"{step.StepName}: {step.Output}");
    }
}

// Try multiple providers in preferred order
var prompt = new PromptBuilder()
    .WithModels(
        "openai/gpt-4",           // Try OpenAI first
        "anthropic/claude-sonnet-4",  // Fall back to Anthropic
        "google/gemini-pro"        // Finally try Google
    )
    .AddUserMessage("Generate a creative story idea.")
    .Build();

var multiResponse = await aigClient.SendMultiAsync(prompt);

Console.WriteLine($"Received {multiResponse.Responses.Count} responses");
Console.WriteLine($"Time taken: {multiResponse.TotalDurationMs}ms");

// Get the first successful response
if (multiResponse.HasSuccess && multiResponse.FirstSuccess != null)
{
    Console.WriteLine($"Response from: {multiResponse.FirstSuccess.Provider}");
    Console.WriteLine(multiResponse.FirstSuccess.GetTextContent());
}

// Or compare all responses
foreach (var resp in multiResponse.Responses)
{
    var status = resp.IsSuccess() ? "Success" : $"Failed - {resp.Error?.Message}";
    Console.WriteLine($"- {resp.Model}: {status}");
}

var streamingPrompt = new PromptBuilder()
    .WithModel("openai/gpt-4")
    .WithStreaming(true)
    .AddUserMessage("Write a short story about a time traveler.")
    .Build();

Console.Write("Response: ");

// Stream the response as it's generated
await foreach (var chunk in aigClient.SendStreamAsync(streamingPrompt))
{
    if (chunk.IsSuccess())
    {
        var text = chunk.GetTextContent();
        if (!string.IsNullOrEmpty(text))
        {
            Console.Write(text);  // Print as it arrives
        }
    }
}

Console.WriteLine();