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
..

Bing Custom Search with the Responses API

This sample shows how to use the Bing Custom Search tool with a ChatClientAgent using the Responses API directly.

What this sample demonstrates

  • Configuring BingCustomSearchToolParameters with connection ID and instance name
  • Using FoundryAITool.CreateBingCustomSearchTool() with ChatClientAgent
  • Processing search results from agent responses

Prerequisites

  • .NET 10 SDK or later
  • Microsoft Foundry service endpoint and deployment configured
  • An authenticated Azure identity (for example, sign in with az login)
  • Bing Custom Search resource configured with a connection ID

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"
$env:AZURE_AI_CUSTOM_SEARCH_CONNECTION_ID="your-connection-id"  # The full ARM resource URI, e.g., "/subscriptions/.../connections/your-bing-connection"
$env:AZURE_AI_CUSTOM_SEARCH_INSTANCE_NAME="your-instance-name"  # The Bing Custom Search configuration name (from Azure portal)

Finding the connection ID and instance name

  • Connection ID (AZURE_AI_CUSTOM_SEARCH_CONNECTION_ID): The full ARM resource URI including the /projects/<name>/connections/<connection-name> segment. Find the connection name in your Foundry project under Management centerConnected resources.
  • Instance Name (AZURE_AI_CUSTOM_SEARCH_INSTANCE_NAME): The configuration name from your Bing Custom Search resource (Azure portal → your Bing Custom Search resource → Configurations). This is not the Azure resource name or the connection name — it's the name of the specific search configuration that defines which domains/sites to search against.

Run the sample

dotnet run