Files
Ben Thomas c79f886dc3 .NET: Align Foundry sample environment variables and credentials. (#6422)
* dotnet: refresh Foundry sample guidance

Carry forward the still-relevant sample guidance and Foundry-specific documentation fixes from the old stacked sample migration work, adapted to the current repo layout and policy.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* dotnet: rename Foundry sample env vars

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* dotnet: remove persistent provider sample

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* dotnet: drop SAMPLE_GUIDELINES.md from this PR

Defer the guidelines doc and its cross-link to a follow-on PR to avoid broken-link failures in CI.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* dotnet: add DefaultAzureCredential warning to remaining samples

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* dotnet: address PR review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
c79f886dc3 ยท 2026-06-11 17:26:00 +00:00
History
..

Foundry Toolbox via MCP

This sample shows how to use a Foundry Toolbox by pointing an McpClient at the toolbox's MCP endpoint. The agent discovers the toolbox's tools at runtime and invokes them locally over MCP.

What this sample demonstrates

  • Connecting to a Foundry toolbox's MCP endpoint via Streamable HTTP transport
  • Injecting a fresh Azure AI bearer token (https://ai.azure.com/.default) on every MCP request
  • Passing the discovered MCP tools to AIProjectClient.AsAIAgent(...)
  • Optional helper to create (or replace) a sample toolbox in the project so the sample is runnable end-to-end

Prerequisites

  • A Microsoft Foundry project with a toolbox configured (or let the sample create one for you)
  • An authenticated Azure identity (for example, sign in with az login)

Set the following environment variables:

$env:FOUNDRY_PROJECT_ENDPOINT="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project"
$env:FOUNDRY_MODEL="gpt-5.4-mini"

The sample creates a toolbox named research_toolbox in your Foundry project on startup, then connects to its MCP endpoint at {FOUNDRY_PROJECT_ENDPOINT}/toolboxes/research_toolbox/mcp?api-version=v{version}.

Run the sample

dotnet run