Utilizar os Serviços Cognitivos em aplicações de tela
Este artigo mostra-lhe como criar uma aplicação de tela básica que utilize a API de Análise de Texto do Azure Cognitive Services para analisar texto. Vamos mostrar-lhe como configurar a API de Análise de Texto e ligá-la ao conector de Análise de Texto. Em seguida, vamos mostrar-lhe como criar uma aplicação baseada em telas que chama a API.
Nota
Se estiver a criar aplicações no Power Apps, recomendamos que leia Criar uma aplicação de raiz antes de explorar este artigo.
Introdução ao Azure Cognitive Services
O Azure Cognitive Services é um conjunto de APIs, SDKs e serviços disponíveis para tornar as aplicações mais inteligentes, envolventes e detetáveis. Estes serviços permitem-lhe adicionar facilmente às suas aplicações funcionalidades inteligentes – como deteção de emoções e vídeo, reconhecimento facial, visual e de voz, e compreensão de idiomas e voz – para as suas aplicações.
Iremos focar-nos na "compreensão de idiomas" para este artigo, ao trabalhar com a API de Análise de Texto. Esta API permite-lhe detetar sentimentos, expressões-chave, tópicos e idiomas no seu texto. Vamos começar experimentando uma demonstração da API.
Pré-requisitos
Antes de começar a criar uma aplicação de tela utilizando a API de Análise de Texto, tem de preparar o recurso de Análise de Texto. Para mais detalhes, aceda aos Pré-requisitos da API de Análise de Texto.
Criar a aplicação e adicionar uma ligação
Dica
Neste tutorial, aprenderá a criar uma aplicação de demonstração com algumas propriedades e valores a partir da saída usando as ações da API de Análise de Texto. Pode utilizar um método semelhante para criar a sua própria aplicação para mostrar mais ou todas essas propriedades e valores para as operações da API de Análise de Texto.
Crie uma aplicação para telemóvel em branco e adicione uma ligação com o conector Análise de Texto.
Comece por criar uma aplicação de tela em branco com o esquema Tablet e um nome como "Aplicação de demonstração com a API de Análise de Texto".
Selecione Dados no painel esquerdo.
Pesquisa pela ligação de Análise de Texto.
Introduza os valores Chave da Conta e URL do Site.
Pode encontrar a Chave da Conta e o URL do Site a partir dos valores CHAVE e Ponto final utilizando o portal do Azure.
Selecione Ligar.
A sua aplicação está agora ligada ao recurso Serviços Cognitivos do tipo da API de Análise de Texto no Azure.
Projetar a aplicação
Nesta secção, irá projetar a aplicação de demonstração com controlos necessários para trabalhar com a API de Análise de Texto. Depois de ter concluído a projeção da aplicação, é assim que vai ficar:
Nota
- A aplicação neste tutorial demonstra como começar a usar a API de Análise de Texto com o Power Apps. Se quiser projetar a aplicação de raiz, ou cumprir requisitos de negócio específicos, pode personalizar esta aplicação de demonstração, ou adicionar, configurar diretamente controlos e utilizar as ações da API de Análise de Texto.
- São sugeridos valores para propriedades de componentes, como alinhamento, tamanho, cor, posição (X, Y) neste tutorial. Os valores reais podem variar dependendo do esquema da aplicação que selecionar. Também pode alterar estes valores sugeridos para projetar a aplicação de acordo com os seus requisitos.
Selecionar
no painel esquerdo.
Selecione Etiqueta de texto.
Altere as propriedades da etiqueta com a seguinte configuração.
Nome de Propriedade valor Texto "Análise de Texto" Tamanho 36 Cor RGBA(255, 255, 255, 1) Preenchimento RGBA(56, 96, 178, 1) Align Align.Center X 0 Y 0 Largura 1366 Altura 98 Insira Etiqueta de texto.
Altere as propriedades da etiqueta com a seguinte configuração.
Nome de Propriedade valor Texto "Introduza o seu texto, selecione as suas opções e, em seguida, selecione "Analisar texto"" Tamanho 17 Align Align.Left X 24 Y 135 Largura 601 Altura 60 Insira Caixa de verificação.
Altere as propriedades da caixa de verificação com a seguinte configuração.
Nome de Propriedade valor Nome chkLanguage Texto "Idioma" Tamanho 17 X 24 Y 228 Insira Caixa de verificação.
Altere as propriedades da caixa de verificação com a seguinte configuração.
Nome de Propriedade valor Nome chkSentiment Texto "Sentimento" Tamanho 17 X 230 Y 228 Insira Caixa de verificação.
Altere as propriedades da caixa de verificação com a seguinte configuração.
Nome de Propriedade valor Nome chkEL Texto "Associação de Entidades" Tamanho 17 X 403 Y 228 Largura 200 Altura 65 Insira Caixa de verificação.
Altere as propriedades da caixa de verificação com a seguinte configuração.
Nome de Propriedade valor Nome chkPhrases Texto "Expressões-chave" Tamanho 17 X 24 Y 286 Largura 193 Altura 65 Insira Caixa de verificação.
Altere as propriedades da caixa de verificação com a seguinte configuração.
Nome de Propriedade valor Nome chkNER Texto "Reconhecimento de Entidades Nomeadas" Tamanho 17 X 230 Y 286 Largura 318 Altura 65 Insira Entrada de texto.
Altere as propriedades da entrada de texto com a seguinte configuração.
Nome de Propriedade valor Nome tiTextToAnalyze Texto "Introduzir texto" Modo Multilinha Tamanho 14 Altura 256 Largura 557 X 24 Y 390 Insira Botão.
Altere as propriedades do botão com a seguinte configuração.
Nome de Propriedade valor Nome analyzeText Texto "Analisar Texto" X 189 Y 684 Largura 196 Altura 53 Tamanho 17 Insira Etiqueta de texto.
Altere as propriedades da etiqueta com a seguinte configuração.
Nome de Propriedade valor Nome dLanguage Texto "Idioma Detetado:" Tamanho 17 X 633 Y 135 Largura 665 Altura 48 Insira Etiqueta de texto.
Altere as propriedades da etiqueta com a seguinte configuração.
Nome de Propriedade valor Nome sScore Texto "Pontuação de sentimento" Tamanho 17 X 633 Y 196 Largura 656 Altura 48 Selecione Inserir -> Galeria -> Vertical em branco.
Altere as propriedades da galeria com a seguinte configuração.
Nome de Propriedade valor Nome gallerySS Esquema Cargo X 826 Y 196 Largura 503 Altura 62 Selecione o ícone da seta dentro da galeria e elimine-o.
Altere as seguintes propriedades para a primeira linha dentro da galeria.
Nome de Propriedade valor X 17 Altura 63 Insira Etiqueta de texto.
Altere as propriedades da etiqueta com a seguinte configuração.
Nome de Propriedade valor Texto "Entidades ligadas:" Tamanho 17 X 633 Y 258 Largura 206 Altura 48 Selecione Inserir -> Galeria -> Vertical em branco.
Altere as propriedades da galeria com a seguinte configuração.
Nome de Propriedade valor Nome galleryLE Esquema Título e subtítulo X 633 Y 318 Largura 696 Altura 87 Selecione o ícone da seta dentro da galeria e elimine-o.
Insira Etiqueta de texto.
Altere as propriedades da etiqueta com a seguinte configuração.
Nome de Propriedade valor Texto "Expressões-chave:" Tamanho 17 X 633 Y 429 Largura 235 Altura 48 Selecione Inserir -> Galeria -> Vertical em branco.
Altere as propriedades da galeria com a seguinte configuração.
Nome de Propriedade valor Nome galleryKP Esquema Cargo X 633 Y 489 Largura 696 Altura 87 Selecione o ícone da seta dentro da galeria e elimine-o.
Altere as seguintes propriedades para a primeira linha dentro da galeria.
Nome de Propriedade valor X 17 Altura 87 Insira Etiqueta de texto.
Altere as propriedades da etiqueta com a seguinte configuração.
Nome de Propriedade valor Texto "Entidades nomeadas:" Tamanho 17 X 633 Y 589 Largura 193 Altura 48 Selecione Inserir -> Galeria -> Vertical em branco.
Altere as propriedades da galeria com a seguinte configuração.
Nome de Propriedade valor Nome galleryNER Esquema Cargo X 633 Y 670 Largura 696 Altura 87 Selecione o ícone da seta dentro da galeria e elimine-o.
Altere as seguintes propriedades para a primeira linha dentro da galeria.
Nome de Propriedade valor X 17 Altura 87
Eis como se deve parecer a aplicação depois de seguir os passos acima.
Adicionar lógica à aplicação
Agora que criou uma estrutura básica da aplicação com o design esperado, vamos adicionar lógica à aplicação para que possamos usar os Serviços Cognitivos no Power Apps.
Nota
Neste tutorial, a aplicação de demonstração utiliza fórmulas de exemplo com uma combinação de diferentes funções dependendo do controlo que está a ser utilizado. Diferentes designs ou personalizações de aplicações podem usar diferentes fórmulas e funções. Pode redesenhar a aplicação e fórmulas para personalização adicional, ou para satisfazer os requisitos do seu negócio.
Copie e cole a seguinte fórmula como o valor da propriedade OnSelect para o botão analyzeText.
ClearCollect( languageInfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", countryHint: "US", text: tiTextToAnalyze.Text } ); TextAnalytics.LanguagesV3(languageInfo); If( chkLanguage.Value=true, ClearCollect( languageCollect, TextAnalytics.LanguagesV3(languageInfo).documents.detectedLanguage ) ); ClearCollect( phrasesInfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", language: "en", text: tiTextToAnalyze.Text } ); If( chkPhrases.Value = true, ClearCollect( phrasesCollect, TextAnalytics.KeyPhraseV3(phrasesInfo).documents.keyPhrases ) ); ClearCollect( sentimentInfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", language: "en", text: tiTextToAnalyze.Text } ); If( chkSentiment.Value = true, ClearCollect( sentimentCollect, TextAnalytics.SentimentV3(sentimentInfo).documents.confidenceScores ) ); ClearCollect( nerinfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", language: "en", text: tiTextToAnalyze.Text } ); If( chkNER.Value = true, ClearCollect( nerCollect, TextAnalytics.EntitiesRecognitionGeneralV3(nerinfo).documents.entities ) ); ClearCollect( elinfo, { id: "E393CEB2-56A8-4668-A5EB-A1254E9758F0", language: "en", text: tiTextToAnalyze.Text } ); If( chkEL.Value = true, ClearCollect( elCollect, TextAnalytics.EntitiesLinkingV3(elinfo).documents.entities ) );
Neste passo, a fórmula utiliza as seguintes funções.
- ClearCollect – cria coleções para cada opção (caixas de verificação) para utilização com os Serviços Cognitivos. Há duas coleções usadas. Primeiro, para recolher as informações a partir da entrada de texto (tiTextToAnalyze). E, em seguida, a segunda coleção para armazenar os resultados de chamadas à API relacionadas com a Análise de Texto.
- Ações de API de Análise de Texto de Serviços Cognitivos – usado na fórmula para armazenar os detalhes da análise nas coleções locais. Ações utilizadas: Deteção de Idioma (V3.0) (pré-visualização), Sentimento (V3.0) (pré-visualização), Associação de Entidade (V3.0) (pré-visualização), Expressões-chave (V3.0) (pré-visualização), Reconhecimento de Entidades Nomeadas (V3.0) (pré-visualização)
Copie e cole a seguinte fórmula como o valor da propriedade Text para a etiqueta dLanguage.
"Detected language: " & First(languageCollect.detectedLanguage).detectedLanguage.name
Neste passo, a fórmula utiliza a função Primeiro para obter e apresentar o idioma identificado pela API de Análise de Texto.
Selecione a origem de dados para galerySS como sentimentCollect.
Selecione a primeira linha dentro da galeria gallerySS. E, em seguida, copie e cole seguindo a fórmula para a propriedade Text.
"Positive: " & ThisItem.confidenceScores.positive &" Neutral: " & ThisItem.confidenceScores.neutral & " Negative: " & ThisItem.confidenceScores.negative
Neste passo, a fórmula utiliza pontuações de confiança analisadas pela API de Análise de Texto para serem apresentadas na galeria.
Selecione a origem de dados para galleryLE como elCollect.
Selecione a segunda linha dentro da galeria galleryLE. E, em seguida, copie e cole seguindo a fórmula para a propriedade Text.
Concat(ThisItem.entities.url,url,", ")
Neste passo, a função Concat é usada para obter uma única cadeia separada por vírgula com URLs para as entidades listadas identificadas pela API de Análise de Texto.
Selecione a primeira linha dentro da galeria galleryLE. E, em seguida, copie e cole seguindo a fórmula para a propriedade Text.
Concat(ThisItem.entities.name,name,", ")
Neste passo, a função Concat é usada para obter uma única cadeia separada por vírgula com nomes das entidades listadas identificadas pela API de Análise de Texto.
Selecione a origem de dados para galleryKP como phrasesCollect.
Selecione a primeira linha dentro da galeria galleryKP. E, em seguida, copie e cole seguindo a fórmula para a propriedade Text.
Concat(ThisItem.keyPhrases.Value, Value, ", ")
Neste passo, a função Concat é usada para obter uma única cadeia separada por vírgula com expressões-chave identificadas pela API de Análise de Texto.
Selecione a origem de dados para galleryNER como nerCollect.
Selecione a primeira linha dentro da galeria galleryNER. E, em seguida, copie e cole seguindo a fórmula para a propriedade Text.
Concat(ThisItem.entities.text,text,", ")
Neste passo, a função Concat é usada para obter uma única cadeia separada por vírgula com as entidades identificadas pela API de Análise de Texto.
Guarde e publique a aplicação.
Executar e testar a aplicação
Pré-visualize a aplicação ou prima F5 no teclado.
Introduza o texto de exemplo, como o seguinte.
Cognitive Services brings AI within reach of every developer—without requiring machine-learning expertise. All it takes is an API call to embed the ability to see, hear, speak, search, understand, and accelerate decision-making into your apps. Enable developers of all skill levels to easily add AI capabilities to their apps with modern application development.
Selecione todas as cinco caixas de verificação.
Selecione Analisar Texto.
Reveja o resultado.
Agora que utilizou o Azure Cognitive Services no Power Apps ao criar uma aplicação de demonstração, pode personalizar a interface da aplicação e adicionar mais funcionalidades.
Passos seguintes
Adicionar e configurar controlos
Consulte também
Controlos e propriedades no Power Apps
Documentação da API de Análise de Texto
Início rápido: Utilizar a biblioteca de clientes da Análise de Texto e API REST
Referência de conector – Análise de Texto
Comentários
Submeter e ver comentários