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.
Aneu al Power Apps.
Seleccioneu Aplicació de llenç des de zero.

Introduïu el nom de l'aplicació.
Trieu un disseny per a l'aplicació i seleccioneu Crea. Per a aquesta demostració, utilitzarem la disposició de Tauleta.

Des de la subfinestra esquerra, seleccioneu Dades.
Cerqueu una connexió d'anàlisi de textos.

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

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

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:

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.
Seleccionar
de la subfinestra esquerra.Seleccioneu Etiqueta de text.
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 Inseriu una Etiqueta de text.
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 Inseriu una Casella de selecció.
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 Inseriu una Casella de selecció.
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 Inseriu una Casella de selecció.
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 Inseriu una Casella de selecció.
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 Inseriu una Casella de selecció.
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 Inseriu una Entrada de text.
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 Inseriu un Botó.
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 Inseriu una Etiqueta de text.
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 Inseriu una Etiqueta de text.
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 Seleccioneu Insereix -> Galeria -> Vertical en blanc.
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 Seleccioneu la icona de fletxa de la galeria i suprimiu-la.
Canvieu les propietats següents per a la primera fila de la galeria.
Nom de la propietat Valor X 16 Alçada 63 Inseriu una Etiqueta de text.
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 Seleccioneu Insereix -> Galeria -> Vertical en blanc.
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 Seleccioneu la icona de fletxa de la galeria i suprimiu-la.
Inseriu una Etiqueta de text.
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 Seleccioneu Insereix -> Galeria -> Vertical en blanc.
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 Seleccioneu la icona de fletxa de la galeria i suprimiu-la.
Canvieu les propietats següents per a la primera fila de la galeria.
Nom de la propietat Valor X 16 Alçada 87 Inseriu una Etiqueta de text.
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 Seleccioneu Insereix -> Galeria -> Vertical en blanc.
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 Seleccioneu la icona de fletxa de la galeria i suprimiu-la.
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.

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.
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.
- ClearCollect: crea col·leccions per a cada opció (caselles de selecció) per utilitzar-les amb el Cognitive Services. S'utilitzen dues col·leccions. Primer, per recopilar la informació de l'entrada de text (tiTextToAnalyze). I després, la segona col·lecció per emmagatzemar els resultats de trucades de l'API relacionats amb l'anàlisi de textos.
- Accions de l'API d'anàlisi de textos del Cognitive Services: s'utilitzen a la fórmula per emmagatzemar els detalls de l'anàlisi a les col·leccions locals. Accions utilitzades: Detecta l'idioma (V3.0) (versió preliminar), Opinió (V3.0) (versió preliminar), Enllaç d'entitats (V3.0) (versió preliminar), Frases clau (V3.0) (versió preliminar), Reconeixement d'entitats amb nom (V3.0) (versió preliminar)
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.nameEn aquest pas, la fórmula utilitza la funció First per retornar i visualitzar la llengua identificada per l'API d'anàlisi de textos.
Seleccioneu la font de dades per a galerySS com a sentimentCollect.
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.negativeEn 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.
Seleccioneu la font de dades per a galeryLE com a elCollect.
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.
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.
Seleccioneu la font de dades per a galeryKP com a phrasesCollect.
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.
Seleccioneu la font de dades per a galeryNER com a nerCollect.
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.
Deseu i publiqueu l'aplicació.
Executar i provar l'aplicació
Obteniu una visualització prèvia de l'aplicació o premeu F5 al teclat.
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.Seleccioneu les cinc caselles de selecció.
Seleccioneu Analitza el text.
Reviseu la sortida.

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