O que é o SDK de Agentes do Microsoft 365

O SDK de Agentes do Microsoft 365 é um framework de desenvolvimento para construir agentes conversacionais. Os agentes conversacionais são softwares que podem receber mensagens dos utilizadores, processá-las e responder. Pensa nisso como a camada de canalização entre um utilizador a enviar uma mensagem (seja no Teams, num site, no Slack ou noutro local) e a lógica que criaste para responder a essa mensagem.

O SDK trata da mecânica de receber e enviar mensagens através de diferentes superfícies, para que os desenvolvedores possam focar-se no que o agente realmente faz em vez de nos protocolos de comunicação de baixo nível.

Idiomas suportados

O SDK de Agentes suporta:

  • C#, utilizando o SDK do .NET 8.0
  • JavaScript usando Node.js versão 18 e posteriores
  • Python usando as versões 3.9 a 3.11

Três problemas que o SDK dos Agentes resolve

  • O seu agente precisa de trabalhar em mais do que um lugar. Os utilizadores não comunicam todos pelo mesmo canal. Alguns usam o Microsoft Teams, outros o Microsoft 365 Copilot, outros usam o site da empresa, e alguns usam ferramentas que não são da Microsoft como o Slack ou o Facebook Messenger. Sem um framework, um programador precisa de escrever código de integração separado para cada uma dessas superfícies, cada uma com o seu próprio formato de mensagem, esquema de autenticação e protocolo de ligação.

    O SDK fornece uma camada de abstração de canal. Escreves a lógica do teu agente uma vez, e o SDK traduz as mensagens de entrada e saída para e do formato que cada canal espera. Adicionar um novo canal não requer reescrever o comportamento central do agente.

  • Não queres ficar preso a um único serviço de IA. A escolha do serviço de IA que alimenta um agente, seja Azure AI Foundry, OpenAI, Kernel Semântico ou algo completamente diferente, muda frequentemente à medida que o panorama evolui e surgem diferentes casos de uso. Um framework de agentes que integra um fornecedor de IA específico obriga os programadores a reescrever grandes partes do seu código quando essa escolha muda.

    O SDK é agnóstico em relação à IA por design. Fornece a estrutura para receber mensagens, gerir o estado e o roteamento de eventos, mas não pressupõe o que é responsável pela geração da resposta. Os programadores inserem os serviços de IA ou bibliotecas de orquestração que preferirem. O SDK não atrapalha essa escolha.

  • Lidar com o estado da conversação é difícil. As conversações não são sem estado. Um utilizador pode fazer uma pergunta de seguimento, referir-se a algo dito há dois turnos, ou abandonar uma conversa e retomá-la mais tarde. Gerir esse contexto, incluindo acompanhar o que aconteceu, onde está armazenado e como flui entre mensagens, é trabalhoso e propenso a erros de construir do zero.

    O SDK fornece gestão de estado e armazenamento incorporada. Introduz o conceito de turno (uma única unidade de trabalho numa conversa) e acompanha o estado ao longo dos turnos sem exigir que os programadores implementem a sua própria camada de persistência. Isto significa menos código padrão e menos bugs na lógica do fluxo de conversas.

Como tudo se encaixa

No seu cerne, o SDK faz três coisas quando chega uma mensagem:

  1. Recebe a mensagem do canal que a enviou (Teams, chat web, Slack, etc.) e normaliza-a num formato comum chamado Activity.

  2. Encaminha a atividade para o handler apropriado no código do teu agente. Por exemplo, uma atividade de mensagem desencadeia um handler, um utilizador que entra numa conversa desencadeia outro.

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

Os programadores escrevem handlers para os tipos de atividade que lhes interessam. O SDK trata de tudo o resto, incluindo autenticação, tradução de formatos de mensagens e conectividade ao canal.

O que o SDK dos Agentes não é

O SDK dos Agentes não é um modelo de IA, um motor de orquestração ou um construtor sem código. O SDK dos Agentes não decide o que os agentes dizem. Estes elementos são função do serviço de IA ou da lógica de negócio que o programador insere no agente. O SDK de Agentes é a estrutura que envia e recebe mensagens para e a partir dessa lógica de forma fiável, entre canais, mantendo o estado da conversação intacto.

Próximos passos

  • Last updated on