Samouczek: Budowa aplikacji agenta internetowego w usłudze Azure App Service z wykorzystaniem Microsoft Agent Framework lub Foundry Agent Service (.NET)

Element AgentFrameworkProvider jest inicjowany w Usługach/AgentFrameworkProvider.cs. Kod inicjowania wykonuje następujące czynności:

• Tworzy element IChatClient z usługi Azure OpenAI przy użyciu AzureOpenAIClient.
• TaskCrudTool Pobiera wystąpienie, które hermetyzuje funkcjonalność aplikacji CRUD (w Narzędzia/TaskCrudTool.cs). Atrybuty Description metod narzędzi pomagają agentowi określić sposób ich wywoływania.
• Tworzy agenta sztucznej inteligencji przy użyciu CreateAIAgent(), z instrukcjami i narzędziami zarejestrowanymi za pośrednictwem AIFunctionFactory.Create().
• Tworzy wątek dla agenta w celu utrwalania konwersacji podczas nawigacji.

// 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);

Za każdym razem, gdy użytkownik wysyła komunikat, składnik Blazor (w Components/Pages/AgentFrameworkAgent.razor) wywołuje Agent.RunAsync() z wejściem użytkownika i wątkiem agenta. Wątek agenta monitoruje historię czatu.

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

Dostawca FoundryAgentProvider jest inicjowany w Services/FoundryAgentProvider.cs. Kod inicjowania wykonuje następujące czynności:

• Tworzy obiekt AIProjectClient przy użyciu punktu końcowego projektu Foundry.
• Pobiera istniejącego agenta z Microsoft Foundry po nazwie.
• Tworzy konwersację dla sesji przeglądarki.
• Pobiera ProjectResponsesClient dla agenta i konwersacji.

// 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);

Ten kod inicjowania nie definiuje żadnych funkcji agenta, ponieważ zwykle kompilujesz agenta w portalu Foundry. W ramach przykładowego scenariusza jest ona również zgodna ze wzorcem interfejsu OpenAPI pokazanym w artykule Dodawanie aplikacji usługi App Service jako narzędzia w usłudze Agent Platformy Foundry (.NET) i udostępnia funkcję CRUD jako punkt końcowy interfejsu OpenAPI. Dzięki temu można dodać go do agenta później jako narzędzie do wywołania.

Kod OpenAPI jest zdefiniowany w Program.cs. Na przykład interfejs API "get tasks" definiuje identyfikator operacji przy pomocy funkcji WithName(), zgodnie z wymaganiami specyfikacji OpenAPI w narzędziu Microsoft Foundry, oraz WithDescription() pomaga agentowi określić sposób wywoływania interfejsu API.

app.MapOpenApi();

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

Za każdym razem, gdy użytkownik wysyła komunikat, składnik Blazor (w pliku Components/Pages/FoundryAgent.razor) wywołuje funkcję ResponseClient.CreateResponseAsync() z danymi wejściowymi użytkownika. Klient odpowiedzi używa identyfikatora konwersacji, aby śledzić historię czatów.

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

1. W portalu Foundry upewnij się, że górny przycisk radiowy New Foundry jest ustawiony na aktywny i utwórz projekt.

2. Wdróż wybrany model (zobacz Przewodnik Szybki start firmy Microsoft Foundry: tworzenie zasobów).

3. W górnej części placu zabaw modelu skopiuj nazwę modelu.

4. Najłatwiejszym sposobem na uzyskanie punktu końcowego Azure OpenAI jest wciąż skorzystanie z klasycznego portalu. Wybierz przycisk radiowy New Foundry, następnie pozycję Azure OpenAI, a potem skopiuj adres URL z punktu końcowego usługi Azure OpenAI na później.

   

1. W portalu Foundry upewnij się, że górny przycisk radiowy New Foundry jest ustawiony na aktywny i utwórz projekt.

2. Na stronie głównej skopiuj punkt końcowy projektu do późniejszego użycia.

3. Wybierz pozycję Rozpocznij tworzenie>agenta i postępuj zgodnie z monitem.

4. Na placu zabaw nowego agenta utwórz narzędzie OpenAPI do wywołania aplikacji internetowej, wybierając Narzędzia>Dodaj>własne>narzędzie OpenAPI>Utwórz. W okienku Konfiguracja dodaj akcję za pomocą narzędzia specyfikacji interfejsu OpenAPI. Użyj schematu OpenAPI pobranego z wdrożonej aplikacji internetowej i uwierzytelniania anonimowego . Aby uzyskać szczegółowe instrukcje, zobacz How to use the OpenAPI spec tool (Jak używać narzędzia specyfikacji Interfejsu OpenAPI).

   Kod aplikacji jest już skonfigurowany do uwzględnienia serwerów url i operationId, które są wymagane przez agenta. Aby uzyskać więcej informacji, zobacz Connect to OpenAPI Specification.

5. Pamiętaj, aby wybrać pozycję Zapisz.

6. Wybierz Wypróbuj w środowisku testowym i przetestuj agenta Foundry z poleceniami, takimi jak "Pokaż mi wszystkie zadania" i "Dodaj zadanie".

   Jeśli otrzymasz prawidłową odpowiedź, agent wykonuje wywołania narzędzi do punktu końcowego interfejsu OpenAPI w wdrożonej aplikacji internetowej.

1. W górnym menu nowego portalu Foundry wybierz pozycję Obsługa, a następnie wybierz pozycję Administrator. W wierszu projektu Foundry powinny zostać wyświetlone dwa linki. Element w kolumnie Name to zasób projektu Foundry, a ten w kolumnie Zasób nadrzędny to zasób Foundry.

   

2. Wybierz zasób Foundry w zasobie nadrzędnym , a następnie wybierz pozycję Zarządzaj tym zasobem w witrynie Azure Portal. W witrynie Azure Portal możesz przypisać dostęp oparty na rolach dla zasobu do wdrożonej aplikacji internetowej.

3. Dodaj następującą rolę dla zarządzanej tożsamości aplikacji App Service:

   Zasób docelowy	Wymagana rola	Wymagane do
   Odlewnia	Użytkownik Usług Cognitive Services OpenAI	Usługa uzupełniania czatu w programie Microsoft Agent Framework.

   Aby uzyskać instrukcje, zobacz temat Przypisywanie ról platformy Azure za pomocą witryny Azure Portal.

1. W górnym menu nowego portalu Foundry wybierz pozycję Obsługa, a następnie wybierz pozycję Administrator. W wierszu projektu Foundry powinny zostać wyświetlone dwa linki. Element w kolumnie Name to zasób projektu Foundry, a ten w kolumnie Zasób nadrzędny to zasób Foundry.

   

2. Wybierz zasób projektu Foundry w kolumnie Nazwa , a następnie wybierz pozycję Zarządzaj tym zasobem w witrynie Azure Portal. W witrynie Azure Portal możesz przypisać dostęp oparty na rolach dla zasobu do wdrożonej aplikacji internetowej.

3. Dodaj następującą rolę dla zarządzanej tożsamości aplikacji App Service:

   Zasób docelowy	Wymagana rola	Wymagane do
   Projekt odlewniczy	Użytkownik sztucznej inteligencji platformy Azure	Odczytywanie i wywoływanie agenta usługi Foundry.

   Aby uzyskać instrukcje, zobacz temat Przypisywanie ról platformy Azure za pomocą witryny Azure Portal.