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. Criar 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 de Agentes é agnóstico em relação à IA que escolher.
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 irão trabalhar com turnos e gerir 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.

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.

Próximos passos

• Guia de início rápido: criar e testar um agente básico usando C#
• Saiba mais sobre o Protocolo de Atividades