Estratégias de integração de planejamento e projeto

Agentes construídos no Copilot Studio ganham novos recursos por meio da integração com outros serviços online. Esses serviços podem incluir serviços da Microsoft, como SharePoint e Dataverse, serviços de terceiros como ServiceNow, Salesforce e Databricks e APIs personalizadas. O Power Platform oferece um ecossistema avançado de conectores internos que estão disponíveis para o Copilot Studio, portanto, você não precisa criá-los por conta própria. Você também tem várias opções para criar integrações personalizadas usando low-code ou pro-code. Os agentes podem expandir suas capacidades por meio do Model Context Protocol (MCP) para interagir com ferramentas e dados externos de forma padronizada e escalável, ou por meio do uso de computadores para automatizar aplicações web e desktop diretamente a partir de uma máquina virtual – possibilitando cenários de integração mais amplos mesmo quando nenhuma API está disponível.

Ao usar integrações, os agentes se tornam uma interface conveniente para acessar a funcionalidade de múltiplos sistemas. Os usuários podem realizar muitas operações diferentes sem precisar se afastar do agente. Por exemplo, um único agente projetado no Copilot Studio pode ser usado para:

• Ler, criar e atualizar itens em uma lista de SharePoint.
• Envie uma mensagem de email usando Office 365 Outlook.
• Abra um novo chamado de suporte no ServiceNow.

Considerações sobre padrões de integração

O Copilot Studio oferece suporte à integração por meio de conectores do Power Platform, solicitações HTTP, fluxos de agente, habilidades do Bot Framework e muito mais. A escolha do padrão de integração correto depende dos requisitos do projeto.

Conectores do Power Platform

Conectores permitem que agentes interajam com um serviço subjacente. Eles são um conjunto de ações e gatilhos expostos por meio de uma interface low-code. Ações são operações dirigidas por um agente, como leitura, gravação ou atualização. Os gatilhos notificam o agente quando ocorre um evento em outro serviço.

Use conectores pré-montados e conectores personalizados:

• Conectores predefinidos: a Microsoft oferece um grande ecossistema de conectores SaaS (software como serviço) prontos para uso com o Copilot Studio.
• Conectores personalizados: Quando não há conector pré-montado disponível, você pode montar seu próprio conector para um serviço. Elas são um wrapper sem código ou low-code para APIs REST.

Conectores Power Platform atendem a estes requisitos:

• Criadores que desenvolvem com o Power Platform estão familiarizados com conectores sem código ou de baixo código.
• O código Power Fx é suportado, incluindo variáveis, condições, parâmetros e mais.
• Análise sintática e tratamento de erros são integrados.
• Conectores pré-montados requerem apenas configuração, sem tempo de desenvolvimento.
• Conectores personalizados podem ser criados uma vez e usados em vários agentes.
• Capacidade de monitorar a atividade como parte da integração do Copilot Studio ao Application Insights (um recurso de Azure Monitor).
• Alguns conectores e conectores personalizados suportam redes virtuais.

Ao usar conectores Power Platform para integração, considere os seguintes pontos:

• Devolver centenas de resultados causa um atraso significativo na resposta do agente ao usuário.
• Conectores de terceiros pedem que os usuários insiram credenciais antes de poderem se conectar ao serviço. Um usuário pode não entender como fazer a conexão sem orientação. Considere usar credenciais de criador quando o usuário não tiver as informações necessárias para fazer a conexão.

Solicitações de HTTP

Agentes podem se integrar a outro serviço fazendo uma requisição HTTP. O desenvolvedor deve especificar esses valores toda vez ao fazer uma requisição HTTP:

• URI
• Método (GET, POST, PATCH, e assim por diante)
• Headers
• Corpo

As requisições HTTP atendem aos seguintes requisitos:

• Capacidade de conectar com serviços e realizar ações que não estão na lista de conectores pré-construídos.
• Tempo de desenvolvimento menor do que o de um conector personalizado.

Ao usar requisições HTTP, considere os seguintes fatores:

• Muitos criadores de low-code e no-code não entendem como configurar uma requisição HTTP e podem ter dificuldade para suportá-la.
• Você não pode compartilhar isso pela sua organização para reutilização, como conectores personalizados.

Fluxos de agente

Fluxos de agentes executam uma série de ações em uma sequência pré-definida. Eles usam as ações low-code encontradas nos conectores do Power Platform. Os agentes podem passar valores como entrada para um fluxo de agentes e receber suas saídas.

Os fluxos do agente são funcionalmente semelhantes aos fluxos de Power Automate cloud com algumas diferenças importantes:

• Fluxos de agentes podem permitir alta taxa de transferência e baixa latência.
• Os fluxos de agente oferecem mais recursos do que os fluxos de Power Automate, como ações de "intervenção humana".
• Os fluxos de agente consomem créditos Copilot com base em seu uso. Os fluxos do Power Automate geralmente são executados em um modelo de licenciamento por usuário ou por processo.

Fluxos de agentes atendem a estes requisitos:

