Usar um conector personalizado de um aplicativo do Power Apps

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 tópico, você criará um aplicativo básico que usa o conector personalizado criado em um tópico anterior. O aplicativo recebe entrada de texto e usa o conector personalizado para chamar a API de Análise de Texto dos Serviços Cognitivos. O conector retorna a pontuação de sentimentos (0 a 1) para o texto e o aplicativo a exibe como uma porcentagem. A imagem a seguir mostra o aplicativo terminado:

Pré-requisitos

• Uma assinatura do Power Apps.

• Experiência básica de criação de aplicativos no Power Apps. Para obter mais informações, veja Criar um aplicativo do zero.

• O conector personalizado que você criou em um destes tópicos:

  • Criar um conector personalizado de uma definição OpenAPI
  • Criar um conector personalizado do zero

Criar o aplicativo e adicionar o conector personalizado

A primeira coisa que você faz é criar um aplicativo em branco e conectar-se ao conector personalizado criado em um tópico anterior.

1. Em make.powerapps.com, escolha Iniciar em branco> (phone) >Criar este aplicativo.

   

2. Na tela do aplicativo, escolha conectar aos dados.

3. No painel Dados, escolha a conexão que você criou em um tópico anterior (como "SentimentDemo").

4. Salve o aplicativo com o nome Sentiment Analysis.

Adicionar controles ao aplicativo

Agora você cria a interface do usuário para o aplicativo, para poder inserir texto, enviá-la para a API e obter uma resposta.

1. Adicione um ícone retangular como uma barra de título e adicione o rótulo "Análise de Sentimentos".

   

2. Adicione o rótulo "Digite seu texto e clique em Obter pontuação" e adicione um controle de entrada de texto.

   

3. Adicione um botão com o texto "Obter pontuação".

   

4. Adicione o rótulo "A pontuação do sentimento é". Na próxima seção, você adiciona uma fórmula para preencher esse rótulo.

   

Adicionar fórmulas para orientar o comportamento

Com a conexão de dados e da interface do usuário prontos, agora você pode adicionar fórmulas do Power Apps que orientam o comportamento do aplicativo. As fórmulas chamam a API por meio do conector personalizado, armazenam o resultado em um coleção (uma variável tabular) e, em seguida, exibem o resultado formatado no aplicativo.

1. Escolha o botão que você criou e defina a propriedade OnSelect do botão ao nome do conector (incluindo o ponto).

   SentimentDemo.
   

   O Power Apps oferece uma opção de preenchimento automático de DetectSentiment porque o conector personalizado disponibiliza isso.

2. Agora, defina a propriedade OnSelect do botão como a fórmula a seguir.

   ClearCollect(sentimentCollection, SentimentDemo.DetectSentiment(
       {id:"1", language:"en", text:TextInput1.Text}).documents.score)
   

   Essa fórmula obtém a pontuação de sentimento da API e a armazena em uma coleção:

   1. A fórmula chama a função DetectSentiment com os três parâmetros expostos pelo conector personalizado: id, language e text. Especificamos valores para os dois primeiros diretamente na fórmula e obtemos o valor de Text do controle de entrada de texto (você também pode extrair os dois primeiros valores de outro lugar em um aplicativo).

   2. A função retorna uma score para cada documento que você envia; em nossos exemplos, enviamos um documento por vez. A pontuação varia de 0 (negativo) a 1 (positivo).

   3. A fórmula então chama a função ClearCollect para remover quaisquer valores existentes de sentimentCollection e adicionar o valor de score.

3. Escolha o rótulo que você criou e defina a propriedade Texto do rótulo para a fórmula a seguir.

   "The sentiment score is " & Round(First(sentimentCollection).score, 3) * 100 & "%"
   

   Essa fórmula obtém a pontuação de sentimento da coleção, a formata e a exibe:

   1. A função First() retorna o primeiro (e, nesse caso, o único) registro em sentimentCollect e exibe o campo score (o único campo) associado a esse registro.

   2. A função Round() arredonda a pontuação para 3 casas; o restante da fórmula formata o resultado como uma porcentagem e adiciona algumas informações para o contexto.

Testar o aplicativo

Agora, execute o aplicativo concluído para garantir que ele funcione conforme o esperado.

1. Escolha no canto superior direito para executar o aplicativo.

2. Digite uma frase no controle de entrada de texto e escolha Obter pontuação. A pontuação do sentimento deve ser exibida dentro de alguns segundos.

O aplicativo concluído é parecido com a imagem a seguir:

É um aplicativo simples, mas obtém uma funcionalidade avançada com a capacidade de chamar os Serviços Cognitivos por meio de um conector personalizado.

Próximas etapas

Compartilhe o conector em sua organização e/ou obter a certificação do conector para que as pessoas fora de 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.