.NET et ASP.NET Core

dotnet add package ValaisConnect.Gaspard

{
  "Gaspard": {
    "ApiKey": "vck_live_…",
    "BaseUrl": "https://hubmix.dealmood-solutions.com",
    "Timeout": "00:01:00",
    "MaxRetries": 2
  }
}

using ValaisConnect.Gaspard;

var builder = WebApplication.CreateBuilder(args);

// Client typé enregistré via IHttpClientFactory, options validées au démarrage.
builder.Services.AddGaspard(builder.Configuration.GetSection("Gaspard"));
// ou : builder.Services.AddGaspard(o => o.ApiKey = builder.Configuration["Gaspard:ApiKey"]);

var app = builder.Build();

app.MapPost("/chat", async (ChatRequest request, GaspardClient gaspard, HttpContext http, CancellationToken ct) =>
{
    // Chaque utilisateur de votre service a ses propres conversations.
    var client = gaspard.ForEndUser(http.User.Identity?.Name ?? "anonyme");
    var conversationId = request.ConversationId
        ?? (await client.StartConversationAsync("fr", page: "aide", cancellationToken: ct)).Id;
    var answer = await client.AskAsync(conversationId, request.Text, cancellationToken: ct);
    return Results.Ok(new { conversationId, answer.Text, answer.Sources, answer.MessageId });
});

app.Run();

record ChatRequest(string? ConversationId, string Text);

using System.Text.Json;

app.MapPost("/chat/stream", async (ChatRequest request, GaspardClient gaspard, HttpResponse response, CancellationToken ct) =>
{
    response.Headers.ContentType = "text/event-stream";
    response.Headers.CacheControl = "no-cache";
    response.Headers["X-Accel-Buffering"] = "no";

    try
    {
        await foreach (var item in gaspard.AskStreamAsync(request.ConversationId!, request.Text, cancellationToken: ct))
        {
            if (item.IsDelta)
            {
                await response.WriteAsync($"event: delta\ndata: {JsonSerializer.Serialize(new { text = item.Text })}\n\n", ct);
            }
            else
            {
                var json = JsonSerializer.Serialize(item.Answer!, GaspardJsonContext.Default.Answer);
                await response.WriteAsync($"event: answer\ndata: {json}\n\n", ct);
            }
            await response.Body.FlushAsync(ct);
        }
    }
    catch (GaspardException error)
    {
        await response.WriteAsync($"event: error\ndata: {JsonSerializer.Serialize(new { code = error.Code })}\n\n", ct);
    }
});

using ValaisConnect.Gaspard;

var gaspard = new GaspardClient(new GaspardOptions
{
    ApiKey = Environment.GetEnvironmentVariable("GASPARD_API_KEY"),
});

var conversation = await gaspard.StartConversationAsync();
await foreach (var item in gaspard.AskStreamAsync(conversation.Id, "Comment trouver un logement étudiant à Lyon ?"))
{
    if (item.IsDelta) Console.Write(item.Text);
    else Console.WriteLine($"\n\nSources : {string.Join(", ", item.Answer!.Sources.Select(s => s.Name))}");
}

var passages = await gaspard.SearchKnowledgeAsync("Montréal universités", limit: 3, topics: [KnowledgeTopic.Education]);
foreach (var passage in passages.Passages)
{
    Console.WriteLine($"{passage.Title} ({passage.Score:0.00})");
}

var gaspard = new GaspardClient(new GaspardOptions
{
    PublishableKey = "vcp_live_…",
    Origin = "https://mon-app.example.ch", // une des origines déclarées pour la clé
});

var notice = await gaspard.PrivacyNoticeAsync("fr");
// … afficher notice.Text ; si la personne accepte :
var session = await gaspard.OpenSessionAsync(consent: true, locale: "fr");
SaveSomewhereSafe(session.Token); // valable 30 jours

// Au prochain lancement :
gaspard.SetVisitorToken(LoadToken()); // ou null pour l'oublier

var forAlice = gaspard.ForEndUser("user-1842");                 // client dérivé, même transport
await forAlice.GetConsentAsync();
await gaspard.ExportDataAsync(new GaspardRequestOptions { EndUser = "user-1842" }); // par appel

// Confiance : à la publication d'une annonce
var result = await gaspard.Trust.AssessAsync([
    new TrustListing
    {
        Kind = "housing", Title = listing.Title, Description = listing.Description,
        PriceAmount = listing.Rent, Currency = "EUR", CountryCode = "FR", City = "Lyon",
    },
]);
if (result.Assessments[0].Withheld) { /* à faire vérifier ; Findings dit pourquoi */ }

// Tuteur : des cartes de révision
var cards = await gaspard.Tutor.FlashcardsAsync(new TutorFlashcardsRequest
{
    Lesson = new Lesson { Title = "La photosynthèse", Content = courseText },
    Count = 8,
    Learner = new Learner { Level = "bachelor", CountryCode = "SN" },
    Locale = "fr",
});

// Embeddings : un vecteur par texte, dans le même ordre
var vectors = (await gaspard.Embeddings.CreateAsync(["chambre à louer", "room for rent"])).Embeddings;

try
{
    var answer = await gaspard.AskAsync(conversationId, question);
}
catch (GaspardException error) when (error.Code == "conversation_full")
{
    // démarrer une nouvelle conversation
}
catch (GaspardException error) when (error.Code == "token_quota_exceeded")
{
    logger.LogWarning("Quota atteint, réessayer dans {Delay}", error.RetryAfter);
}