Visão geral dos agentes de mecanismo personalizados para Microsoft 365

Os agentes de mecanismo personalizado expandem os recursos do Microsoft 365 Copilot, permitindo que as organizações criem assistentes baseados em IA adaptados às suas necessidades específicas. Ao contrário das experiências padrão do Copilot, os agentes de mecanismo personalizados fornecem controle total sobre orquestração, modelos de IA e integrações de dados, permitindo que as empresas criem fluxos de trabalho avançados que se alinham com seus requisitos exclusivos. Esses agentes podem ser criados usando o Copilot Studio, o SDK de Agentes do Microsoft 365, o SDK do Teams ou o Microsoft Foundry, dependendo da sua abordagem de desenvolvimento e ambiente de hospedagem preferidos.

Este artigo orienta você pelas funcionalidades e opções para criar um agente de mecanismo personalizado.

O que é um agente de mecanismo personalizado?

Os agentes de mecanismo personalizado são agentes especializados do Copilot projetados para atender a cenários corporativos específicos. Ao contrário dos agentes declarativos, eles oferecem aos desenvolvedores a flexibilidade de trazer seus próprios serviços de orquestração e IA. Isso permite controle total sobre fluxos de trabalho, modelos de IA e integrações, permitindo que as organizações criem soluções avançadas.

Principais características dos agentes de mecanismo personalizados

Os agentes de mecanismo personalizados têm as seguintes características:

• Orquestração personalizada – Defina fluxos de trabalho personalizados e conecte-se a sistemas externos para incorporar mais conhecimento ou invocar ações.
• Modelos de IA flexíveis – escolha entre modelos básicos, modelos ajustados ou IA específica do setor para se adequar ao seu caso de uso.
• Automação proativa – Dispare fluxos de trabalho programaticamente e execute ações em aplicativos corporativos.

Abordagens de desenvolvimento para agentes de mecanismo personalizados

Você pode usar uma abordagem low-code para criar agentes de mecanismo personalizados usando o Copilot Studio ou uma abordagem pro-code usando ferramentas de desenvolvimento e SDKs. Você também pode integrar um agente Microsoft Foundry existente ao Microsoft 365. Todas as opções permitem a integração de conhecimento e ações externas no Microsoft 365 Copilot. No entanto, eles diferem em complexidade, conjunto de habilidades necessárias e os tipos de cenários de negócios que melhor suportam.

Abordagem low-code

Como o Copilot Studio é uma plataforma SaaS totalmente gerenciada que simplifica a criação de agentes de mecanismo personalizados, você pode se concentrar na criação de experiências eficazes de agente sem se preocupar com infraestrutura, hospedagem ou governança. Ele oferece conformidade interna por meio do Microsoft Power Platform, juntamente com modelos e conectores predefinidos para o Microsoft 365 e serviços de parceiros. Embora ofereça suporte ao desenvolvimento low-code, o valor real está em sua implantação e gerenciamento simplificados.

Essa abordagem é ideal para organizações que buscam criar e dimensionar agentes de mecanismo personalizados rapidamente, sem depender muito de recursos de desenvolvimento.

Abordagem pró-código

Para desenvolvimento de código profissional, use o Visual Studio ou o Visual Studio Code com a extensão Microsoft 365 Agents Toolkit. Esse kit de ferramentas simplifica o desenvolvimento do agente, fornecendo modelos predefinidos, depuração fácil e fluxos de trabalho de implantação simplificados. É ideal para desenvolvedores que desejam uma experiência totalmente personalizada.

Ao criar agentes com o kit de ferramentas, escolha entre dois SDKs, dependendo de suas necessidades.

SDK de Agentes do Microsoft 365

O SDK de Agentes do Microsoft 365 é uma estrutura projetada para criar agentes multicanais de pilha completa que podem operar no Microsoft 365 Copilot, Teams, plataformas de parceiros, aplicativos personalizados e sites.

É ideal para casos de uso que exigem orquestração personalizada usando estruturas como Kernel semântico ou LangChain e dá suporte à integração com qualquer modelo ou serviço de IA. Esse SDK é mais adequado para organizações ou ISVs que precisam de agentes altamente personalizados com recursos avançados e a capacidade de operar em vários canais.

Teams SDK

O SDK do Teams é uma estrutura adaptada especificamente para o Microsoft Teams. Ele inclui um orquestrador de planejador de ação interno e dá suporte a modelos de linguagem baseados em GPT do Azure e OpenAI.

Essa opção é ideal para organizações que procuram construir agentes colaborativos que operam dentro dos canais e reuniões do Teams. É útil ao criar agentes que interagem em tempo real com os usuários em um ambiente colaborativo e baseado em equipe.

Integrar agentes do Microsoft Foundry

O Microsoft Foundry fornece uma plataforma para criar, testar e publicar agentes inteligentes usando o Agent Framework SDK (anteriormente Kernel semântico). Esses agentes podem ser integrados ao Microsoft 365 Copilot e ao Teams por meio do portal Foundry ou do Microsoft 365 Agents Toolkit.

Essa abordagem é ideal para desenvolvedores ou organizações que já mantêm a lógica e a orquestração de IA no Foundry e desejam disponibilizar esses recursos diretamente no Microsoft 365.

A tabela a seguir mostra as duas abordagens de integração para agentes Foundry.

Ambas as abordagens de integração conectam o Serviço de Agente do Foundry ao Microsoft 365 Copilot por meio de uma camada de bot ou proxy, permitindo que os usuários interajam com os agentes do Foundry diretamente no Microsoft 365 e no Teams.

Comparação de ferramentas de desenvolvimento de agente

A tabela a seguir fornece uma comparação rápida das abordagens disponíveis.

Principais considerações

As seguintes considerações se aplicam à escolha de sua ferramenta de desenvolvimento:

