Criar agentes .NET no Visual Studio através do Toolkit de Agentes do Microsoft 365

Neste artigo, aprenda a criar um novo projeto SDK de Agentes .NET no Visual Studio, através do Toolkit de Agentes do Microsoft 365.

Pré-requisitos

• Instale a extensão do Toolkit de Agentes para Visual Studio para o Visual Studio.

• Um modelo Azure OpenAI do Azure AI Foundry portal Precisa dos seguintes dados sobre o modelo:

  • Nome
  • URI de Destino
  • Chave

Criar um novo projeto

O Toolkit de Agentes oferece um modelo de projeto para ajudar o Utilizador a começar a criar um agente. Pode começar a partir de um modelo no toolkit ou de exemplos no SDK de Agentes. Este documento foca-se nos modelos disponíveis no Toolkit de Agentes. Existem vários modelos e opções disponíveis para criar projetos do SDK de Agentes com o toolkit. Este guia foca-se na criação de um Agente de Meteorologia através do Kernel Semântico e o Azure AI Foundry.

1. Abra o Visual Studio e selecione Criar um novo projeto. Procure por "agente" para encontrar novos modelos através do Toolkit de Agentes do Microsoft 365 e o SDK de Agentes. Selecione Agentes do Microsoft 365>Seguinte.

   

   Será apresentado um diálogo para que possa nomear o agente. Também pode alterar a localização e o nome da solução, se quiser.

2. Quando tiver terminado, selecione Criar

   

   Pode escolher entre várias opções que o toolkit disponibiliza para criar agentes.

3. Para este passo a passo, selecione o exemplo Agente de Meteorologia>Seguinte para utilizar o SDK de Agentes do Microsoft 365. Este exemplo pré-criado implementa o Kernel Semântico para orquestração com modelos do Azure AI Foundry ou do Azure OpenAI. Também pode utilizar o exemplo de agente vazio caso pretenda começar sem um modelo ou orquestrador.

   

   

   Um diálogo pede-lhe que escolha o serviço LLM.

4. Para este passo a passo, selecione Azure OpenAI.

   Esta informação pode ser encontrada no Azure AI Foundry em Modelos e pontos finais.

   

5. Preencha os dados necessários: chave do Azure OpenAI Service, ponto final do Azure OpenAI e nome de implementação do Azure OpenAI.

6. Selecione Criar. O toolkit cria o projeto a partir de um modelo automaticamente.

7. Em pouco tempo, deverá ter um novo projeto criado usando o SDK de Agentes.

   

Testar o agente no Ambiente de Demonstração de Agentes do Microsoft 365

Para começar, pode testar localmente usando o Ambiente de Demonstração de Agentes do Microsoft 365 no Toolkit.

Para começar a testar, defina o destino de depuração do seu projeto para ser o Ambiente de Demonstração de Agentes do Microsoft 365.

O ambiente de demonstração é aberto para o testar numa nova janela do browser com o seu anfitrião local e mostra o ambiente de demonstração com o mesmo pronto a testar. Comece a enviar mensagens ao seu agente para testar o comportamento.

Depure e teste o seu agente no Microsoft Teams ou no Microsoft 365 Copilot

Também pode definir o destino de depuração diretamente no Microsoft Teams ou no Microsoft 365 Copilot.

1. Selecione uma das opções de depuração como destino de depuração na lista de destinos.

   

   Leva alguns instantes a mudar para o Microsoft Teams. É-lhe pedido que adicione o seu agente no cliente do Teams que é aberto.

   

2. Selecione Adicionar. É apresentado um painel de notificação, a indicar que o agente foi adicionado com êxito.

   

3. Selecione Abrir no seu novo agente para o abrir no Teams. Pode fazer perguntas ao seu agente, diretamente no Teams. Pode definir pontos de interrupção para trabalhar na depuração da sua experiência quando necessário.

   

Resumo

Executou agora com êxito:

• Começar um novo projeto de Agentes do Microsoft 365 usando o Toolkit de Agentes
• Testar o agente localmente através do Ambiente de Demonstração de Agentes do Microsoft 365
• Implementou o agente para depuração diretamente no canal do Teams ou no canal do Microsoft 365