agent-framework/dotnet/samples/02-agents/AgentsWithFoundry/Agent_Step02.2_MultiturnWithServerConversations

Multi-turn Conversation with Server-Side Conversations

This sample demonstrates how to use server-side conversations with a FoundryAgent. Server-side conversations persist on the Foundry service and are visible in the Foundry Project UI, making them ideal when you need conversation history to be stored and accessible server-side.

What this sample demonstrates

• Creating a FoundryAgent with instructions
• Using CreateConversationSessionAsync to create a server-side ProjectConversation
• Multi-turn conversations with both text and streaming output
• Server-side conversation persistence visible in the Foundry Project UI

Prerequisites

Before you begin, ensure you have the following prerequisites:

• .NET 10 SDK or later
• Microsoft Foundry service endpoint and deployment configured
• Azure CLI installed and authenticated (for Azure credential authentication)

Note: This demo uses Azure CLI credentials for authentication. Make sure you're logged in with az login and have access to the Microsoft Foundry resource. For more information, see the Azure CLI documentation.

Set the following environment variables:

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

Run the sample

Navigate to the AgentsWithFoundry sample directory and run:

cd dotnet/samples/02-agents/AgentsWithFoundry
dotnet run --project .\Agent_Step02.2_MultiturnWithServerConversations