Escolha a ferramenta certa para criar seu agente declarativo

Os agentes declarativos permitem que você estenda o Microsoft 365 Copilot para atender às necessidades exclusivas de seus usuários. Você pode criar agentes declarativos usando uma abordagem pro-code, low-code ou no-code. Este artigo fornece informações sobre as ferramentas disponíveis para criar agentes declarativos e os prós e contras de cada um.

Ferramentas para criar agentes declarativos

Várias ferramentas estão disponíveis para ajudá-lo a criar agentes declarativos para o Copilot. A tabela a seguir lista as ferramentas e os possíveis casos de uso de cada uma para ajudá-lo a decidir qual ferramenta é ideal para você.

Ferramenta Abordagem de codificação Descrição Caso de uso recomendado
Microsoft 365 Agents Toolkit Código profissional O Agents Toolkit permite a criação de agentes declarativos e agentes de mecanismo personalizados com recursos avançados, como ações de API personalizadas, Cartões Adaptáveis, o SDK de Agentes do Microsoft 365, o Microsoft 365 Agents Playground para testes locais e integração de CI/CD (Integração Contínua/Entrega Contínua). Desenvolvedores que precisam de controle total sobre seu ambiente de codificação, controle do código-fonte e integração direta com APIs.
Copilot Studio Low-code O Copilot Studio permite que os usuários criem agentes declarativos usando uma interface de arrastar e soltar. Ele fornece controle sobre a lógica de negócios e a automação do fluxo de trabalho e permite que os usuários criem agentes declarativos com recursos avançados, como ações de API personalizadas, Cartões Adaptáveis e ALM (gerenciamento do ciclo de vida do aplicativo) por meio de pipelines do Power Platform. Profissionais de informações e usuários de negócios que precisam de uma solução low-code e fácil de usar que inclua integração com o Power Platform.
Construtor de Agentes Sem código O recurso Construtor de Agentes do Microsoft 365 Copilot oferece uma interface simples para que os usuários empresariais criem agentes declarativos. Os usuários só precisam descrever o que o agente deve fazer ou criar um agente com uma experiência de configuração simples. Usuários corporativos sem experiência em codificação que desejam personalizar o Copilot para aumentar a produtividade pessoal e do grupo. Do treinador de redação ao amigo de integração, os usuários podem facilmente criar e compartilhar agentes que respondem a perguntas de fontes de conhecimento, geram imagens, processam dados, resolvem problemas matemáticos e muito mais.
SharePoint Sem código Os agentes criados no SharePoint são agentes declarativos executados no SharePoint, no Teams e no Microsoft 365 Copilot. Eles fornecem respostas com base nos dados disponíveis na implementação do SharePoint de uma organização. Usuários de negócios que desejam personalizar o Copilot para uma finalidade específica ou especificar sites, bibliotecas de documentos e arquivos específicos para o Copilot pesquisar.

Requisitos e acesso à ferramenta

A tabela a seguir descreve os pré-requisitos para usar cada ferramenta e onde os agentes de cada uma podem ser publicados.

Ferramenta Requisitos Acesso à ferramenta Publica agentes em
Kit de Ferramentas de Agentes
  • Assinatura do Microsoft 365 (com sideload habilitado)
  • Visual Studio Code, Visual Studio ou CLI do Kit de Ferramentas de Agentes
  • Assinatura do Azure (opcional)
Obtenha o Microsoft 365 Agents Toolkit para Visual Studio Code, Visual Studio ou como uma CLI.
  • Usuários com assinaturas do Microsoft 365 (com recursos limitados)
  • Usuários com licenças ou medição do Microsoft 365 Copilot habilitadas
Copilot Studio
  • Assinatura do Microsoft 365
  • Uma licença do Copilot Studio — uma assinatura autônoma do Copilot Studio ou o plano do Copilot Studio para Microsoft Teams incluído em assinaturas selecionadas do Microsoft 365 (compare os planos)
Inscreva-se no Copilot Studio.
  • Usuários com assinaturas do Microsoft 365 (com recursos limitados)
  • Usuários com licenças ou medição do Microsoft 365 Copilot habilitadas
  • Aplicativos móveis, plataformas de mensagens
Construtor de Agentes Assinatura do Microsoft 365 Selecione a opção Criar agente no Microsoft 365 Copilot ou no Teams.
  • Usuários com assinaturas do Microsoft 365 (com recursos limitados)
  • Usuários com licenças ou medição do Microsoft 365 Copilot habilitadas
