Use conectores do Power Platform como ferramentas

Os conectores do Microsoft Power Platform são proxies ou "wrappers" em torno das APIs que permitem que o Copilot Studio, o Power Automate, o Power Apps e os Aplicativos Lógicos do Azure se comuniquem com outros aplicativos e serviços. Os conectores permitem conectar suas contas e usar ferramentas e gatilhos predefinidos para criar seus aplicativos e fluxos de trabalho.

Com conectores, você pode ter acesso a serviços variados (tanto dentro quanto fora do ecossistema Microsoft) para realizar automaticamente uma grande variedade de tarefas.

Existem muitos conectores disponíveis. Entre os conectores estão conexões entre e para serviços da Microsoft, como Office 365, SharePoint e Dynamics 365, bem como conexões com serviços que não sejam da Microsoft, como Twitter, serviços do Google, Salesforce e muito mais. Os conectores são categorizados como:

• Conectores predefinidos, que são conexões integradas para serviços populares disponíveis para uso em agentes do Copilot Studio. Isso inclui:

  • Conectores padrão, como o SharePoint, que estão incluídos em todos os planos do Copilot Studio.
  • Conectores Premium, que estão disponíveis em Planos do Copilot Studio selecionados.

• Conectores personalizados, que permitem a você se conectar a qualquer API disponível publicamente para serviços sem cobertura de conectores existentes.

Integração com o Copilot Studio

Conectores são ferramentas úteis que estendem muito a funcionalidade de agentes do Copilot Studio. Os conectores ligam você a serviços e aplicativos externos variados para realizar uma grande variedade de tarefas. Com esses conectores, você pode criar agentes mais dinâmicos, responsivos e úteis, adaptados a necessidades e processos específicos de negócios.

Você pode chamar conectores como ferramentas no agente, no nível do agente ou em um tópico.

Adicionar ferramentas de um conector predefinido ao agente

Você pode selecionar e adicionar diretamente ferramentas de conectores predefinidos ao agente. As ferramentas de conector representam ações ou operações específicas que você deseja que o agente realize usando esse conector.

Para alguns conectores, você adiciona ferramentas uma por vez.

Para alguns conectores, você pode adicionar várias ferramentas relacionadas ao mesmo tempo como um grupo de ferramentas.

Adicionar uma única ferramenta de um conector predefinido

1. Selecione Agentes e escolha o agente que você deseja adicionar a um conector.

2. Vá até a página Ferramentas do agente e selecione Adicionar uma ferramenta.

3. Selecione Conector. Os serviços diferentes com conectores disponíveis são exibidos.

4. Selecione o serviço ao qual você deseja se conectar ou procure o serviço por nome na caixa de pesquisa. Você pode ver uma lista das ferramentas disponíveis para o conector de serviço.

5. Selecione a ferramenta que você deseja adicionar. O painel Adicionar ferramenta é aberto.

6. Se a conexão ainda não existir, selecione Criar nova conexão. Os detalhes da configuração da conexão dependem do conector selecionado por você.

7. Selecione Enviar ou Criar , conforme aplicável quando terminar.

8. Selecione Adicionar e configurar. A página de configuração da nova ferramenta abre, mostrando a nova ferramenta e os detalhes.

   Por padrão, a conexão é configurada para usar credenciais do usuário. Para obter mais informações sobre os modos de autenticação com suporte, consulte Configurar autenticação de usuário para ferramentas. Para alterar esse comportamento, consulte a seção a seguir.

Adicionar várias ferramentas de um conector predefinido como um grupo de ferramentas

Alguns conectores permitem adicionar várias ferramentas relacionadas ao mesmo tempo a um agente como um grupo de ferramentas.

Vantagens de usar grupos de ferramentas

Os grupos de ferramentas permitem a você equipar rapidamente os agentes com várias ferramentas relacionadas ao mesmo tempo, otimizando a configuração e aumentando a eficiência. Em vez de adicionar e configurar manualmente ferramentas individuais, você pode adicionar grupos inteiros e aplicar configurações compartilhadas entre eles.

Existem diversas vantagens em usar grupos de ferramentas:

