// Copyright (c) Microsoft. All rights reserved. // This sample shows how to use TextSearchProvider to add retrieval augmented generation (RAG) // capabilities to a hosted agent. The provider runs a search against an external knowledge base // before each model invocation and injects the results into the model context. using Azure.AI.Projects; using Azure.Core; using Azure.Identity; using DotNetEnv; using Microsoft.Agents.AI; using Microsoft.Agents.AI.Foundry.Hosting; using Microsoft.Extensions.AI; using OpenAI.Chat; // Load .env file if present (for local development) Env.TraversePath().Load(); string endpoint = Environment.GetEnvironmentVariable("AZURE_AI_PROJECT_ENDPOINT") ?? throw new InvalidOperationException("AZURE_AI_PROJECT_ENDPOINT is not set."); string deploymentName = Environment.GetEnvironmentVariable("AZURE_AI_MODEL_DEPLOYMENT_NAME") ?? "gpt-4o"; // Use a chained credential: try a temporary dev token first (for local Docker debugging), // then fall back to DefaultAzureCredential (for local dev via dotnet run / managed identity in production). TokenCredential credential = new ChainedTokenCredential( new DevTemporaryTokenCredential(), new DefaultAzureCredential()); TextSearchProviderOptions textSearchOptions = new() { SearchTime = TextSearchProviderOptions.TextSearchBehavior.BeforeAIInvoke, RecentMessageMemoryLimit = 6, }; AIAgent agent = new AIProjectClient(new Uri(endpoint), credential) .AsAIAgent(new ChatClientAgentOptions { Name = Environment.GetEnvironmentVariable("AGENT_NAME") ?? "hosted-text-rag", ChatOptions = new ChatOptions { ModelId = deploymentName, Instructions = "You are a helpful support specialist for Contoso Outdoors. Answer questions using the provided context and cite the source document when available.", }, AIContextProviders = [new TextSearchProvider(MockSearchAsync, textSearchOptions)] }); // Host the agent as a Foundry Hosted Agent using the Responses API. var builder = WebApplication.CreateBuilder(args); builder.Services.AddFoundryResponses(agent); var app = builder.Build(); app.MapFoundryResponses(); if (app.Environment.IsDevelopment()) { app.MapFoundryResponses("openai/v1"); } app.Run(); // ── Mock search function ───────────────────────────────────────────────────── // In production, replace this with a real search provider (e.g., Azure AI Search). static Task> MockSearchAsync(string query, CancellationToken cancellationToken) { List results = []; if (query.Contains("return", StringComparison.OrdinalIgnoreCase) || query.Contains("refund", StringComparison.OrdinalIgnoreCase)) { results.Add(new() { SourceName = "Contoso Outdoors Return Policy", SourceLink = "https://contoso.com/policies/returns", Text = "Customers may return any item within 30 days of delivery. Items should be unused and include original packaging. Refunds are issued to the original payment method within 5 business days of inspection." }); } if (query.Contains("shipping", StringComparison.OrdinalIgnoreCase)) { results.Add(new() { SourceName = "Contoso Outdoors Shipping Guide", SourceLink = "https://contoso.com/help/shipping", Text = "Standard shipping is free on orders over $50 and typically arrives in 3-5 business days within the continental United States. Expedited options are available at checkout." }); } if (query.Contains("tent", StringComparison.OrdinalIgnoreCase) || query.Contains("fabric", StringComparison.OrdinalIgnoreCase)) { results.Add(new() { SourceName = "TrailRunner Tent Care Instructions", SourceLink = "https://contoso.com/manuals/trailrunner-tent", Text = "Clean the tent fabric with lukewarm water and a non-detergent soap. Allow it to air dry completely before storage and avoid prolonged UV exposure to extend the lifespan of the waterproof coating." }); } return Task.FromResult>(results); } /// /// A for local Docker debugging only. /// Reads a pre-fetched bearer token from the AZURE_BEARER_TOKEN environment variable. /// This should NOT be used in production — tokens expire (~1 hour) and cannot be refreshed. /// /// Generate a token on your host and pass it to the container: /// export AZURE_BEARER_TOKEN=$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv) /// docker run -e AZURE_BEARER_TOKEN=$AZURE_BEARER_TOKEN ... /// internal sealed class DevTemporaryTokenCredential : TokenCredential { private const string EnvironmentVariable = "AZURE_BEARER_TOKEN"; public override AccessToken GetToken(TokenRequestContext requestContext, CancellationToken cancellationToken) => GetAccessToken(); public override ValueTask GetTokenAsync(TokenRequestContext requestContext, CancellationToken cancellationToken) => new(GetAccessToken()); private static AccessToken GetAccessToken() { var token = Environment.GetEnvironmentVariable(EnvironmentVariable); if (string.IsNullOrEmpty(token) || token == "DefaultAzureCredential") { throw new CredentialUnavailableException($"{EnvironmentVariable} environment variable is not set."); } return new AccessToken(token, DateTimeOffset.UtcNow.AddHours(1)); } }