SharePoint
  • Assinatura do Microsoft 365
  • Permissões de administrador ou proprietário do site
Introdução ao SharePoint. Sites do SharePoint, Microsoft 365 Copilot e Microsoft Teams

Kit de Ferramentas de Agentes

Se o seu cenário envolve o controle total, a escalabilidade e a integração direta da API de uma abordagem pró-código, o Agents Toolkit é a melhor ferramenta a ser usada para criar seu agente declarativo.

Dica

Ferramentas de desenvolvimento do Work IQ (versão prévia)wiqd não é uma ferramenta de criação separada. É uma camada de linha de comando sobre o ciclo de vida do agente declarativo que é distribuída para o Agents Toolkit para provisionamento. Você pode conduzir, validar, empacotar e publicar etapas de um terminal ou CI enquanto ainda usa o Agents Toolkit abaixo. Para obter mais informações, consulte a documentação do Work IQ Dev Tools.

A tabela a seguir lista os prós e contras do uso do Kit de ferramentas de agentes.

Observação

Não há suporte para a publicação de agentes por meio do Kit de Ferramentas de Agentes do Microsoft 365 em locatários do Microsoft 365 Government .

Vantagens Desvantagens
Flexibilidade de código profissional: Ideal para desenvolvedores que preferem o Visual Studio Code, o Visual Studio ou uma CLI e desejam controle total sobre seu ambiente de codificação, controle do código-fonte e acesso a APIs. Sem suporte a conectores do Power Platform: Ao contrário do Copilot Studio, o Agents Toolkit não oferece suporte a conectores do tipo "arrastar e soltar" do Power Platform para integração rápida de API.
Ações de API personalizadas: Permite a integração com qualquer API usando especificações OpenAPI ou APIs REST personalizadas, fornecendo flexibilidade além dos conectores do Power Platform. Sem interface do usuário: Requer edição manual JSON para configuração do agente, em vez de edição baseada na interface do usuário.
Controle de versão e colaboração: Oferece suporte a sistemas de controle do código-fonte, solicitações pull e CI/CD para melhores práticas de desenvolvimento e colaboração em equipe. Composabilidade limitada para fabricantes: Os agentes integrados ao Agents Toolkit não podem ser reutilizados em ferramentas de pouco código, como o Copilot Studio.
Adoção rápida de recursos: Os novos recursos geralmente estão disponíveis primeiro no Agents Toolkit antes de estarem disponíveis no Copilot Studio ou no Agent Builder. Curva de aprendizado mais íngreme: O Agents Toolkit foi projetado para desenvolvedores profissionais, o que pode ser menos acessível para usuários corporativos e operadores de informações.
Teste local com o Agents Playground: O Playground de agentes do Microsoft 365 fornece uma área restrita local para testar e depurar agentes sem um locatário de desenvolvedor do Microsoft 365 ou serviços de encapsulamento como o ngrok.
Integração do SDK de Agentes do Microsoft 365: crie agentes de mecanismo personalizados e publique em vários canais, incluindo Microsoft 365 Copilot, Teams, web, email e SMS.
Suporte avançado para Cartões Adaptáveis: Habilita a renderização personalizada da interface do usuário dentro de agentes usando Cartões Adaptáveis, com a experiência de criação mais avançada entre as ferramentas disponíveis.
Pacote de aplicativos complexos: Permite a integração de agentes com aplicativos do Teams, guias pessoais, extensões de mensagens e outros aplicativos do Microsoft 365.
Suporte à experimentação: Os desenvolvedores podem bifurcar, testar e iterar os recursos do agente sem afetar as implantações ativas.
Conectores do Copilot e aprimoramentos de IA: Dá suporte a integrações avançadas, incluindo pesquisa semântica com conectores do Microsoft 365 Copilot e mais controle sobre o raciocínio e as respostas do agente.

Construtor de Agentes

O Construtor de Agentes no Microsoft 365 Copilot é uma ótima opção para usuários sem experiência em codificação que precisam de um processo guiado para criar agentes declarativos. Você pode acessar o Agent Builder no Microsoft 365 Copilot por meio dos seguintes aplicativos e caminhos:

  • Aplicativo Microsoft 365 Copilot: selecione a opção Criar agente.
  • Microsoft Teams: Selecione a guia Microsoft 365 Copilot, expanda a navegação e escolha Criar agente.
