Usar um conector personalizado em um fluxo de trabalho de aplicativo lógico

Observação

Este artigo faz parte de uma série de tutoriais sobre a criação e o uso de conectores personalizados nos Aplicativos Lógicos do Azure, no Microsoft Power Automate e no Microsoft Power Apps e usando conectores habilitados no Microsoft Copilot Studio. Certifique-se de ler a visão geral do conector personalizado para entender o processo.

Vá para Usar conectores do Power Platform no Copilot Studio para saber como você pode chamar os conectores como ações de conector em seu agente do Microsoft Copilot.

Neste artigo, você cria um exemplo de fluxo de trabalho do aplicativo lógico de consumo que mostra como usar o conector personalizado criado em um tutorial anterior. Este exemplo de fluxo de trabalho é acionado quando um item é adicionado a uma lista do SharePoint Online. O fluxo de trabalho então usa o conector personalizado para chamar a API de Análise de Texto dos Serviços Cognitivos. O conector retorna a pontuação de sentimento (0 a 1) para o texto no item da lista e o fluxo de trabalho grava a pontuação novamente na lista.

O exemplo a seguir mostra o fluxo de trabalho do aplicativo lógico terminado:

Pré-requisitos

• Uma Assinatura do Office 365 Business Premium ou inscreva-se em uma avaliação gratuita.

• Uma conta e assinatura do Azure.

• Experiência básica de criação de aplicativos lógicos. Saiba mais em Compilar seu primeiro fluxo de trabalho de aplicativo lógico.

• O conector personalizado que você criou em um destes artigos:

  • Criar um conector personalizado de uma definição OpenAPI
  • Criar um conector personalizado com base em uma coleção do Postman

• (Se o seu conector personalizado acessar recursos locais usando o gateway de dados locais), configure a instalação de gateway para permitir acesso de saída para os conectores predefinidos correspondentes endereços IP de saída. Todos os aplicativos lógicos na mesma região usam os mesmos intervalos de endereços IP.

  Saiba mais em Ajustar as configurações de comunicação para o gateway de dados local e Configurar definições de proxy no gateway de dados locais.

Criar a lista do SharePoint Online

Primeiro, crie uma lista de três colunas no SharePoint Online. Essa lista armazena dados de revisão de filmes que o fluxo de trabalho do aplicativo lógico analisa quanto ao sentimento. Saiba mais sobre listas do SharePoint Online em Introdução às listas.

1. No site do SharePoint Online, selecione Nova>Lista para criar uma nova lista.

2. No campo Nome, digite Críticas de Filmes

3. Selecione Criar.

   Por padrão, o SharePoint Online cria a lista com uma coluna Título.

4. Selecione o sinal de adição >Linha única de texto.

5. Digite o nome Crítica e selecione Salvar.

6. Para adicionar outra coluna usando Número como o tipo de dados e Pontuação como o nome, repita as etapas 3 e 4.

Criar um recurso do aplicativo lógico

Agora que você tem uma lista, crie um recurso de aplicativo lógico de Consumo e fluxo de trabalho no portal do Azure.

1. Entre no portal do Azure com as credenciais da sua conta do Azure.

2. Na caixa de pesquisa do portal, digite aplicativo lógico e selecione Aplicativos lógicos.

3. Selecione o plano de Consumo.

4. Digite as seguintes informações para o recurso do seu aplicativo lógico:

   Propriedade	Valor	Description
   Assinatura	<Azure-subscription-name>	O nome da sua assinatura do Azure.
   Grupo de Recursos	<resource-group-name>	O nome do grupo de recursos do Azure usado para organizar recursos relacionados. Este exemplo usa My-First-LA-RG.
   Nome do Aplicativo Lógico	<logic-app-name>	O nome do seu aplicativo lógico. Este exemplo usa SentimentAnalysis.
   Região	<Azure-region>	A região do Azure para hospedar seu aplicativo lógico. Observação: seu recurso de aplicativo lógico e conector personalizado devem existir na mesma região. Este exemplo usa Leste dos EUA 2.
   Habilitar análise de logs	No	Manter o log de diagnósticos habilitado.

5. Conclua a criação do aplicativo lógico.

6. Depois que o Azure implantar seu aplicativo, selecione Ir para o recurso.

   Como alternativa, localize e selecione seu aplicativo lógico inserindo o nome na caixa de pesquisa Azure.

Adicionar um gatilho

Como primeira etapa em seu fluxo de trabalho, adicione um gatilho do SharePoint. Este gatilho é acionado quando um item é adicionado à lista do SharePoint Online especificada.

1. No menu do aplicativo lógico, em Ferramentas de Desenvolvimento, selecione Designer de aplicativo lógico, se ainda não estiver selecionado.

2. No designer, selecione Adicionar um gatilho.

3. Na caixa de pesquisa do painel da galeria de conectores, digite SharePoint e selecione o gatilho do SharePoint chamado Quando um item é criado. Se o gatilho não aparecer na lista, no canto superior direito da lista de gatilhos do SharePoint, selecione Ver mais.

   

4. Depois que o painel Criar Conexão for aberto, entre com suas credenciais do SharePoint.

5. Forneça as seguintes informações para o gatilho do SharePoint:

   Parâmetro	Valor
   Endereço do Site	<SharePoint-site-address>
   Nome da Lista	Críticas de Filmes

