Criar agentes .NET no Visual Studio usando o Microsoft 365 Agents Toolkit

Neste artigo, você aprenderá a criar um novo projeto Agents SDK .NET no Visual Studio, usando o Microsoft 365 Agents Toolkit.

Criar um novo projeto

O Agents Toolkit fornece um modelo de projeto para ajudá-lo a começar a criar um agente. Você pode começar a partir de um modelo no kit de ferramentas ou a partir de exemplos no SDK de agentes. Este documento se concentra nos modelos disponíveis no Agents Toolkit.

1. Para criar um novo projeto de agente, abra o Visual Studio e selecione Criar um novo projeto. Procure por "agente" para encontrar novos modelos usando o Microsoft 365 Agent Toolkit e o Agents SDK Selecione Microsoft 365 Agents>Next.

   

   Uma caixa de diálogo é exibida para que você possa nomear o agente. Você também pode alterar o local e o nome da solução, se desejar.

2. Quando terminar, selecione Avançar

   

3. A próxima caixa de diálogo solicita que você escolha o tipo de agente. Você pode selecionar algumas opções diferentes que o kit de ferramentas fornece para a criação de agentes. Para usar o SDK do Microsoft 365 Agents, você deve selecionar o exemplo de Weather Agent . Este exemplo pré-criado implementa o Kernel Semântico para orquestração com modelos Azure AI Foundry ou Azure OpenAI. Você também pode usar o exemplo de agente vazio se quiser começar sem um modelo ou orquestrador configurado.

   

   

4. Para este passo a passo, selecione Azure AI Foundry e conclua as entradas necessárias. Incluindo a chave, o ponto de extremidade e o nome da implantação. Essas informações podem ser encontradas no Azure AI Foundry em Modelos e pontos de extremidade.

   

5. Selecione Criar. O kit de ferramentas cria o projeto a partir de um modelo para você, pronto para começar.

6. Em um curto período de tempo, você deve ter um novo projeto criado que utiliza o SDK de agentes.

   

Teste seu agente no Microsoft 365 Agents Playground

Para começar, você pode testar localmente usando o Microsoft 365 Agents Playground no Toolkit.

Para começar a testar, selecione o destino de depuração em seu projeto para ser o Microsoft 365 Agents Playground."

O playground abre para você testar em uma nova janela do navegador com seu anfitrião local e mostra o playground com ele pronto para testar. Comece a enviar mensagens ao seu agente para testar o seu comportamento.

Depurar e testar seu 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.

   

   O Microsoft Teams demora alguns momentos. Você será solicitado a adicionar seu agente no Cliente do Teams que é aberto.

   

2. Selecione Adicionar. Um painel de notificação é exibido, indicando que o agente foi adicionado com êxito.

   

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

   

Resumo

Agora você conseguiu agora:

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