Tutorial: Construa uma aplicação web agente no Azure App Service com Microsoft Agent Framework ou Foundry Agent Service (.NET)

O AgentFrameworkProvider é inicializado em Services/AgentFrameworkProvider.cs. O código de inicialização faz o seguinte:

• Cria um IChatClient a partir do serviço Azure OpenAI utilizando o AzureOpenAIClient.
• Obtém a TaskCrudTool instância que encapsula a funcionalidade da aplicação CRUD (em Tools/TaskCrudTool.cs). Os Description atributos dos métodos da ferramenta ajudam o agente a determinar como chamá-los.
• Cria um agente de IA usando CreateAIAgent() instruções e ferramentas registadas via AIFunctionFactory.Create().
• Cria uma thread para o agente manter a conversa através da navegação.

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

Cada vez que o utilizador envia uma mensagem, o componente Blazor (em Components/Pages/AgentFrameworkAgent.razor) chama Agent.RunAsync() com a entrada do utilizador e a thread do agente. O segmento do agente mantém o registo do histórico de bate-papo.

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

O FoundryAgentProvider provedor é inicializado em Serviços/FoundryAgentProvider.cs. O código de inicialização faz o seguinte:

• Cria um AIProjectClient usando o endpoint do projeto Foundry.
• Obtém um agente existente da Microsoft Foundry pelo nome especificado.
• Cria uma conversa para a sessão do navegador.
• Recebe uma ProjectResponsesClient resposta para o agente e para a conversa.

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

Este código de inicialização não define qualquer funcionalidade para o agente, porque normalmente construiria o agente no portal Foundry. Como parte do cenário de exemplo, segue também o padrão OpenAPI apresentado em Adicionar uma aplicação do Serviço de Aplicações como ferramenta no Foundry Agent Service (.NET), e disponibiliza a sua funcionalidade CRUD como um ponto de extremidade OpenAPI. Isso permite adicioná-lo ao agente mais tarde como uma ferramenta invocável.

O código OpenAPI é definido em Program.cs. Por exemplo, a API "get tasks" define o ID da operação com WithName(), conforme exigido pela ferramenta de especificação OpenAPI no Microsoft Foundry, e WithDescription() ajuda o agente a determinar como chamar a API:

app.MapOpenApi();

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

Cada vez que o utilizador envia uma mensagem, o componente Blazor (em Components/Pages/FoundryAgent.razor) chama ResponseClient.CreateResponseAsync() com a entrada do utilizador. O cliente de resposta usa o ID da conversa para acompanhar o histórico da conversa.

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

1. No portal da Foundry, certifique-se de que o botão de radio superior da New Foundry está ativado e crie um projeto.

2. Implemente um modelo à sua escolha (veja Microsoft Foundry Quickstart: Criar recursos).

3. Do topo do parque de diversões de modelos, copie o nome do modelo.

4. A forma mais fácil de obter o endpoint Azure OpenAI continua a ser através do portal clássico. Selecione o botão de opção New Foundry, depois Azure OpenAI, e depois copie o URL no Azure OpenAI endpoint para mais tarde.

   

1. No portal da Foundry, certifique-se de que o botão de radio superior da New Foundry está ativado e crie um projeto.

2. Na página inicial, copie o endpoint do Projeto para usar mais tarde.

3. Selecione Começar a construir>Criar agente e siga o prompt.

4. Na área de teste do novo agente, crie uma ferramenta personalizada OpenAPI para chamar a sua aplicação web selecionando Ferramentas>Adicionar>ferramenta personalizada OpenAPI>>Criar. No painel Configuração , adicione uma ação com a ferramenta de especificação OpenAPI. Use o esquema OpenAPI que você obtém do aplicativo Web implantado e da autenticação anônima . Para obter etapas detalhadas, consulte Como usar a ferramenta de especificação OpenAPI.

   O código da aplicação já está configurado para incluir o url e o operationId do servidor, que são necessários para o agente. Para mais informações, consulte Ligar à Especificação OpenAPI.

5. Certifica-te de selecionar Guardar.

6. Selecione Experimentar no playground e teste o seu agente Foundry com prompts como "Mostra-me todas as tarefas" e "Por favor, adiciona uma tarefa."

   Se receber uma resposta válida, o agente está a fazer solicitações para o endpoint OpenAPI na sua aplicação web implantada.

1. No menu superior do novo portal da Foundry, selecione Operar, depois selecione Administrador. Na fila do seu projeto Foundry, deve ver dois links. O que está na coluna Nome é o recurso do projeto Foundry, e o que está na coluna Recurso Pai é o recurso Foundry.

   

2. Selecione o recurso Foundry no recurso Pai e depois selecione Gerir este recurso no portal Azure. A partir do portal Azure, pode atribuir acesso baseado em funções para o recurso à aplicação web implementada.

3. Adicione o seguinte papel para a identidade gerida da aplicação App Service:

   Recurso de destino	Função obrigatória	Necessário para
   Fundição	Utilizador dos Serviços Cognitivos OpenAI	O serviço de conclusão de chat no Microsoft Agent Framework.

   Para obter instruções, consulte Atribuir funções do Azure utilizando o portal do Azure.

1. No menu superior do novo portal da Foundry, selecione Operar, depois selecione Administrador. Na fila do seu projeto Foundry, deve ver dois links. O elemento na coluna Nome é o recurso do projeto Foundry, e o elemento na coluna Recurso Pai é o recurso Foundry.

   

2. Selecione o recurso do projeto Foundry na coluna Nome e depois selecione Gerir este recurso no portal Azure. A partir do portal Azure, pode atribuir acesso baseado em funções para o recurso à aplicação web implementada.

3. Adicione o seguinte papel para a identidade gerida da aplicação App Service:

   Recurso de destino	Função obrigatória	Necessário para
   Projeto Foundry	Utilizador do Azure AI	A ler e a ligar para o agente da Foundry.

   Para obter instruções, consulte Atribuir funções do Azure utilizando o portal do Azure.