Files
Roger Barreto 9a47620f64 .NET: Update Hosted Samples References to latest beta.11 (#4853)
* Bump HostedAgents samples to AgentFramework beta.11 and pass credential to UseFoundryTools

Update all 8 HostedAgents samples:
- Azure.AI.AgentServer.AgentFramework -> 1.0.0-beta.11
- Microsoft.Agents.AI.OpenAI -> 1.0.0-rc4
- Microsoft.Agents.AI/AzureAI/Workflows -> 1.0.0-rc4
- Azure.AI.Projects -> 2.0.0-beta.1
- Fix Workflow.AsAgent() -> AsAIAgent() in FoundryMultiAgent
- Pass credential to UseFoundryTools in AgentWithTools (resolves #56802)

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

* Remove AgentWithTools sample (UseFoundryTools no longer supported)

Remove the AgentWithTools hosted agent sample as the UseFoundryTools
backend is no longer supported. Updated HostedAgents README and solution
file to remove all references.

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

* Fix AgentWithHostedMCP: downgrade Azure.AI.OpenAI to 2.8.0-beta.1 for rc4 compatibility

Azure.AI.OpenAI 2.9.0-beta.1 has breaking changes (GetResponsesClient no
longer accepts deployment name, ResponsesClient.Model removed) that are
incompatible with Microsoft.Agents.AI.OpenAI rc4. Pin to 2.8.0-beta.1 and
use GetResponsesClient(deploymentName).AsAIAgent() pattern.

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

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
9a47620f64 · 2026-03-23 17:41:49 +00:00
History
..

What this sample demonstrates

This sample demonstrates how to build a hosted agent that uses local C# function tools — a key advantage of code-based hosted agents over prompt agents. The agent acts as a Seattle travel assistant with a GetAvailableHotels tool that simulates querying a hotel availability API.

Key features:

  • Defining local C# functions as agent tools using AIFunctionFactory
  • Using AIProjectClient to discover the OpenAI connection from the Azure AI Foundry project
  • Building a ChatClientAgent with custom instructions and tools
  • Deploying to the Foundry Hosted Agent service

For common prerequisites and setup instructions, see the Hosted Agent Samples README.

Prerequisites

Before running this sample, ensure you have:

  1. .NET 10 SDK installed
  2. An Azure AI Foundry Project with a chat model deployed (e.g., gpt-4o-mini)
  3. Azure CLI installed and authenticated (az login)

Environment Variables

Set the following environment variables:

# Replace with your Azure AI Foundry project endpoint
$env:AZURE_AI_PROJECT_ENDPOINT="https://your-project.services.ai.azure.com/api/projects/your-project-name"

# Optional, defaults to gpt-4o-mini
$env:MODEL_DEPLOYMENT_NAME="gpt-4o-mini"

How It Works

  1. The agent uses AIProjectClient to discover the Azure OpenAI connection from the project endpoint
  2. A local C# function GetAvailableHotels is registered as a tool using AIFunctionFactory.Create
  3. When users ask about hotels, the model invokes the local tool to search simulated hotel data
  4. The tool filters hotels by price and calculates total costs based on the requested dates
  5. Results are returned to the model, which presents them in a conversational format