Criar agentes .NET no Visual Studio usando o Kit de Ferramentas de Agentes do Microsoft 365

Neste artigo, você saberá como criar um novo projeto .NET do SDK de Agentes no Visual Studio, usando o Kit de Ferramentas de Agentes do Microsoft 365.

Pré-requisitos

• Instale a extensão Kit de Ferramentas de Agentes para Visual Studio para Visual Studio.

• Um modelo do OpenAI do Azure do portal do Fábrica de IA do Azure. Você precisa dos seguintes dados sobre o modelo:

  • Nome
  • URI de Destino
  • Chave

Criar um projeto

O Agents Toolkit oferece um modelo de projeto para ajudar você a iniciar a criação de um agente. Você pode começar a partir de um template no Agents Toolkit ou de exemplos no Agents SDK. Este documento se concentra nos modelos disponíveis no Kit de Ferramentas de Agentes. Existem diferentes modelos e opções disponíveis para criar projetos do SDK de Agentes com o kit de ferramentas. Este tutorial se concentra na criação de um Agente Meteorológico usando Kernel semântico e Fábrica de IA do Azure.

1. Abra o Visual Studio e selecione Criar um projeto. Pesquise por "agente" para encontrar novos modelos usando o Kit de Ferramentas de Agentes do Microsoft 365 e o SDK de Agentes. Selecione Agentes do Microsoft 365>Avançar.

   

   Uma caixa de diálogo será aberta para que você possa definir o nome do agente. Você também pode mudar o local e o nome da solução, se quiser.

2. Ao terminar, selecione Criar

   

   Você pode escolher entre as opções que o kit de ferramentas oferece para criar agentes.

3. Para este passo a passo, selecione o exemplo Agente Meteorológico>Avançar para usar o SDK de agentes do Microsoft 365. Este exemplo predefinido implementa o Kernel semântico para orquestração com modelos do Fábrica de IA do Azure ou OpenAI do Azure. Você também pode usar o exemplo de agente Vazio se quiser começar sem um modelo ou orquestrador.

   

   

   Um diálogo solicitará que você selecione o serviço de LLM.

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

   Essas informações podem ser encontradas no Fábrica de IA do Azure na seção Modelos e pontos de extremidade.

   

5. Preencha os campos obrigatórios: Chave de serviço do OpenAI do Azure, Ponto de extremidade do OpenAI do Azure e Nome da implantação do OpenAI do Azure.

6. Selecione Criar. O kit de ferramentas cria o projeto a partir de um modelo para você.

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

   

Testar seu agente no Playground de Agentes do Microsoft 365

Para começar, você pode testar localmente usando o Playground de Agentes do Microsoft 365 no Kit de Ferramentas de Agentes.

Para começar os testes, defina o destino de depuração no seu projeto como Playground de Agentes do Microsoft 365.

O playground é aberto para você testar em uma nova janela do navegador, utilizando seu host local para mostrar o playground pronto para teste. Comece a enviar mensagens para o agente para testar seu comportamento.

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

Você também pode definir o destino de depuração para estar diretamente no Microsoft Teams ou no Microsoft 365 Copilot.

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

   

   Leva alguns instantes para alternar para o Microsoft Teams. Você será solicitado a adicionar seu agente no aplicativo Teams que será aberto.

   

2. Selecione Adicionar. Um painel de notificações será exibido, indicando que o agente foi adicionado com êxito.

   

3. Selecione Abrir no seu novo agente para que ele seja aberto no Teams. Você pode fazer perguntas ao seu agente diretamente no Teams. Você pode definir pontos de interrupção para trabalhar com a depuração de sua experiência quando necessário.

   

Resumo

Agora você concluiu com êxito:

• Iniciou um novo projeto e agente do Microsoft 365 Agents usando o Agents Toolkit
• Testou o agente localmente usando o Playground de Agentes do Microsoft 365
• Implantou o agente para depuração diretamente no canal do Teams ou do Microsoft 365