Lernprogramm: Erstellen einer agentischen Web-App in Azure App Service mit Microsoft Agent Framework oder Foundry Agent Service (.NET)

Die AgentFrameworkProvider Initialisierung erfolgt in Services/AgentFrameworkProvider.cs. Der Initialisierungscode führt folgendes aus:

• Erstellt eine IChatClient aus Azure OpenAI mithilfe der AzureOpenAIClient.
• Ruft die TaskCrudTool Instanz ab, die die Funktionalität der CRUD-Anwendung (in Tools/TaskCrudTool.cs) kapselt. Die Description Attribute der Toolmethoden helfen dem Agent zu bestimmen, wie sie aufgerufen werden.
• Erstellt einen KI-Agent mithilfe von CreateAIAgent() mit Anweisungen und Tools, die über AIFunctionFactory.Create() registriert werden.
• Erstellt einen Thread für den Agenten, um den Dialog über die Navigation hinweg aufrechtzuerhalten.

// Create IChatClient
IChatClient chatClient = new AzureOpenAIClient(
        new Uri(endpoint),
        new DefaultAzureCredential())
    .GetChatClient(deployment)
    .AsIChatClient();

// Get TaskCrudTool instance from service provider
var taskCrudTool = sp.GetRequiredService<TaskCrudTool>();

// Create agent with tools
var agent = chatClient.CreateAIAgent(
    instructions: @"You are an agent that manages tasks using CRUD operations. 
        Use the provided functions to create, read, update, and delete tasks. 
        Always call the appropriate function for any task management request.
        Don't try to handle any requests that are not related to task management.
        When handling requests, if you're missing any information, don't make it up but prompt the user for it instead.",
    tools:
    [
        AIFunctionFactory.Create(taskCrudTool.CreateTaskAsync),
        AIFunctionFactory.Create(taskCrudTool.ReadTasksAsync),
        AIFunctionFactory.Create(taskCrudTool.UpdateTaskAsync),
        AIFunctionFactory.Create(taskCrudTool.DeleteTaskAsync)
    ]);

// Create thread for this scoped instance (persists across navigation)
var thread = agent.GetNewThread();

return (agent, thread);

Jedes Mal, wenn der Benutzer eine Nachricht sendet, ruft die Blazor-Komponente (in Components/Pages/AgentFrameworkAgent.razor) Agent.RunAsync() mit der Benutzereingabe und dem Agentthread auf. Der Agentthread verfolgt den Chatverlauf.

var response = await this.Agent.RunAsync(sentInput, this.agentThread);

Der FoundryAgentProvider Anbieter wird in Services/FoundryAgentProvider.cs initialisiert. Der Initialisierungscode führt folgendes aus:

• Erstellt ein AIProjectClient unter Verwendung des Foundry-Projektendpunkts.
• Ruft einen vorhandenen Agent von Microsoft Foundry anhand des Namens ab.
• Erstellt eine Konversation für die Browsersitzung.
• Erhält ein ProjectResponsesClient für den Agent und die Kommunikation.

// Create project client
var projectClient = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential());

// Get an existing agent from Microsoft Foundry
var agent = projectClient.Agents.GetAgent(agentName);

// Get conversations client for retrieving history
var conversationsClient = projectClient.OpenAI.Conversations;

// Create conversation for this browser session
var conversation = conversationsClient.CreateProjectConversation().Value;

// Get response client for this agent and conversation
var responseClient = projectClient.OpenAI.GetProjectResponsesClientForAgent(agentName, conversation.Id);

return (responseClient, conversation, conversationsClient);

Dieser Initialisierungscode definiert keine Funktionen für den Agent, da Sie normalerweise den Agent im Foundry-Portal erstellen würden. Im Rahmen des Beispielszenarios folgt es auch dem OpenAPI-Muster, das in add an App Service app as a tool in Foundry Agent Service (.NET) dargestellt wird, und stellt seine CRUD-Funktionalität als OpenAPI-Endpunkt zur Verfügung. Auf diese Weise können Sie ihn später als aufrufbares Tool dem Agent hinzufügen.

Der OpenAPI-Code wird in Program.cs definiert. Zum Beispiel definiert die API „Aufgaben abrufen“ die Vorgangs-ID mit WithName(), wie vom OpenAPI-Spezifikationstool in Microsoft Foundry gefordert, und WithDescription() unterstützt den Agenten dabei, zu bestimmen, wie die API aufgerufen wird:

app.MapOpenApi();

app.MapGet("/api/tasks", async (TaskService taskService) =>
{
    return Results.Ok(await taskService.GetAllTasksAsync());
})
.WithDescription("Gets all tasks.")
.WithName("GetAllTasks");

Jedes Mal, wenn der Benutzer eine Nachricht sendet, ruft die ResponseClient.CreateResponseAsync()) mit der Benutzereingabe auf. Der Antwortclient verwendet die Unterhaltungs-ID, um den Chatverlauf nachzuverfolgen.