Vantagens Desvantagens
Facilidade de uso: Projetado para que os usuários criem agentes diretamente no Microsoft 365 Copilot sem experiência em codificação, usando uma interface de linguagem natural. Fluxos de trabalho complexos: Não oferece suporte a fluxos de trabalho e integrações complexos.
Configuração rápida: Fornece um processo guiado para agentes de construção. Distribuição de recursos mais lenta: Alguns recursos avançados estão disponíveis no Agents Toolkit antes de serem disponibilizados no Agent Builder.
Acessibilidade: Adequado para criar agentes de produtividade pessoal e em grupo sem precisar escrever código, com a opção de enviar o agente para o catálogo da organização.
Teste de agente simples: O painel de teste permite que os usuários testem a experiência do usuário do agente diretamente na ferramenta.
Variedade de fontes de conhecimento: Adicione facilmente dados públicos da Web, do SharePoint, do conector do Copilot e muito mais como fontes de conhecimento do agente.
Gere conteúdo avançado: A geração de imagens e o interpretador de código são habilitados por padrão.

Copilot Studio

O Microsoft Copilot Studio foi projetado para implantações em pequena escala, como soluções em nível de departamento. É uma ótima alternativa para pessoas que precisam de uma ferramenta de baixo código que seja fácil de usar e que se integre ao Microsoft Power Platform.

Vantagens Desvantagens
Fácil de usar: o Copilot Studio fornece uma abordagem de baixo código que permite que usuários de negócios e operadores de informações criem e personalizem agentes usando uma interface de arrastar e soltar sem codificação. Menos controle do desenvolvedor: Capacidade limitada de ajustar chamadas, ações e formatação de resposta de API em comparação com um ambiente de código profissional.
Conectores do Power Platform: Habilite a integração rápida da API plug-and-play usando centenas de conectores predefinidos. Ferramentas pró-desenvolvimento menos maduras: O controle do código-fonte e a CI/CD têm suporte por meio de pipelines do Power Platform, integração nativa do Git e o modelo Copilot ALM Starter , mas a experiência é menos integrada do que o fluxo de trabalho baseado em projeto no Kit de Ferramentas de Agentes.
Ótimo para uso pessoal e departamental: Configuração rápida para agentes menores e direcionados que não exigem governança corporativa em larga escala. Cartões Adaptáveis limitados ao esquema 1.6: Dá suporte a Cartões Adaptáveis (esquema 1.6 e anteriores) para mensagens, perguntas e renderização de dados de API em plug-ins de API. Alguns cenários de criação avançada permanecem mais fáceis no Kit de ferramentas de agentes.
Governança e implantação pré-criadas: Os agentes são implantados usando as ferramentas de gerenciamento integradas do Copilot Studio, reduzindo a complexidade para as equipes de TI. Distribuição de recursos mais lenta: Alguns recursos avançados estão disponíveis no Agents Toolkit antes de serem disponibilizados no Copilot Studio.
Agente de teste integrado: o Copilot Studio vem com um agente de teste integrado que permite testar o agente em tempo real.

SharePoint

A opção do SharePoint é adequada para proprietários ou editores de sites que desejam criar agentes personalizados para cenários específicos no ambiente do SharePoint. Os usuários com permissões de edição de site podem criar agentes personalizados alterando o escopo, a identidade e o comportamento do conteúdo de vários locais no site do SharePoint.

Vantagens Desvantagens
Personalização: Proprietários de sites, proprietários de conteúdo ou editores podem criar agentes adaptados para necessidades específicas. Limitações de conteúdo: Assim como acontece com todos os agentes, se o agente não conseguir encontrar informações em suas fontes de conhecimento definidas, ele poderá fornecer conteúdo desatualizado da Internet.
Fontes definidas: Os agentes se baseiam no contexto de sites e bibliotecas de documentos específicos do SharePoint. Escalabilidade: Não é adequado para aplicações em grande escala ou altamente complexas.
Facilidade de acesso: Integrado diretamente ao SharePoint, facilitando o acesso e a interação dos usuários com os agentes. Limitações de funcionalidade e visibilidade: Quando usados no Copilot Chat, os agentes declarativos criados no SharePoint não podem se integrar ou usar agentes declarativos criados fora do SharePoint.
Experiência de usuário personalizada: Fornece uma experiência de usuário personalizada com base no conteúdo específico do SharePoint.
Integração com o SharePoint: Usa recursos existentes do SharePoint, como bibliotecas de documentos.
Integração com o Teams: Os agentes do SharePoint são detectáveis diretamente nos chats do Microsoft Teams e na Teams Store na categoria Agentes , para que os usuários possam adicioná-los aos chats na opção Adicionar agentes e bots .