6. Expanda a seção chamada Com que frequência você deseja verificar se há itens para concluir a configuração do gatilho:

   Parâmetro	Valor
   Intervalo	10
   Frequência	Second

   Quando você terminar, seu gatilho se parecerá com o exemplo a seguir:

   

Adicionar uma ação do conector personalizado

Após o gatilho, você pode adicionar uma ou mais ações a serem executadas. Para adicionar uma ação do conector personalizado, execute estas etapas:

1. No gatilho, selecione o sinal de adição (+) e escolha Adicionar uma ação.

2. Na caixa de pesquisa do painel da galeria do conector, digite o nome do conector personalizado, que é SentimentDemo neste exemplo, e selecione a ação desejada.

   Dica

   Para facilitar a pesquisa, em Runtime, selecione Personalizado.

   

   O nome e a descrição da ação vêm das informações fornecidas quando você criou o conector.

3. Insira um nome para a conexão e a chave de API.

   Parâmetro	Valor
   Nome da Conexão	Um nome da conexão, por exemplo, SentimentDemoConnection.
   Chave de API	A chave da API de Análise de Texto. Para saber mais, consulte Obter uma chave de API.

4. Forneça as informações para a ação, por exemplo:

   Parâmetro	Valor
   ID dos documentos	1 Esse valor é necessário porque o conector pode lidar com vários documentos. Este exemplo envia um documento de cada vez. Porém, na produção, os valores Idioma dos documentos e ID do documento podem vir de uma lista ou de outra fonte de dados.
   Idioma dos documentos	en
   Texto dos Documentos	O campo Crítica do SharePoint. Para informar este valor, siga estas etapas: 1. Selecione dentro da caixa de Texto Documentos e escolha o ícone de raio para abrir a lista de conteúdo dinâmico. 2. Na lista, na seção do gatilho do SharePoint, selecione Crítica.

5. Adicione a ação do SharePoint chamada Atualizar item ao seu fluxo de trabalho e forneça os seguintes valores:

   Parâmetro	Valor
   Endereço do Site	< SharePoint-site-address>
   Nome da Lista	Críticas de Filmes
   ID	O campo ID do SharePoint
   Title	A saída do gatilho do SharePoint chamada Título. Para informar este valor, siga estas etapas: 1. Selecione dentro da caixa de Título e escolha o ícone de raio para abrir a lista de conteúdo dinâmico. 2. Na lista, na seção do gatilho do SharePoint, selecione Título.

6. No painel de ação Atualizar item, abra a lista de Parâmetros avançados, selecione os parâmetros desejados, que variam com base na lista do SharePoint Online, para adicioná-los à ação. Para cada parâmetro adicionado, abra a lista de conteúdo dinâmico e selecione a saída correspondente do gatilho do SharePoint chamada Quando um item é criado e da ação do conector personalizado.

   Este exemplo adiciona os seguintes parâmetros e as saídas de gatilho e ação correspondentes:

   Parâmetro avançado	Gatilho ou saída da ação
   Revisar	A saída do gatilho do SharePoint chamada Crítica
   Pontuação	A saída da ação do conector personalizado chamada pontuação. Quando você seleciona a saída do gatilho a ser usada nesse campo, o designer adiciona automaticamente uma ação Para cada, pois a ação do conector personalizado pode aceitar vários documentos. Embora a ação de conexão personalizada envie apenas um documento por vez, o designer corresponde às capacidades do conector.

   Quando terminar, a ação Atualizar item terá a seguinte aparência:

   

7. Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Salvar.

Testar o fluxo de trabalho

Para testar o fluxo de trabalho, adicione críticas à sua lista do SharePoint Online e verifique como o fluxo de trabalho responde.

1. Na barra de ferramentas do designer, selecione Executar>Executar.

2. Na sua lista do SharePoint Online, escolha Edição Rápida.

3. Adicione duas críticas à lista uma negativa e um positiva com base nos seguintes valores e selecione Concluído.

   Parâmetro	Valor sugerido
   Título (positivo)	Meu Filme Favorito
   Crítica (positiva)	Gostei do novo filme depois de um longo dia.
   Título (negativo)	Algum Outro Filme
   Crítica (negativa)	O pior filme que eu já vi em décadas.

4. No portal do Azure, no menu do aplicativo lógico, escolha Visão geral para revisar o histórico de execução do fluxo de trabalho. Na página Visão geral, selecione Histórico de execuções.

   A guia Histórico de execuções mostra duas execuções de fluxo de trabalho, uma para cada revisão adicionada à lista.

5. Para economizar no consumo de recursos depois de concluir esse fluxo de trabalho, na barra de ferramentas da página Visão geral, escolha Desabilitar.

6. De volta à página de lista do SharePoint Online, atualize o navegador para ver as pontuações adicionadas pelo fluxo de trabalho.

   

Parabéns! Embora este exemplo seja um fluxo de trabalho básico, o conector personalizado adiciona uma funcionalidade poderosa com a capacidade de chamar os Serviços Cognitivos.

Conteúdo relacionado

Você pode compartilhar seu conector personalizado dentro da sua organização, ou pode fazer com que o conector seja certificado para que pessoas fora da sua organização possam usá-lo.

• Compartilhar seu conector
• Certificar seu conector

Faça comentários

Agradecemos muito os comentários sobre problemas com nossa plataforma de conectores ou novas ideias de recursos. Para fornecer comentários, acesseEnviar problemas ou obter ajuda com conectores e selecione o tipo de comentário.