• Escopo de publicação: somente agentes criados com o SDK do Teams, SDK de Agentes do Microsoft 365 ou Foundry podem ser publicados na Microsoft Commercial Store com o Kit de Ferramentas de Agentes.
• Produtividade do grupo - Para cenários de vários usuários, especialmente no Teams, considere o SDK do Teams para seu suporte interno para canais colaborativos e reuniões. Os agentes de criação também podem ser usados no Teams, mas podem exigir configuração adicional para interações de vários usuários.
• Necessidades de personalização - Se você precisar de controle total sobre modelos de IA ou orquestração, opte por uma abordagem de código profissional com SDK de Agentes do Microsoft 365 ou Foundry por meio do Agents Toolkit.
• Acesso à fonte de conhecimento – os agentes do Copilot Studio têm acesso nativo ao conteúdo do Microsoft 365 e do conector do Copilot. Os agentes de código profissional, incluindo aqueles criados com o SDK do Agents ou o Foundry por meio do Agents Toolkit, podem acessar os mesmos dados por meio de APIs do Microsoft Graph e usar a API de recuperação para fundamentação em dados do Microsoft 365.

Exemplos de cenário

A tabela a seguir fornece exemplos de cenário e a abordagem de desenvolvimento recomendada para cada um.

Requisitos, design e considerações de implantação

Ao se preparar para criar e implantar seu agente de mecanismo personalizado, considere os principais fatores descritos nesta seção para garantir desempenho, conformidade e sustentabilidade.

Os requisitos dependem da sua abordagem de desenvolvimento: a hospedagem para modelos e orquestradores varia de acordo com a abordagem de desenvolvimento escolhida, você pode trazer seus próprios modelos de orquestração e base e os agentes de mecanismo personalizados exigem o manifesto do aplicativo versão 1.21 ou posterior. Para obter um resumo de alto nível do que você precisa para criar um agente de mecanismo personalizado, consulte Agentes para o Microsoft 365 Copilot.

Ordenação de mensagens e comportamento de streaming

O Teams e o Microsoft 365 Copilot processam mensagens do agente com base em carimbos de data/hora do servidor, IDs de atividades e a relação entre atualizações de streaming e atividades não relacionadas a streaming. Quando um agente de mecanismo personalizado mistura texto de streaming, anexos de mídia e mensagens finais no mesmo turno do usuário, as mensagens podem aparecer fora de sequência. Para manter uma ordenação consistente:

• Use uma única sequência de streaming por turno de usuário. Crie um StreamingResponse objeto e finalize-o usando endStream() antes de enviar mensagens adicionais.

• Anexe a mídia dentro do mesmo fluxo. Use setAttachments() em vez de enviar uma atividade separada que não seja de streaming. Mensagens separadas podem aparecer antes ou dentro do fluxo devido a diferenças de carimbo de data/hora.

• Não inicie um novo fluxo antes que o anterior seja finalizado. Vários fluxos no mesmo turno podem produzir uma ordem imprevisível no Teams e no Copilot.

• Serializar mensagens de saída. Evite enviar mensagens de vários threads em paralelo. Certifique-se de que as atualizações sejam aguardadas para manter a ordem.

• Não envie atualizações de streaming depois endStream()de . Quando o fluxo é finalizado, todas as novas atualizações se tornam atividades separadas e podem parecer fora de ordem. Se você precisar enviar uma mensagem de acompanhamento, use replyToId para mantê-la no mesmo thread e reduzir problemas de sequenciamento.

Seleção de modelo de IA

Os agentes de mecanismo personalizado podem utilizar vários modelos de IA, dependendo da complexidade das tarefas e dos requisitos específicos do domínio. Se o agente precisa de um modelo de base específico, um modelo de linguagem pequeno ou um modelo ajustado para seu cenário, é fundamental selecionar o modelo certo.

Para obter mais informações, consulte Como escolher os modelos certos para seus aplicativos.

IA responsável

Certifique-se de que seu agente personalizado esteja em conformidade, seguro e alinhado com as políticas de IA Responsável (RAI) aderindo aos princípios de RAI, impondo a governança de dados e atendendo aos requisitos de publicação da loja para ISVs.

Considerações de custos

Considere os custos de licenciamento, consumo e hospedagem associados ao seu agente de mecanismo personalizado.

Para obter mais informações, consulte Considerações de custo para extensibilidade do Copilot.

Privacidade e conformidade

Os prompts e respostas personalizados do agente de mecanismo no Copilot Chat e no Teams são armazenados em conformidade com os termos e condições do produto Microsoft 365 e são gerenciados de acordo com as instruções do cliente. Para exibir e gerenciar esses dados armazenados, os administradores podem usar a Pesquisa de Conteúdo ou o Microsoft Purview.

Para obter mais informações sobre controles de governança e administração para agentes, consulte Governança e controles administrativos para compartilhamento de agentes.

Se você estiver criando um agente de mecanismo personalizado que chama as APIs do Microsoft 365 Copilot, confira Segurança e autenticação para APIs do Microsoft 365 Copilot para obter detalhes sobre como as APIs lidam com autenticação, autorização e imposição de políticas organizacionais.

Conteúdo relacionado

• Agentes do Microsoft 365 Copilot
• Criar e implantar um agente com o Copilot Studio
• Criar e implantar um agente com o SDK de Agentes do Microsoft 365
• Publicar seu agente Foundry no Microsoft 365
• Integrar seu agente Foundry ao Microsoft Agent Toolkit
• Criar um agente usando o Microsoft 365 Agent Toolkit
• Converta seu agente declarativo em um agente de mecanismo personalizado
• Exemplo de agente de mecanismo personalizado com base na API de recuperação
• Teams SDK
• Visão geral dos bots