#pragma warning disable OPENAI001
var response = await FoundryProvider.ResponseClient.CreateResponseAsync(sentInput);
#pragma warning restore OPENAI001

1. Vergewissern Sie sich im Foundry-Portal, dass die obere Neue Foundry-Schaltfläche auf aktiv festgelegt ist und erstellen Sie ein Projekt.

2. Stellen Sie ein Modell Ihrer Wahl bereit (siehe Schnellstart von Microsoft Foundry: Erstellen von Ressourcen).

3. Kopieren Sie den Namen des Modells aus dem oberen Bereich des Modell-Playrounds.

4. Die einfachste Möglichkeit zum Abrufen des Azure OpenAI-Endpunkts ist noch aus dem klassischen Portal. Wählen Sie die Schaltfläche Neues Foundry, dann Azure OpenAI und kopieren Sie die URL in Azure OpenAI Endpunkt für später.

   

1. Vergewissern Sie sich im Foundry-Portal, dass die obere Neue Foundry-Schaltfläche auf aktiv festgelegt ist und erstellen Sie ein Projekt.

2. Kopieren Sie auf der Startseite den Project-Endpunkt für einen späteren Zeitpunkt.

3. Wählen Sie "Beginnen Sie mit dem Erstellen>von Agenten" aus, und folgen Sie der Eingabeaufforderung.

4. Erstellen Sie im Playground des neuen Agents ein OpenAPI-Tool, um Ihre Web-App aufzurufen, indem Sie tools>Add>Custom>OpenAPI tool>Create auswählen. Fügen Sie im Setupbereich eine Aktion mit dem OpenAPI-Spezifikationstool hinzu. Verwenden Sie das OpenAPI-Schema, das Sie aus der bereitgestellten Web-App und der anonymen Authentifizierung erhalten. Ausführliche Schritte finden Sie unter Verwenden des OpenAPI-Spezifikationstools.

   Ihr Anwendungscode ist bereits so konfiguriert, dass er die url und operationId des Servers einbindet, die vom Agent benötigt werden. Weitere Informationen finden Sie unter Connect to OpenAPI Specification.

5. Wählen Sie " Speichern" aus.

6. Wählen Sie "In Playground testen" aus, und testen Sie Ihren Foundry-Agent mit Eingabeaufforderungen wie "Alle Aufgaben anzeigen" und "Bitte fügen Sie eine Aufgabe hinzu".

   Wenn Sie eine gültige Antwort erhalten, sendet der Agent Toolaufrufe an den OpenAPI-Endpunkt in Ihrer bereitgestellten Web-App.

1. Wählen Sie im oberen Menü des neuen Gießereiportals "Betreiben" und dann "Administrator" aus. In der Zeile für Ihr Foundry-Projekt sollten zwei Links angezeigt werden. Die Ressource in der Spalte "Name" ist die Foundry-Projektressource, und die Ressource in der Spalte "Übergeordnete Ressource" ist die Foundry-Ressource.

   

2. Wählen Sie die Foundry-Ressource in der übergeordneten Ressource aus, und wählen Sie dann im Azure-Portal "Diese Ressource verwalten" aus. Im Azure-Portal können Sie der bereitgestellten Web-App rollenbasierten Zugriff für die Ressource zuweisen.

3. Fügen Sie die folgende Rolle für die verwaltete Identität der App-Service-App hinzu.

   Zielressource	Erforderliche Rolle	Erforderlich für
   Gießerei	Kognitive Dienste OpenAI-Nutzer	Der Chatabschlussdienst in Microsoft Agent Framework.

   Anweisungen hierzu finden Sie unter Zuweisen von Azure-Rollen über das Azure-Portal.

1. Wählen Sie im oberen Menü des neuen Gießereiportals "Betreiben" und dann "Administrator" aus. In der Zeile für Ihr Foundry-Projekt sollten zwei Links angezeigt werden. Die Ressource in der Spalte Name ist die Projektressource von Foundry, und die Ressource in der Spalte Übergeordnete Ressource ist die Foundry-Ressource.

   

2. Wählen Sie die Ressource "Foundry"-Projekt in der Spalte "Name " und dann im Azure-Portal "Diese Ressource verwalten" aus. Im Azure-Portal können Sie der bereitgestellten Web-App rollenbasierten Zugriff für die Ressource zuweisen.

3. Fügen Sie die folgende Rolle für die verwaltete Identität der App Service-Anwendung hinzu:

   Zielressource	Erforderliche Rolle	Erforderlich für
   Gießerei-Projekt	Azure AI-Benutzer	Lesen und Aufrufen des Foundry-Agents.

   Anweisungen hierzu finden Sie unter Zuweisen von Azure-Rollen über das Azure-Portal.