• Sem código ou com pouco código.
• Encadeamento determinístico de ações.
• A atividade pode ser monitorada separadamente.
• Oculta valores sensíveis como chaves e segredos nas ações de fluxo. Obtém credenciais de Azure Key Vault para autenticação.
• Gerencia grandes volumes de dados e tamanhos de arquivo.
• Usa simultaneidade e threads de execução paralela para permitir melhor desempenho.
• Fluxos de nuvem Power Automate existentes podem ser convertidos em fluxos de agente.

Ao projetar um agente que utilize fluxos de agentes, considere os seguintes pontos:

• O desempenho é limitado pelos limites da API dos serviços e ações que ele inclui.
• O desenvolvedor deve projetar um padrão de tratamento de erros para que o agente saiba como lidar com exceções.
• A resposta do fluxo ao agente tem um limite de tamanho.
• Lógica de longa duração pode continuar a ser executada após a ação de Responder ao Agente.

Habilidades do Bot Framework

Habilidades são blocos reutilizáveis de construção de habilidades conversacionais que você constrói usando o Bot Framework. Implemente habilidades utilizando linguagens de programação profissional. Registre as habilidades no Copilot Studio para usá-las. Depois de registrar uma habilidade no Copilot, você pode acioná-la como um nó em um tópico de conversa.

As habilidades do Bot Framework atendem aos seguintes requisitos:

• Execução síncrona.
• Suporte para endereços de rede privados.
• As habilidades existentes do Bot Framework podem ser reutilizadas no Copilot Studio.

Ao usar habilidades do Bot Framework, considere os seguintes fatores:

• Requer pro-code para desenvolvimento contínuo e suporte (por exemplo, C#).
• É executado no Azure AI Bot Service.
• Você incorre em custos adicionados em Azure que você deve cobrir com uma assinatura Azure.
• O Gerenciamento do Ciclo de Vida de Aplicações (ALM) está fora do Power Platform.

Outras considerações para padrões de integração

Juntamente com as orientações para cada tipo de integração, considere os seguintes pontos para uma estratégia geral de integração:

• A integração de padrões do Copilot Studio não é exclusiva e pode ser combinada.
• As integrações são tão rápidas quanto os endpoints aos quais se conectam.
• Sempre otimize as consultas para devolver resultados o mais rápido possível, proporcionando uma boa experiência de conversa.
• Onde os fluxos de agentes e o Copilot Studio não executam a lógica rapidamente o suficiente, considere estas opções:
  • APIs personalizadas do Dataverse
  • Plugins de baixo código do Dataverse
  • Funções de Azure
• Cenários específicos exigem que a integração dos dados seja realizada em uma camada intermediária que modifica as mensagens conforme as retransmite.

Adicionando integrações a um agente

Adicione integrações a um agente usando os seguintes métodos:

• Ferramentas

  • Conecte a integração como uma ferramenta para expandir a funcionalidade de um agente.
  • Use linguagem natural para descrever quando o orquestrador deve selecionar a ferramenta para cumprir uma tarefa.
  • Defina como o agente deve determinar os valores de entrada da ferramenta e como deve ser a saída. A IA generativa pode preencher dinamicamente entradas com base em uma descrição, ou você pode definir manualmente valores e fórmulas.
  • Invocar como parte de um plano criado por orquestração generativa.

• Topics

  • Chame uma integração através de um nó do tópico. Executa na mesma posição na sequência do tópico a cada vez.
  • Forneça entradas de dados para o nó usando o Power Fx.

• Agentes

  • Crie um agente filho que tenha seu próprio conjunto de instruções e defina o acesso ao conhecimento e às ferramentas disponíveis para o agente pai.
  • Como alternativa, conecte-se a um agente existente no Copilot Studio, Microsoft 365 SDK, Microsoft Foundry, Fabric, Agent-To-Agent e assim por diante.

Cotas e limites

Examine os limites de serviço atuais para o Copilot Studio e o Power Platform:

• Copilot Studio cotas e limites
• Limites do Power Automate
• Limites e alocações de solicitações do Power Platform
• Limites do Power Platform Connector, listados na página individual de cada conector.

Você deve determinar os limites da API para esses serviços separadamente:

• Capacidade da OpenAI: Os limites de taxa não são documentados.
• Bot Framework skills: Verifique a documentação do Azure para os serviços específicos usados.

Exemplo de visão geral de planejamento de integrações

Ao planejar integrações com o Copilot Studio, determine as seguintes informações para cada serviço:

• Sistema conectado: O serviço com o qual você está se conectando.
• Chamado por: o componente bot no Copilot Studio que aciona o serviço.
• Chamado com: o tipo de integração selecionado.
• Volume diário esperado: O número médio de pedidos.
• Pico esperado: O maior número esperado de solicitações diárias.
• Detalhes: Outras informações sobre a integração.

Aqui está um exemplo de um agente com múltiplas integrações:

Próxima etapa

Saiba como os prompts de IA, Protocolo de Contexto do Modelo e agentes de uso do computador podem estender as capacidades do agente.

Informações relacionadas

• Visão geral dos fluxos de agentes
• Usar conectores do Power Platform como ferramentas
• Adicionar outros agentes
• Expanda seu agente com ferramentas de uma API REST