Qual é o SDK de Agentes do Microsoft 365

O SDK de Agentes do Microsoft 365 é uma estrutura de desenvolvimento para criar agentes de conversa. Agentes de conversa são software que podem receber mensagens de usuários, processá-las e respondê-las. Pense nisso como a camada intermediária entre o envio de uma mensagem por um usuário (seja no Teams, em um site, no Slack ou em outro lugar) e a lógica que você construiu para responder a essa mensagem.

O SDK cuida da mecânica de receber e enviar mensagens por diferentes canais, para que os desenvolvedores possam se concentrar no que o agente realmente faz, em vez de nos protocolos de comunicação de nível inferior.

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 posteriores
  • Python com versões de 3.9 a 3.11

Três problemas que o SDK de Agentes soluciona

  • Seu agente precisa funcionar em mais de um lugar. Nem todos os usuários se comunicam pelo mesmo canal. Alguns usam o Microsoft Teams, outros usam o Microsoft 365 Copilot, outros usam o site da empresa, e outros usam ferramentas de terceiros, como Slack ou Facebook Messenger. Sem uma estrutura, o desenvolvedor precisa escrever código de integração separado para cada uma dessas plataformas, 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 seu agente uma única vez, e o SDK traduz as mensagens de entrada e saída do formato e para o formato que cada canal espera. Adicionar um novo canal não exige reescrever o comportamento principal do agente.

  • Você não quer ficar preso a um único serviço de IA. A escolha de qual serviço de IA impulsiona um agente, seja Fábrica de IA do Azure, OpenAI, Kernel Semântico ou algo completamente diferente, muda frequentemente conforme o cenário evolui e diferentes casos de uso surgem. Uma estrutura de agentes que integra um provedor de IA específico obriga os desenvolvedores a reescrever grande parte do código quando essa escolha muda.

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

  • Gerenciar o estado da conversa é difícil. As conversas não são sem estado. Um usuário pode fazer uma pergunta de acompanhamento, referir-se a algo dito duas rodadas atrás ou abandonar uma conversa e retomá-la depois. Gerenciar esse contexto, incluindo rastrear o que aconteceu, onde está armazenado e como ele flui entre as mensagens, é trabalhoso e suscetível a erros quando desenvolvido do zero.

    O SDK fornece gerenciamento de estado e armazenamento integrado. O SDK introduz o conceito de rodada (uma única unidade de trabalho em uma conversa) e rastreia o estado entre rodadas, sem exigir que os desenvolvedores implementem sua própria camada de persistência. Isso significa menos código padronizado e menos erros na lógica do fluxo de conversas.

Como tudo funciona junto

Essencialmente, o SDK faz três coisas quando uma mensagem chega:

  1. Recebe a mensagem do canal que a enviou (Teams, chat da Web, Slack etc.) e a normaliza em um formato comum chamado Activity.

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

  3. Retorna a resposta pelo mesmo canal, traduzindo sua resposta para o formato que o canal espera.

Os desenvolvedores escrevem manipuladores para os tipos de atividades importantes para eles. O SDK cuida de todo o resto, incluindo autenticação, tradução de formatos de mensagens e conectividade de canal.

O que o SDK de Agentes não é

O SDK de Agentes não é um modelo de IA, um mecanismo de orquestração ou uma plataforma de criação 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 conecte 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