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

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

Criar um novo projeto

O Kit de Ferramentas de Agentes 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 Kit de Ferramentas de Agentes.

1. Para criar um novo projeto de agente, abra o Visual Studio e selecione Criar um novo projeto. Pesquise por "agente" para encontrar novos modelos usando o Microsoft 365 Agent Toolkit and Agents SDK Select 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 criar agentes. Para usar o SDK do Microsoft 365 Agents, selecione o exemplo do Agente de Clima . Este exemplo predefinido implementa o Kernel Semântico para orquestração com modelos do Azure AI Foundry ou do 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.

   

Testar seu agente no Microsoft 365 Agents Playground

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

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

O playground é aberto para você testar em uma nova janela do navegador com seu host local e mostra o playground com ele pronto para teste. Comece a enviar mensagens ao seu agente para testar 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.

   

   Leva alguns instantes para o Microsoft Teams. Você será solicitado a adicionar seu agente ao 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 em seu novo agente para abrir no Teams. Você pode fazer perguntas sobre 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ê tem êxito:

• Iniciou um novo projeto e agente do Microsoft 365 Agents usando o Kit de Ferramentas de Agentes
• 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