Utilitzar Serveis cognitius a les aplicacions de llenç

Aquest article mostra com crear una aplicació del llenç bàsica que utilitzi l'API d'anàlisi de textos de l'Azure Cognitive Services per analitzar el text. Us mostrarem com configurar l'API d'anàlisi de textos i connectar-vos-hi amb el connector d'anàlisi de textos. A continuació, us mostrarem com crear una aplicació del llenç que truca a l'API.

Nota

Si és la primera vegada que creeu aplicacions al Power Apps, us recomanem que creeu una aplicació des de zero abans de començar amb aquest article.

Introducció a l'Azure Cognitive Services

Azure Cognitive Services és un conjunt d'API, SDK i serveis disponibles per fer que les aplicacions siguin més intel·ligents, atractives i descobribles. Aquests serveis permeten afegir fàcilment característiques intel·ligents, com ara l'emoció i la detecció de vídeo; el reconeixement facial, de la parla i de la visió; i comprensió de la parla i de la llengua, a les aplicacions.

Ens centrarem en la "comprensió de la llengua" per a aquest article, treballant amb l'API d'anàlisi de textos. Aquesta API us permet detectar l'opinió, les frases clau, els temes i la llengua del text. Comencem provant una demostració de l'API.

Requisits previs

Abans de començar a crear una aplicació de llenç mitjançant l'API d'anàlisi de textos, heu de preparar el recurs d'anàlisi de textos. Per obtenir més informació, aneu a Requisits previs de l'API d'anàlisi de textos.

Crear l'aplicació i afegir una connexió

Suggeriment

En aquest tutorial aprendreu a crear una aplicació de demostració amb unes quantes propietats i valors des de zero mitjançant les accions de l'API d'anàlisi de textos. Podeu utilitzar un mètode similar per crear la vostra pròpia aplicació per mostrar més d'aquestes propietats i valors o tots ells per a les operacions de l'API d'anàlisi de textos.

Creeu una aplicació en blanc i afegiu-hi una connexió amb el connector d'anàlisi de textos.

  1. Aneu al Power Apps.

  2. Seleccioneu Aplicació de llenç des de zero.

    Crear una aplicació des de zero.

  3. Introduïu el nom de l'aplicació.

  4. Trieu un disseny per a l'aplicació i seleccioneu Crea. Per a aquesta demostració, utilitzarem la disposició de Tauleta.

    Donar nom a l'aplicació, triar un disseny i seleccionar Crea.

  5. Des de la subfinestra esquerra, seleccioneu Dades.

  6. Cerqueu una connexió d'anàlisi de textos.

    Afegir la connexió d'anàlisi de textos.

  7. Introduïu els valors de Clau del compte i URL del lloc.

    Clau del compte i adreça URL del lloc per a l'API d'anàlisi de textos al Power Apps.

    Podeu trobar la Clau del compte i l'Adreça URL del lloc als valors KEY i Extrem utilitzant el portal de l'Azure.

    Clau i extrem al portal de l'Azure

  8. Seleccioneu Connecta.

Ara l'aplicació està connectada al recurs del Cognitive Services del tipus d'API d'anàlisi de textos a l'Azure.

Dissenyar l’aplicació

En aquesta secció, dissenyareu l'aplicació de demostració amb els controls necessaris per treballar amb l'API d'anàlisi de textos. Un cop hàgiu completat el disseny de l'aplicació, tindrà aquest aspecte:

Aplicació de demostració

