// Copyright (c) Microsoft. All rights reserved. // Foundry Toolbox Agent - A hosted agent that uses Foundry Toolset MCP tools. // // Demonstrates how to register one or more Foundry toolsets so the agent can // call tools provided by the Foundry platform's managed MCP proxy. // // Required environment variables: // AZURE_AI_PROJECT_ENDPOINT - Azure AI Foundry project endpoint // AZURE_AI_MODEL_DEPLOYMENT_NAME - Model deployment name (default: gpt-4o) // FOUNDRY_AGENT_TOOLSET_ENDPOINT - Foundry Toolsets proxy base URL // (injected automatically by Foundry platform at runtime) // // Optional: // FOUNDRY_TOOLBOX_NAME - Name of the toolset to load (default: my-toolset) // FOUNDRY_AGENT_NAME - Client name reported to MCP server // FOUNDRY_AGENT_VERSION - Client version reported to MCP server // FOUNDRY_AGENT_TOOLSET_FEATURES - Feature flags sent to Foundry proxy via header using Azure.AI.Projects; using Azure.Core; using Azure.Identity; using DotNetEnv; using Hosted_Shared_Contributor_Setup; using Microsoft.Agents.AI; using Microsoft.Agents.AI.Foundry.Hosting; // 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"; string toolboxName = Environment.GetEnvironmentVariable("FOUNDRY_TOOLBOX_NAME") ?? "my-toolset"; // 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()); // ── Create agent ───────────────────────────────────────────────────────────── AIAgent agent = new AIProjectClient(new Uri(endpoint), credential) .AsAIAgent( model: deploymentName, instructions: """ You are a helpful assistant with access to tools provided by the Foundry Toolset. Use the available tools to answer user questions. If a tool is not available for a request, let the user know clearly. """, name: Environment.GetEnvironmentVariable("AGENT_NAME") ?? "hosted-toolbox-agent", description: "Hosted agent backed by Foundry Toolset MCP tools"); // ── Build the host ──────────────────────────────────────────────────────────── var builder = WebApplication.CreateBuilder(args); // Register the agent and response handler builder.Services.AddFoundryResponses(agent); builder.Services.AddDevTemporaryLocalContributorSetup(); // Local Docker debugging only - must not be used in production. // Register Foundry Toolbox: connects to the MCP proxy at startup and makes tools available. // The toolset name must match a toolset registered in your Foundry project. // When FOUNDRY_AGENT_TOOLSET_ENDPOINT is absent (e.g., in local development without Foundry // infrastructure), startup succeeds without error and no toolbox tools are loaded. builder.Services.AddFoundryToolboxes(toolboxName); var app = builder.Build(); app.MapFoundryResponses(); // Contributor-only: in Development, also map the per-agent OpenAI route shape that live Foundry uses // so a local REPL client can target this server via AIProjectClient.AsAIAgent(Uri agentEndpoint). // Do not use this in production. Hosted Foundry agents only support the agent-endpoint path. app.MapDevTemporaryLocalAgentEndpoint(); app.Run(); // ── DevTemporaryTokenCredential ───────────────────────────────────────────────