Partilhar via


Criar o seu primeiro agente

Os agentes utilizam IA para automatizar e executar processos empresariais, funcionando em conjunto ou em nome de uma pessoa, equipa ou organização. Os agentes vão desde agentes simples de pedido e resposta a agentes mais avançados e totalmente autónomos.

Ferramentas de que irá precisar

Para criar um agente no Microsoft Teams, certifique-se de que tem o seguinte:

Instalar Para usar...
Visual Studio Code Ambientes de compilação JavaScript, TypeScript ou Python. Utilize a versão mais recente.
Teams SDK Um SDK simplificado para a criação de agentes inteligentes. Agora ga para JavaScript e C#, e em pré-visualização pública para Python.
Toolkit de Agentes do Microsoft 365 O Microsoft Visual Studio Code extensão que cria um projeto estruturado para o seu agente. Utilize a versão mais recente.
Node.js Ambiente de runtime do JavaScript de back-end. Para obter mais informações, veja Node.js tabela de compatibilidade de versões para o tipo de projeto.
Microsoft Teams O Microsoft Teams para colaborar com todas as pessoas com quem trabalha através de agentes e aplicações para conversas, reuniões e chamadas num único local.
Azure OpenAI Primeiro, crie a chave da API OpenAI para utilizar o Transformador Pré-preparado Gerador (GPT) da OpenAI. Se quiser alojar o agente ou aceder aos recursos no Azure, tem de criar um serviço OpenAI Azure.

Configurar seu ambiente

  1. Instale as versões mais recentes do Visual Studio Code, Node.js e Microsoft 365 Agents Toolkit.
  2. Se quiser utilizar Azure serviço OpenAI para aceder ao Modelo de Linguagem Grande (LLM) para o agente, crie um Azure serviço OpenAI no portal do Azure e obtenha a chave de API.

Para obter mais informações sobre como configurar Azure serviços OpenAI, consulte:

Criar um agente com o Toolkit de Agentes do Microsoft 365

  1. Abra o Visual Studio Code.

  2. Selecione o ícone do Toolkit de Agentes do Microsoft 365 na Barra de Atividade do Visual Studio Code.

  3. Selecione Criar um Novo Agente/Aplicação.

    Captura de ecrã a mostrar a localização da opção para criar um novo agente com a barra lateral do Toolkit de Agentes do Microsoft 365.

  4. No menu Novo Projeto , selecione Agentes e Aplicações do Teams.

    Captura de ecrã a mostrar a localização da opção para criar um novo agente ou aplicação no Teams.

  5. Selecione Agente Geral do Teams para criar um agente.

    Captura de ecrã a mostrar a localização da opção para criar um novo agente no Teams.

  6. Selecione um serviço para aceder ao Modelo de Linguagem Grande (LLM) para o seu agente.

    Captura de ecrã a mostrar a localização da opção para selecionar um LLM adequado para o seu agente.

    Escolha uma das seguintes opções:

    • Selecione Azure OpenAI se tiver obtido a chave OpenAI de Azure. Ao seguir este passo, tem de:

      1. Introduza Azure chave OpenAI no Azure chave de serviço OpenAI.
      2. Introduza o ponto final no Azure ponto final de serviço OpenAI.
      3. Introduza o nome da implementação no Azure nome da implementação OpenAI.
    • Selecione Chave OpenAI e introduza a tecla OpenAI.

  7. Selecione a Linguagem de Programação para desenvolver o seu agente.

    Captura de ecrã a mostrar a opção para selecionar a linguagem de programação do seu agente.

  8. Selecione a pasta Predefinida como a Pasta de Área de Trabalho do projeto do agente.

    Captura de ecrã a mostrar o campo para selecionar a pasta da área de trabalho para o projeto do agente.

  9. Introduza o nome do agente e, em seguida, selecione Enter.

    Captura de ecrã a mostrar o campo para adicionar o nome do agente.

    O toolkit apresenta uma mensagem a indicar que o agente foi criado com êxito. Também pode aprovisionar o agente neste momento ou posterior. Se o toolkit apresentar uma mensagem para confirmar se confia no autor, selecione Sim, confio nos autores.

    Captura de ecrã a mostrar a mensagem para confirmar se confia nos autores do agente.

Ver uma apresentação do código fonte do agente

O Toolkit de Agentes do Microsoft 365 cria o seu projeto de agente e estrutura a área de trabalho do projeto. Veja a seguir a estrutura de pastas:

Pasta Conteúdos
.vscode Visual Studio Code ficheiros para depuração.
appPackage Modelos para o manifesto do Teams.
env Ficheiros de ambiente.
infra Modelos para aprovisionar recursos Azure.
src O código fonte do projeto.

Executar e utilizar o seu agente no Teams

  1. Abra o projeto de agente no Visual Studio Code.

  2. Selecione Executar>Iniciar Depuração ou, em alternativa, selecione a tecla F5 .

    Se todos os pré-requisitos estiverem instalados, Visual Studio Code carrega e abre o seu agente no Microsoft Teams.

    Captura de ecrã a mostrar o agente aberto no Microsoft Teams.

  3. Para utilizar o agente, selecione um dos pedidos apresentados pelo agente.

    Captura de ecrã a mostrar como selecionar um pedido do agente.

    Quando seleciona o pedido, este é apresentado na caixa de comentário e pode selecionar o ícone Enviar . O agente responde ao pedido.

    Captura de ecrã a mostrar a resposta do agente ao pedido do utilizador.

Parabéns! Criou e executou o seu primeiro agente no Microsoft Teams.

Escolher a linguagem de programação

O SDK do Teams está disponível para JavaScript, C#e Python (pré-visualização do programador). Fornece um SDK simplificado, suporte para o Protocolo de Contexto de Modelo (MCP), comunicação Agente a Agente (A2A) e ferramentas simplificadas para permitir que os programadores criem agentes inteligentes para o Microsoft Teams.

Descrição

             Escolher o ambiente de compilação

Criar com ...

C#

Exemplo de código

Nome do exemplo Descrição .NET Node.js Python
Hub de conhecimento da Contoso Um agente inteligente criado no SDK do Teams que foi concebido para capacitar os estudantes nos seus percursos académicos e profissionais. O agente oferece suporte personalizado para seleção de cursos, estratégias de estudo, planeamento de desenvolvimento de carreira e criação de mapa académico. View View Exibir

Confira também

Experiência de utilizador de agentes