Nota

  • L'aplicació d'aquest tutorial mostra la manera de començar a utilitzar l'API d'anàlisi de textos amb el Power Apps. Si voleu dissenyar l'aplicació des de zero o per complir determinats requisits empresarials, podeu personalitzar aquesta aplicació demostració o afegir-hi directament controls i configurar i utilitzar les accions de l'API d'anàlisi de textos.
  • Els valors de les propietats dels components, com ara l'alineació, la mida, el color, la posició (X, Y) d'aquest tutorial són suggeriments. Els valors reals poden variar en funció de la disposició de l'aplicació que seleccioneu. També podeu canviar aquests valors suggerits per dissenyar l'aplicació segons les vostres necessitats.
  1. Seleccionar Insereix de la subfinestra esquerra.

  2. Seleccioneu Etiqueta de text.

  3. Canvieu les propietats de l'etiqueta amb la configuració següent.

    Nom de la propietat Valor
    SMS "Anàlisi de textos"
    Mida 36
    Color RGBA(255, 255, 255, 1)
    Emplena RGBA(56, 96, 178, 1)
    Alineació Align.Center
    X 0
    Y 0
    Amplària 1366
    Alçada 98
  4. Inseriu una Etiqueta de text.

  5. Canvieu les propietats de l'etiqueta amb la configuració següent.

    Nom de la propietat Valor
    SMS "Introduïu el text, seleccioneu les opcions i seleccioneu ""Analitza el text""
    Mida 16
    Alineació Align.Left
    X 24
    Y 135
    Amplària 601
    Alçada 60
  6. Inseriu una Casella de selecció.

  7. Canvieu les propietats de la casella de selecció amb la configuració següent.

    Nom de la propietat Valor
    Nom chkLanguage
    SMS "Llengua"
    Mida 16
    X 24
    Y 228
  8. Inseriu una Casella de selecció.

  9. Canvieu les propietats de la casella de selecció amb la configuració següent.

    Nom de la propietat Valor
    Nom chkSentiment
    SMS "Opinió"
    Mida 16
    X 230
    Y 228
  10. Inseriu una Casella de selecció.

  11. Canvieu les propietats de la casella de selecció amb la configuració següent.

    Nom de la propietat Valor
    Nom chkEL
    SMS "Enllaç d'entitats"
    Mida 16
    X 403
    Y 228
    Amplària 200
    Alçada 50
  12. Inseriu una Casella de selecció.

  13. Canvieu les propietats de la casella de selecció amb la configuració següent.

    Nom de la propietat Valor
    Nom chkPhrases
    SMS "Frases clau"
    Mida 16
    X 24
    Y 286
    Amplària 193
    Alçada 50
  14. Inseriu una Casella de selecció.

  15. Canvieu les propietats de la casella de selecció amb la configuració següent.

    Nom de la propietat Valor
    Nom chkNER
    SMS "Reconeixement d'entitat amb nom"
    Mida 16
    X 230
    Y 286
    Amplària 318
    Alçada 50
  16. Inseriu una Entrada de text.

  17. Canvieu les propietats de l'entrada de text amb la configuració següent.

    Nom de la propietat Valor
    Nom tiTextToAnalyze
    SMS "Introduïu text"
    Mode Multilínia
    Mida 14
    Alçada 256
    Amplària 557
    X 24
    Y 390
  18. Inseriu un Botó.

  19. Canvieu les propietats del botó amb la configuració següent.

    Nom de la propietat Valor
    Nom analyzeText
    SMS "Analitza el text"
    X 189
    Y 684
    Amplària 196
    Alçada 53
    Mida 16
  20. Inseriu una Etiqueta de text.

  21. Canvieu les propietats de l'etiqueta amb la configuració següent.

    Nom de la propietat Valor
    Nom dLanguage
    SMS "Llengua detectada:"
    Mida 16
    X 633
    Y 135
    Amplària 665
    Alçada 48
  22. Inseriu una Etiqueta de text.

  23. Canvieu les propietats de l'etiqueta amb la configuració següent.

    Nom de la propietat Valor
    Nom sScore
    SMS "Puntuació d'opinió:"
    Mida 16
    X 633
    Y 196
    Amplària 656
    Alçada 48
  24. Seleccioneu Insereix -> Galeria -> Vertical en blanc.

  25. Canvieu les propietats de la galeria amb la configuració següent.

    Nom de la propietat Valor
    Nom gallerySS
    Disposició Càrrec
    X 826
    Y 196
    Amplària 503
    Alçada 62
  26. Seleccioneu la icona de fletxa de la galeria i suprimiu-la.

  27. Canvieu les propietats següents per a la primera fila de la galeria.

    Nom de la propietat Valor
    X 16
    Alçada 63
  28. Inseriu una Etiqueta de text.

  29. Canvieu les propietats de l'etiqueta amb la configuració següent.

    Nom de la propietat Valor
    SMS "Entitats enllaçades:"
    Mida 16
    X 633
    Y 258
    Amplària 206
    Alçada 48
  30. Seleccioneu Insereix -> Galeria -> Vertical en blanc.

  31. Canvieu les propietats de la galeria amb la configuració següent.

    Nom de la propietat Valor
    Nom galleryLE
    Disposició Títol i subtítol
    X 633
    Y 318
    Amplària 696
    Alçada 87
  32. Seleccioneu la icona de fletxa de la galeria i suprimiu-la.

  33. Inseriu una Etiqueta de text.

  34. Canvieu les propietats de l'etiqueta amb la configuració següent.

    Nom de la propietat Valor
    SMS "Frases clau:"
    Mida 16
    X 633
    Y 429
    Amplària 150
    Alçada 48
  35. Seleccioneu Insereix -> Galeria -> Vertical en blanc.

  36. Canvieu les propietats de la galeria amb la configuració següent.

    Nom de la propietat Valor
    Nom galleryKP
    Disposició Càrrec
    X 633
    Y 489
    Amplària 696
    Alçada 87
  37. Seleccioneu la icona de fletxa de la galeria i suprimiu-la.

  38. Canvieu les propietats següents per a la primera fila de la galeria.

    Nom de la propietat Valor
    X 16
    Alçada 87
  39. Inseriu una Etiqueta de text.

  40. Canvieu les propietats de l'etiqueta amb la configuració següent.

    Nom de la propietat Valor
    SMS "Entitats amb nom:"
    Mida 16
    X 633
    Y 589
    Amplària 193
    Alçada 48
  41. Seleccioneu Insereix -> Galeria -> Vertical en blanc.

  42. Canvieu les propietats de la galeria amb la configuració següent.

    Nom de la propietat Valor
    Nom galleryNER
    Disposició Càrrec
    X 633
    Y 670
    Amplària 696
    Alçada 87
  43. Seleccioneu la icona de fletxa de la galeria i suprimiu-la.

  44. Canvieu les propietats següents per a la primera fila de la galeria.

    Nom de la propietat Valor
    X 16
    Alçada 87

