generative-ui-foundry-hosted-agents: Skill for Claude Code

Skill: Author a MAF agent for Foundry Hosted Agents (AG-UI)

This skill captures the validated best-practice pattern for building a Microsoft Agent Framework (.NET) agent that runs as a Foundry Hosted Agent and serves the AG-UI protocol over the platform's invocations endpoint.

When to use

• Creating a new .NET agent to host on Foundry that must drive a CopilotKit / AG-UI frontend (generative UI, shared state, human-in-the-loop).
• Refactoring an agent off the community AGUI.Server / raw IChatClient / custom invocation handler onto the official MAF AG-UI hosting stack.
• Reviewing such an agent for correctness before registering a hosted version.

The pattern (do exactly this)

1. Packages (.csproj, Microsoft.NET.Sdk.Web, net10.0)

<PackageReference Include="Microsoft.Agents.AI.OpenAI" Version="1.13.0" />
<PackageReference Include="Microsoft.Agents.AI.Hosting.AGUI.AspNetCore" Version="1.13.0-preview.260703.1" />
<PackageReference Include="Microsoft.Agents.AI.Hosting.AspNetCore" Version="1.13.0-preview.260703.1" />
<PackageReference Include="Azure.AI.OpenAI" Version="2.9.0-beta.1" />
<PackageReference Include="Azure.Identity" Version="1.13.1" />

Do not include AGUI.Server, AGUI.Abstractions, Azure.AI.AgentServer.Invocations, or a standalone Microsoft.Extensions.AI pin — the hosting packages bring what you need.

2. Program.cs

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddHttpClient();
builder.Services.AddAGUI();

var endpoint = new Uri(builder.Configuration["AZURE_OPENAI_ENDPOINT"]!);
var deployment = builder.Configuration["MODEL_DEPLOYMENT_NAME"] ?? "model-router";

AITool[] tools =
[
    AIFunctionFactory.Create(dataTools.QueryData, "query_data"),
    AIFunctionFactory.Create(dataTools.ManageTodos, "manage_todos"),
];

AIAgent agent = new AzureOpenAIClient(endpoint, new DefaultAzureCredential())
    .GetChatClient(deployment)
    .AsIChatClient()                 // REQUIRED: .AsAIAgent is an IChatClient extension
    .AsAIAgent(instructions: SystemPrompt, name: "analytics-agent", tools: tools);

var app = builder.Build();
app.MapAGUI("/invocations", agent);  // Foundry Hosted Agent path
app.MapAGUI("/", agent);             // local / direct AG-UI clients
app.MapGet("/readiness", () => Results.Ok(new { status = "ready" }));
app.Run();