Visão geral do SDK de Agentes do Microsoft 365

Com o SDK de Agentes do Microsoft 365, você pode criar agentes implantáveis em canais de sua escolha, como Microsoft 365 Copilot, Microsoft Teams, aplicativos Web e personalizados e muito mais, com suporte para lidar com a comunicação necessária. Os desenvolvedores podem usar os serviços de IA de sua escolha e disponibilizar os agentes que eles criam usando os recursos de gerenciamento de canais do SDK.

Principais recursos do SDK de agentes

Os desenvolvedores precisam da flexibilidade para integrar agentes de qualquer provedor ou pilha de tecnologia a seus sistemas empresariais. O SDK de agentes simplifica a implementação de padrões de agente usando a IA de sua escolha, permitindo que eles selecionem um ou mais serviços, modelos ou agentes para atender a seus requisitos específicos.

Use o SDK de agentes para:

1. Compilar rapidamente um "contêiner" de agente com estado, armazenamento e a capacidade de gerenciar atividades e eventos. Implantar esse contêiner em qualquer canal, como o Microsoft 365 Copilot ou o Microsoft Teams.
2. Implementar padrões de agente sem ficar restrito a uma pilha de tecnologia específica. O SDK de agentes independe da IA escolhida.
3. Personalize seu agente para se alinhar aos comportamentos específicos dos clientes, como o Microsoft Teams.

Idiomas compatíveis

O SDK de agentes dá suporte a:

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

Criar um agente

É fácil obter o exemplo inicial em C#, JavaScript ou Python no 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);
    });
});

Isso cria um novo agente, escuta uma atividade de tipo de 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 OpenAI Agents) e Orquestração (por exemplo, Kernel Semântico).

Termos importantes

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

• Turno: Turno consiste em uma unidade de trabalho que é realizada pelo agente. Pode ser uma única mensagem ou uma série de mensagens. Os desenvolvedores trabalharão com "turnos" e gerenciarão os dados entre eles
• Atividade: uma atividade é um ou mais tipos de unidade gerenciados pelo agente
• Mensagens: uma mensagem é um tipo de atividade que é enviada ao agente. Pode ser uma única mensagem ou uma série de mensagens.

Introdução

Antes de começar, você precisa cuidar de alguns pré-requisitos. Os pré-requisitos dependem do idioma que você está usando para desenvolver seu aplicativo.

Fazer o download e instalar

Baixe os arquivos necessários para começar.

Próximas etapas

• Início Rápido: Criar e testar um agente básico usando C#
• Saiba mais sobre o Protocolo de Atividade