Utilizar conectores do Power Platform como ferramentas

Os conectores do Microsoft Power Platform são proxies ou "wrappers" em torno de APIs que permitem ao Copilot Studio, Power Automate, Power Apps e Azure Logic Apps comunicar com outras aplicações e serviços. Os conectores permitem ligar as suas contas e utilizar ferramentas e acionadores pré-criados para criar as suas aplicações e fluxos de trabalho.

Com conectores, pode aceder a vários serviços (tanto dentro do ecossistema Microsoft como fora dele) para realizar automaticamente uma vasta gama de tarefas.

Existem muitos conectores disponíveis. Os conectores incluem ligações entre e para serviços Microsoft como Office 365, SharePoint e Dynamics 365, bem como ligações a serviços que não sejam da Microsoft como Twitter, Google Services, Salesforce e outros. Os conectores são categorizados como:

• Conectores pré-criados, que são ligações incorporadas a serviços populares disponíveis para utilização nos agentes do Copilot Studio. Estes incluem:

  • 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 ligar a qualquer API publicamente disponível para serviços não abrangidos pelos conectores existentes.

Integração com o Copilot Studio

Os conectores são ferramentas úteis que expandem significativamente a funcionalidade dos agentes do Copilot Studio. Os conectores ligam-no a vários serviços e aplicações externos para realizar uma vasta gama de tarefas. Com estes conectores pode criar agentes mais dinâmicos, reativos e úteis, adaptados às necessidades e processos específicos do negócio.

Pode chamar conectores como ferramentas no seu agente, no nível do agente ou num tópico.

Adicionar ferramentas de um conector pré-criado ao seu agente

Pode selecionar e adicionar ferramentas de conectores pré-criados diretamente ao seu agente. As ferramentas de conector representam ações ou operações específicas que quer que o seu agente efetue utilizando esse conector.

Para alguns conectores, as ferramentas são adicionadas uma de cada vez.

Para alguns conectores, pode adicionar várias ferramentas relacionadas de uma só vez como um grupo de ferramentas.

Adicionar uma única ferramenta a partir de um conector pré-criado

1. Selecione Agentes e selecione o agente ao qual quer adicionar um conector.

2. Aceda à página Ferramentas do seu agente e selecione Adicionar uma ferramenta.

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

4. Selecione o serviço ao qual pretende ligar-se ou procure o serviço pelo nome na caixa de pesquisa. Pode ver uma lista de ferramentas disponíveis para o conector de serviços.

5. Selecione a ferramenta que quer adicionar. O painel Adicionar ferramenta é aberto.

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

7. Quando terminar, selecione Enviar ou Criar, conforme aplicável.

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

   Por predefinição, a ligação está configurada para utilizar credenciais de utilizador. Para obter mais informações sobre os modos de autenticação suportados, consulte Configurar a autenticação de utilizador para ferramentas. Para alterar este comportamento, consulte a secção seguinte.

Adicionar várias ferramentas a partir de um conector pré-criado como um grupo de ferramentas

Alguns conectores permitem adicionar várias ferramentas relacionadas de uma só vez a um agente como um grupo de ferramentas.

Benefícios da utilização de grupo de ferramentas

Os grupos de ferramentas permitem equipar rapidamente os seus agentes com múltiplas ferramentas relacionadas de uma só vez, simplificando a configuração e melhorando a eficiência. Em vez de adicionar e configurar ferramentas individuais manualmente, pode adicionar grupos inteiros e aplicar configurações partilhadas entre eles.

Existem vários benefícios em utilizar grupos de ferramentas:

• Configuração mais rápida: Adicione várias ferramentas num só passo em vez de configurar cada uma individualmente.
• Consistência: As entradas partilhadas são aplicadas em todas as ferramentas do grupo.
• Flexibilidade: As entradas podem ser preenchidas dinamicamente por IA ou personalizadas manualmente.

Conectores que suportam 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

Passos para adicionar um grupo de ferramentas

1. Selecione Agentes e selecione o agente ao qual quer adicionar um conector.

2. Aceda à página Ferramentas do seu agente e selecione Adicionar uma ferramenta.

3. Selecione um conector que suporte grupos de ferramentas.

4. Selecione o serviço ao qual pretende ligar-se ou procure o serviço pelo nome na caixa de pesquisa. Pode ver uma lista de ferramentas disponíveis para o conector de serviços, apresentada em duas secções:

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

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

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

   Por predefinição, a ligação está configurada para utilizar credenciais de utilizador. Para obter mais informações sobre os modos de autenticação suportados, consulte Configurar a autenticação de utilizador para ferramentas. Para alterar este comportamento, consulte a secção seguinte.

7. Selecione Adicionar e configurar.

8. Configure as entradas para o grupo de ferramentas. Pode deixar uma entrada definida como Preencher 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 seu agente, selecione Criar.

Adicionar uma ferramenta de um conector pré-criado num tópico

1. Selecione Agentes e selecione o agente ao qual quer adicionar um conector.

2. Aceda à página Tópicos e selecione o tópico ao qual quer adicionar um conector.

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

4. Na janela de seleção de nós, selecione Adicionar uma ferramenta>Conector e procure a ferramenta de conector que quer adicionar.

5. Configure os detalhes da ligação conforme necessário para o conector.

6. Selecione Submeter.

   Por predefinição, a ligação está configurada para utilizar credenciais de utilizador. Para obter mais informações sobre os modos de autenticação suportados, consulte Configurar a autenticação de utilizador para ferramentas. Para alterar este comportamento, consulte a secção seguinte.

Criar um conector personalizado para adicionar a um agente

1. Selecione Agentes e selecione o agente ao qual quer adicionar um conector.

2. Aceda à página Ferramentas e selecione Adicionar uma ferramenta.

3. Selecione Nova ferramenta>Conector personalizado. É encaminhado para o portal do Power Apps na secção Conectores Personalizados.

4. Selecione Novo conector personalizado e selecione o método que quer utilizar para criar o conector.

Utilizar conectores com credenciais fornecidas pelo criador

Os conectores requerem um conjunto válido de credenciais. Por predefinição, os conectores estão configurados para pedir aos utilizadores (utilizadores do seu agente) que forneçam as suas credenciais para o serviço associado, quando a ferramenta é invocada. Para que o seu agente utilize as credenciais do criador, efetue os seguintes passos:

1. Configure o seu agente para utilizar um canal autenticado.
2. Adicione uma ferramenta de conector ao seu agente e configure-a.
3. Aceda à página Descrição geral da ferramenta de conector.
4. Em Detalhes>Detalhes adicionais>Credenciais a utilizar, selecione Credenciais fornecidas pelo criador.
5. Publique e teste a experiência no painel Testar o seu agente ou no canal pretendido.

Partilhar ligação

Para partilhar a sua ligação com outros:

1. Aceda a make.powerapps.com.
2. Selecione Ligações na barra de navegação esquerda.
3. Selecione a ligação e, em seguida, selecione Partilhar.
4. No diálogo Partilhar, procure o utilizador pretendido e selecione o utilizador.
5. Em Permissão, junto ao utilizador, selecione Pode utilizar + partilhar.