Descrição geral do SDK de Agentes do Microsoft 365

Com o SDK de Agentes do Microsoft 365, pode criar agentes implementáveis em canais à sua escolha, como Microsoft 365 Copilot, Microsoft Teams, aplicações Web e personalizadas e muito mais, com uma estrutura base que gere a comunicação necessária. Os programadores podem utilizar os serviços de IA à sua escolha e disponibilizar os agentes que criam utilizando as capacidades de gestão de canais do SDK.

Principais funcionalidades do SDK de Agentes

Os programadores precisam de flexibilidade para integrar agentes de qualquer fornecedor ou pilha de tecnologia nos seus sistemas empresariais. O SDK de Agentes simplifica a implementação de padrões por meio de agentes, utilizando a IA à sua escolha e permitindo selecionar um ou mais serviços, modelos ou agentes para atender aos seus requisitos específicos.

Utilize o SDK de Agentes para:

  1. Constrói rapidamente um contentor de agente com estado, armazenamento e a capacidade de gerir atividades e eventos. Implemente este contentor em qualquer canal, como o Microsoft 365 Copilot ou o Microsoft Teams.
  2. Implemente padrões por meio de agentes sem ficar restrito a uma pilha de tecnologia específica. O SDK dos Agentes é agnóstico quanto à IA que escolhes.
  3. Personalize o seu agente para o alinhar com os comportamentos específicos dos clientes, como o Microsoft Teams.

Idiomas suportados

O SDK de Agentes suporta:

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

Criar um agente

É fácil obter o exemplo inicial em C#, JavaScript ou Python a partir do GitHub

Para criar um agente em C#:

builder.AddAgent( sp =>
{
    var agent = new AgentApplication(sp.GetRequiredService<AgentApplicationOptions>());
    agent.OnActivity(ActivityTypes.Message, async (turnContext, turnState, cancellationToken) =>
    {
        var text = turnContext.Activity.Text;
        await turnContext.SendActivityAsync(MessageFactory.Text($"Echo: {text}"), cancellationToken);
    });
});

Isto cria um novo agente, escuta uma atividade do tipo mensagem e envia uma mensagem de volta

A partir daqui, você pode adicionar seus Serviços de IA personalizados escolhidos (por exemplo, Azure Foundry ou Agentes OpenAI) e Orquestração (por exemplo, Kernel Semântico).

Termos importantes

Alguns conceitos específicos que são importantes para o SDK são:

  • Turno: Um turno é uma unidade de trabalho que é feito pelo agente. Pode ser uma única mensagem ou uma série de mensagens. Os programadores trabalham com turnos e gerem os dados entre eles
  • Atividade: Uma atividade é um dos vários tipos de interação geridos pelo agente
  • Mensagens: Uma mensagem é um tipo de atividade que pode ser enviada ao agente. Pode ser uma única mensagem ou uma série de mensagens.

Começar

Antes de começar, é necessário ter em conta alguns pré-requisitos. Os pré-requisitos dependem da linguagem que está a utilizar para desenvolver a sua aplicação.

Transferir e instalar

Transfira os ficheiros necessários para começar.

Clone o repositório Agents GitHub localmente. O repositório contém bibliotecas de origem do SDK e exemplos para ajudá-lo a começar a criar aplicações utilizando o SDK. A instalação dos exemplos instala os pacotes necessários para o SDK.

Próximos passos

  • Last updated on