A continuació s'explica l'aspecte que hauria de tenir aquesta aplicació després de seguir els passos anteriors.

Disseny d'aplicacions

Afegir lògica a l'aplicació

Ara que heu creat una estructura bàsica de l'aplicació amb el disseny esperat, afegiu lògica a l'aplicació per tal que puguem utilitzar el Cognitive Services al Power Apps.

Nota

En aquest tutorial, l'aplicació de demostració utilitza fórmules d'exemple amb una combinació de diferents funcions, segons el control que s'utilitzi. Els diferents dissenys o personalitzacions d'aplicacions poden utilitzar diferents fórmules i funcions. Podeu redissenyar l'aplicació i les fórmules per a una personalització addicional o segons les vostres necessitats empresarials.

  1. Copieu i enganxeu la fórmula següent com a valor de la propietat OnSelect per al botó 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
        )
    ); 
    

    En aquest pas, la fórmula utilitza les funcions següents.

  2. Copieu i enganxeu la fórmula següent com a valor de la propietat Text per a l'etiqueta dLanguage.

    "Detected language: " & First(languageCollect.detectedLanguage).detectedLanguage.name
    

    En aquest pas, la fórmula utilitza la funció First per retornar i visualitzar la llengua identificada per l'API d'anàlisi de textos.

  3. Seleccioneu la font de dades per a galerySS com a sentimentCollect.

  4. Seleccioneu la primera fila de la galeria gallerySS. A continuació, copieu i enganxeu la fórmula següent per a la propietat Text.

    "Positive: " & ThisItem.confidenceScores.positive &" Neutral: " & ThisItem.confidenceScores.neutral & " Negative: " & ThisItem.confidenceScores.negative
    

    En aquest pas, la fórmula utilitza les puntuacions de confiança analitzades per l'API d'anàlisi de textos per mostrar-les a la galeria.

  5. Seleccioneu la font de dades per a galeryLE com a elCollect.

  6. Seleccioneu la segona fila de la galeria galleryLE. A continuació, copieu i enganxeu la fórmula següent per a la propietat Text.

    Concat(ThisItem.entities.url,url,", ")
    

    En aquest pas, la funció Concat s'utilitza per retornar una sola cadena separada per comes amb adreces URL de les entitats de la llista identificades per l'API d'anàlisi de textos.

  7. Seleccioneu la primera fila de la galeria galleryLE. A continuació, copieu i enganxeu la fórmula següent per a la propietat Text.

    Concat(ThisItem.entities.name,name,", ")
    

    En aquest pas, la funció Concat s'utilitza per retornar una sola cadena separada per comes amb noms de les entitats de la llista identificades per l'API d'anàlisi de textos.

  8. Seleccioneu la font de dades per a galeryKP com a phrasesCollect.

  9. Seleccioneu la primera fila de la galeria galleryKP. A continuació, copieu i enganxeu la fórmula següent per a la propietat Text.

    Concat(ThisItem.keyPhrases.Value, Value, ", ")
    

    En aquest pas, la funció Concat s'utilitza per retornar una sola cadena separada per comes amb les frases clau identificades per l'API d'anàlisi de textos.

  10. Seleccioneu la font de dades per a galeryNER com a nerCollect.

  11. Seleccioneu la primera fila de la galeria galleryNER. A continuació, copieu i enganxeu la fórmula següent per a la propietat Text.

    Concat(ThisItem.entities.text,text,", ")
    

    En aquest pas, la funció Concat s'utilitza per retornar una sola cadena separada per comes amb les entitats identificades per l'API d'anàlisi de textos.

  12. Deseu i publiqueu l'aplicació.

Executar i provar l'aplicació

  1. Obteniu una visualització prèvia de l'aplicació o premeu F5 al teclat.

  2. Introduïu text d'exemple, com ara el següent.

    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. Seleccioneu les cinc caselles de selecció.

  4. Seleccioneu Analitza el text.

  5. Reviseu la sortida.

    Sortida de text d'exemple analitzada

Ara que heu utilitzat l'Azure Cognitive Services al Power Apps creant una aplicació de demostració, podeu personalitzar la interfície de l'aplicació i afegir-hi més característiques.

Passos següents

Afegir i configurar controls

Consulteu també

Controls i propietats al Power Apps
Documentació de l'API d'anàlisi de textos
Inici ràpid: utilitzar la biblioteca de client d'anàlisi de textos i l'API de REST
Referència de connectors: anàlisi de textos