Qual é o SDK de Agentes do Microsoft 365

O SDK de Agentes do Microsoft 365 é uma estrutura de desenvolvimento para a criação de agentes de conversação. Os agentes de conversa são softwares que podem receber mensagens dos usuários, processá-las e responder. Pense nisso como a camada de encanamento entre um usuário que envia uma mensagem (seja no Teams, em um site, no Slack ou em outro lugar) e em qualquer lógica criada para responder a essa mensagem.

O SDK lida com a mecânica de receber e enviar mensagens em diferentes superfícies, para que os desenvolvedores possam se concentrar no que o agente realmente faz em vez de em protocolos de comunicação de baixo nível.

Idiomas com suporte

O SDK de agentes dá suporte a:

  • C# usando o SDK do .NET 8.0
  • JavaScript usando Node.js versão 18 e posterior
  • Python usando a versão 3.9 a 3.11

Três problemas que o SDK de Agentes resolve

  • Seu agente precisa trabalhar em mais de um lugar. Todos os usuários não se comunicam pelo mesmo canal. Alguns usam Microsoft Teams, alguns usam Microsoft 365 Copilot, alguns usam um site da empresa e outros usam ferramentas não Microsoft, como Slack ou Facebook Messenger. Sem uma estrutura, um desenvolvedor precisa escrever código de integração separado para cada uma dessas superfícies, cada uma com seu próprio formato de mensagem, esquema de autenticação e protocolo de conexão.

    O SDK fornece uma camada de abstração de canal. Você escreve a lógica do agente uma vez e o SDK converte mensagens de entrada e saída de e para o formato esperado por cada canal. Adicionar um novo canal não requer reescrever o comportamento principal do agente.

  • Você não quer ser bloqueado em um serviço de IA. A escolha de qual serviço de IA alimenta um agente, seja Fábrica de IA do Azure, OpenAI, Kernel semântico ou algo totalmente diferente, muda com frequência à medida que o cenário evolui e à medida que diferentes casos de uso surgem. Uma estrutura de agente que integra um provedor de IA específico força os desenvolvedores a reescrever grandes partes de seu código quando essa escolha é alterada.

    O SDK é independente de IA por design. Ele fornece a estrutura para receber mensagens, gerenciar o estado e rotear eventos, mas não faz pressuposições sobre o que gera a resposta. Os desenvolvedores conectam quaisquer serviços de IA ou bibliotecas de orquestração que preferirem. O SDK não interfere na escolha.

  • Gerenciar o estado de conversação é difícil. As conversas não são sem estado. Um usuário pode fazer uma pergunta de acompanhamento, consultar algo dito há duas voltas ou abandonar uma conversa e retomá-la mais tarde. O gerenciamento desse contexto, incluindo o acompanhamento do que aconteceu, onde ele é armazenado e como ele flui entre mensagens, é entediante e propenso a erros para compilar do zero.

    O SDK fornece gerenciamento de estado e armazenamento integrados. Ele introduz o conceito de turno (uma única unidade de trabalho em uma conversa) e acompanha o estado ao longo dos turnos sem precisar que os desenvolvedores implementem sua própria camada de persistência. Isso significa menos código clichê e menos bugs na lógica de fluxo de conversa.

Como se encaixa

Em sua essência, o SDK faz três coisas quando uma mensagem chega:

  1. Recebe a mensagem de qualquer canal que a enviou (Teams, web chat, Slack e assim por diante) e a normaliza em um formato comum chamado .Activity

  2. Roteia a atividade para o handler apropriado no código do agente. Por exemplo, uma atividade de mensagem dispara um manipulador, um usuário que ingressa em uma conversa dispara outro.

  3. Envia a resposta de volta pelo mesmo canal, traduzindo sua resposta de volta para o formato esperado pelo canal.

Os desenvolvedores escrevem manipuladores para os tipos de atividade de seu interesse. O SDK lida com todo o resto, incluindo autenticação, tradução de formato de mensagem e conectividade de canal.

O que o SDK dos Agentes não é

O SDK de Agentes não é um modelo de IA, um mecanismo de orquestração ou um construtor sem código. O SDK de Agentes não decide o que um agente diz. Esses elementos são o trabalho de qualquer serviço de IA ou lógica de negócios que o desenvolvedor conecta ao agente. O SDK de Agentes é a estrutura que envia e recebe mensagens para e dessa lógica de forma confiável através dos canais, mantendo o estado da conversa intacto.

Próximas etapas

  • Last updated on