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.

   

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

   

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:

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

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.

   • 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)

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.

   

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