• Configuração Rápida: adicione várias ferramentas em uma única etapa, em vez de configurar cada uma individualmente.
• Consistência: entradas compartilhadas são aplicadas em todas as ferramentas do grupo.
• Flexibilidade: as entradas podem ser preenchidas dinamicamente por IA ou personalizadas manualmente.

Conectores que dão suporte a grupos de ferramentas

Atualmente, dois conectores permitem adicionar várias ferramentas relacionadas de uma só vez como um grupo de ferramentas:

• Conector do Office 365 Outlook
• Conector do SharePoint

Grupos de ferramentas do Office 365 Outlook

Grupos de ferramentas do SharePoint

Etapas para adicionar um grupo de ferramentas

1. Selecione Agentes e escolha o agente que você deseja adicionar a um conector.

2. Vá até a página Ferramentas do agente e selecione Adicionar uma ferramenta.

3. Selecione um conector que dê suporte aos grupos de ferramentas.

4. Selecione o serviço ao qual você deseja se conectar ou procure o serviço por nome na caixa de pesquisa. Você pode ver uma lista de ferramentas disponíveis para o conector de serviço, apresentada em duas seções:

   • Adicionar várias ferramentas
   • Adicionar uma única ferramenta

5. Em Adicionar várias ferramentas, selecione o grupo de ferramentas a ser adicionado.

6. Se a conexão ainda não existir, selecione Criar nova conexão e configure a conexão.

   Por padrão, a conexão é configurada para usar credenciais do usuário. Para obter mais informações sobre os modos de autenticação com suporte, consulte Configurar autenticação de usuário para ferramentas. Para alterar esse comportamento, consulte a seção a seguir.

7. Selecione Adicionar e configurar.

8. Configure as entradas do grupo de ferramentas. Você poderá deixar um conjunto de entradas como Preenchimento dinamicamente com IA se quiser que a IA preencha essas entradas em runtime.

9. Para adicionar todas as ferramentas do grupo selecionado à lista de ferramentas do agente, selecione Criar.

Adicionar uma ferramenta de um conector predefinido em um tópico

1. Selecione Agentes e escolha o agente que você deseja adicionar a um conector.

2. Vá até a página Tópicos e selecione o tema ao qual deseja adicionar um conector.

3. Selecione Adicionar nó (+) na tela de criação.

4. Na janela da seleção de nós, escolha Adicionar uma ferramenta>Conector e procure a ferramenta de conector que você deseja adicionar.

5. Configure detalhes de conexão conforme necessário para o conector.

6. Selecione Enviar.

   Por padrão, a conexão é configurada para usar credenciais do usuário. Para obter mais informações sobre os modos de autenticação com suporte, consulte Configurar autenticação de usuário para ferramentas. Para alterar esse comportamento, consulte a seção a seguir.

Criar um conector personalizado para adicionar a um agente

1. Selecione Agentes e escolha o agente que você deseja adicionar a um conector.

2. Vá até a página Ferramentas e selecione Adicionar uma ferramenta.

3. Selecione Nova ferramenta>Conector personalizado. Você é levado até o portal do Power Apps na seção Conectores personalizados.

4. Selecione Novo conector personalizado e selecione o método que deseja usar para criar o conector.

Usar conectores com credenciais fornecidas pelo fabricante

Os conectores exigem um conjunto válido de credenciais. Por padrão, os conectores são configurados para solicitar aos usuários (do agente) as credenciais do serviço associado quando a ferramenta é invocada. Para que o agente use as credenciais do criador, realize as seguintes etapas:

1. Configure seu agente para usar um canal autenticado.
2. Adicione uma ferramenta do conector ao agente e a configure.
3. Vá até a página Visão geral da ferramenta do conector.
4. Em Detalhes>Detalhes adicionais>Credenciais a serem usadas, selecione Credenciais fornecidas pelo criador.
5. Publique e teste a experiência no painel Testar o agente ou no canal desejado.

Compartilhar conexão

Para compartilhar suas conexões com outras pessoas:

1. Acesse make.powerapps.com.
2. Selecione Conexões na barra de navegação esquerda.
3. Selecione a conexão e escolha Compartilhar.
4. Na caixa de diálogo Compartilhar, pesquise o usuário desejado e selecione-o.
5. Em Permissão, próximo ao usuário, selecione Pode usar + compartilhar.