Use conectores do Power Platform como ferramentas

Conectadores de Microsoft Power Platform atuam como proxies ou "wrappers" em torno de APIs. Eles permitem que Copilot Studio, Power Automate, Power Apps e Azure Logic Apps se comuniquem com outros aplicativos e serviços. Ao usar conectores, você pode conectar suas contas e usar ferramentas e gatilhos pré-configurados para construir seus aplicativos e fluxos de trabalho.

Ao usar conectores, você pode acessar vários serviços (tanto dentro quanto fora do ecossistema Microsoft) para realizar uma ampla variedade de tarefas automaticamente.

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

• Conectadores predefinidos, que são conexões internas com serviços populares disponíveis para uso em agentes do Copilot Studio. Esses conectores incluem:

  • conectores Standard, como SharePoint, que estão incluídos em todos os planos do Copilot Studio.
  • Premium connectors, que estão disponíveis nos planos selecionados do Copilot Studio.

• Conectores personalizados, que você usa para conectar a qualquer API publicamente disponível para serviços não cobertos pelos conectores existentes.

Integração com o Copilot Studio

Conectores são ferramentas úteis que estendem muito a funcionalidade dos agentes do Copilot Studio. Ao usar conectores, você pode se conectar a vários serviços e aplicativos externos para realizar uma ampla variedade de tarefas. Ao usar esses conectores, você pode criar agentes mais dinâmicos, responsivos e úteis, adaptados às necessidades e processos específicos do negócio.

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. Ferramentas de conectores representam ações ou operações específicas que você quer que seu agente execute usando esse conector.

Adicione uma ferramenta a partir de um conector pré-montado

1. Selecione Agentes e selecione o agente ao qual você deseja adicionar 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ê vê uma lista de ferramentas disponíveis para o conector de serviço.

5. Selecione a ferramenta que você deseja adicionar. O painel Adicionar ferramentas é 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 usa credenciais de usuário. Para obter mais informações sobre os modos de autenticação com suporte, consulte Configurar a autenticação de usuário para ferramentas. Para alterar esse comportamento, consulte a seção a seguir.

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

1. Selecione Agentes e selecione o agente ao qual você deseja adicionar um conector.

2. Vá para a página Tópicos e selecione o tópico ao qual você deseja adicionar um conector.

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

4. Na janela de seleção do nó, selecione Adicionar uma ferramenta>Conector e pesquise 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 usa credenciais de usuário. Para obter mais informações sobre os modos de autenticação com suporte, consulte Configurar a autenticação de usuário para ferramentas. Para alterar esse comportamento, veja Criar um conector personalizado para adicionar a um agente.

Criar um conector personalizado para adicionar a um agente

1. Selecione Agentes e selecione o agente ao qual você deseja adicionar um conector.

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

3. Selecione Nova ferramenta>conector personalizado. Você será direcionado para o portal do Power Apps na seção Conectores customizados.

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

Usar conectores com credenciais fornecidas pelo fabricante

Conectores precisam de um conjunto válido de credenciais. Por padrão, os conectores pedem que os usuários (usuários do seu agente) insiram suas credenciais para o serviço associado ao usarem a ferramenta. Para que seu agente use as credenciais do fabricante, siga estes passos:

1. Configure seu agente para usar um canal autenticado.
2. Adicione uma ferramenta de conector ao seu agente e configurá-la.
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 seu 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.

Limitações

• Não há suporte para SSO (autenticação única) para conectores quando um agente usa autenticação Active Directory personalizada e o agente é implantado no Microsoft Teams. Nessa configuração, os conectores não podem usar SSO, e os usuários devem autenticar manualmente cada conector. Para permitir que os usuários se conectem com êxito, verifique se as conexões necessárias estão configuradas no Copilot Studio. Para orientações sobre como configurar conexões, veja Configurar e gerenciar conexões.