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.

  1. 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".

  2. Selecione Dados no painel esquerdo.

  3. Pesquisa pela ligação de Análise de Texto.

    Adicionar ligação à Análise de Texto.

  4. Introduza os valores Chave da Conta e URL do Site.

    Chave da Conta e URL do Site para a API de Análise de texto no Power Apps.

    Pode encontrar a Chave da Conta e o URL do Site a partir dos valores CHAVE e Ponto final utilizando o portal do Azure.

    CHAVE e Ponto final no portal do Azure.

  5. 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:

Aplicação de demonstração.

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.
  1. Selecionar Inserir. no painel esquerdo.

  2. Selecione Etiqueta de texto.

  3. 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
  4. Insira Etiqueta de texto.

  5. 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
  6. Insira Caixa de verificação.

  7. 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
  8. Insira Caixa de verificação.

  9. 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
  10. Insira Caixa de verificação.

  11. 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
  12. Insira Caixa de verificação.

  13. 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
  14. Insira Caixa de verificação.

  15. 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
  16. Insira Entrada de texto.

  17. 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
  18. Insira Botão.

  19. 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
  20. Insira Etiqueta de texto.

  21. 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
  22. Insira Etiqueta de texto.

  23. 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
  24. Selecione Inserir -> Galeria -> Vertical em branco.

  25. 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
  26. Selecione o ícone da seta dentro da galeria e elimine-o.

  27. Altere as seguintes propriedades para a primeira linha dentro da galeria.

    Nome de Propriedade valor
    X 17
    Altura 63
  28. Insira Etiqueta de texto.

  29. 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
  30. Selecione Inserir -> Galeria -> Vertical em branco.

  31. 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
  32. Selecione o ícone da seta dentro da galeria e elimine-o.

  33. Insira Etiqueta de texto.

  34. 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
  35. Selecione Inserir -> Galeria -> Vertical em branco.

  36. 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
  37. Selecione o ícone da seta dentro da galeria e elimine-o.

  38. Altere as seguintes propriedades para a primeira linha dentro da galeria.

    Nome de Propriedade valor
    X 17
    Altura 87
  39. Insira Etiqueta de texto.

  40. 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
  41. Selecione Inserir -> Galeria -> Vertical em branco.

  42. 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
  43. Selecione o ícone da seta dentro da galeria e elimine-o.

  44. 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.

Conceção da aplicação.

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.

  1. 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.

  2. 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.

  3. Selecione a origem de dados para galerySS como sentimentCollect.

  4. 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.

  5. Selecione a origem de dados para galleryLE como elCollect.

  6. 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.

  7. 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.

  8. Selecione a origem de dados para galleryKP como phrasesCollect.

  9. 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.

  10. Selecione a origem de dados para galleryNER como nerCollect.

  11. 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.

  12. Guarde e publique a aplicação.

Executar e testar a aplicação

  1. Pré-visualize a aplicação ou prima F5 no teclado.

  2. 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.

  3. Selecione todas as cinco caixas de verificação.

  4. Selecione Analisar Texto.

  5. Reveja o resultado.

    Resultado do texto de exemplo analisado.

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