Een aangepaste connector gebruiken vanuit een Power Apps-app

Notitie

Dit artikel is onderdeel van een zelfstudiereeks over het maken en gebruiken van aangepaste connectors in Azure Logic Apps, Microsoft Power Automate en Microsoft Power Apps en het gebruiken van AI-connectors in Microsoft Copilot Studio. Zorg ervoor dat u het overzicht van de aangepaste connector leest om het proces te begrijpen. Ga naar gebruik Power Platform connectors in Copilot Studio om te leren hoe u de connectors als connectoracties in uw Microsoft Copilot agent kunt aanroepen.

In dit onderwerp bouwt u een basisapp op die de aangepaste connector gebruikt die u in een eerder onderwerp hebt gemaakt. De app neemt tekstinvoer en gebruikt vervolgens de aangepaste connector om de Cognitive Services Text Analytics API aan te roepen. De connector retourneert de gevoelsscore (0 tot 1) voor de tekst en de app geeft deze weer als een percentage. De voltooide app wordt in de volgende afbeelding weergegeven:

Vereisten

• Een Power Apps abonnement.

• Basiservaring met het bouwen van apps in Power Apps. Zie Een app vanaf nul maken voor meer informatie.

• De aangepaste connector die u in een van deze onderwerpen hebt gemaakt:

  • Maak een aangepaste connector van een OpenAPI definitie
  • Maak een aangepaste connector vanaf nul

De app maken en de aangepaste connector toevoegen

Het eerste dat u doet, is een lege app maken en deze vervolgens verbinden met de aangepaste connector die u in een eerder onderwerp hebt gemaakt.

1. Kies in make.powerapps.com de optie Beginnen met blanco> (telefoon) >Deze app maken.

   

2. Kies op het app-canvas Verbinden met gegevens.

3. Kies in het paneel Gegevens de verbinding die u in een eerder onderwerp hebt gemaakt (bijvoorbeeld 'SentimentDemo').

4. Sla de app op met de naam Sentiment Analysis.

Besturingselementen toevoegen aan de app

U bouwt nu de gebruikersinterface voor de app uit, zodat u tekst kunt invoeren, die tekst naar de API kunt sturen en een respons kunt krijgen.

1. Voeg een rechthoekig pictogram toe als titelbalk en voeg vervolgens het label "Sentimentanalyse" toe.

   

2. Voeg het label "Voer uw tekst in en klik vervolgens op Score ophalen" toe en voeg vervolgens een tekstinvoerbesturingselement toe.

   

3. Voeg een knop toe met de tekst "Score ophalen".

   

4. Voeg het label "De gevoelsscore is" toe. In de volgende sectie voegt u een formule toe om dit label te voltooien.

   

Formules toevoegen om gedrag te stimuleren

Wanneer de gegevensverbinding en de gebruikersinterface zijn ingesteld, voegt u Power Apps-formules toe die het gedrag van de app bepalen. De formules roepen de API aan via de aangepaste connector, slaan het resultaat op in een verzameling (een tabelvariabele) en geven het geformatteerde resultaat vervolgens weer in de app.

1. Selecteer de knop die u hebt gemaakt en stel de eigenschap OnSelect van de knop in op de naam van de connector (inclusief de punt).

   SentimentDemo.
   

   Power Apps geeft u de mogelijkheid om automatisch aan te vullen, omdat de aangepaste connector dit mogelijk maakt. DetectSentiment

2. Stel nu de eigenschap OnSelect van de knop in op de volgende formule.

   ClearCollect(sentimentCollection, SentimentDemo.DetectSentiment(
       {id:"1", language:"en", text:TextInput1.Text}).documents.score)
   

   Deze formule haalt de gevoelsscore van de API op en slaat deze op in een verzameling:

   1. De formule roept de DetectSentiment functie aan met de drie parameters die door de aangepaste connector worden weergegeven: id, language en text. We geven waarden voor de eerste twee rechtstreeks in de formule op en halen de waarde voor Text op uit het tekstinvoerelement (je kunt de eerste twee waarden ook ergens anders in een app vandaan halen).

   2. De functie retourneert a score voor elk document dat u verzendt. In onze voorbeelden verzenden we één document per keer. De score varieert van 0 (negatief) tot 1 (positief).

   3. De formule roept vervolgens de ClearCollect functie aan om bestaande waarden uit sentimentCollection te verwijderen en de waarde uit score toe te voegen.

3. Kies het label dat u hebt gemaakt en stel de eigenschap Tekst van het label in op de volgende formule.

   "The sentiment score is " & Round(First(sentimentCollection).score, 3) * 100 & "%"
   

   Deze formule haalt de gevoelsscore op vanuit de verzameling, maakt deze op en geeft deze weer:

   1. De functie First() retourneert de eerste (en in dit geval enige) record in sentimentCollect en geeft het score veld (het enige veld) weer dat aan die record is gekoppeld.

   2. De Round() functie rondt de score af op 3 plaatsen; de rest van de formule formatteert het resultaat als een percentage en voegt wat informatie toe voor de context.

De app testen

Voer nu de voltooide app uit om te controleren of deze werkt zoals verwacht.

1. Selecteer rechtsboven om de app uit te voeren.

2. Voer een zin in het tekstinvoerveld in en kies Score ophalen. De gevoelsscore moet binnen enkele seconden worden weergegeven.

De voltooide app ziet eruit als in de volgende afbeelding:

Het is een eenvoudige app, maar met een krachtige functionaliteit, omdat de app in staat is Cognitive Services aan te roepen via een aangepaste connector.

Volgende stappen

Deel de connector binnen uw organisatie en/of zorg ervoor dat de connector wordt gecertificeerd zodat personen buiten de organisatie deze kunnen gebruiken:

• Deel uw connector
• Certificeer uw connector

Feedback geven

We stellen feedback over problemen met ons connectorplatform of ideeën voor nieuwe functies zeer op prijs. Als u feedback wilt geven, gaat u naar Problemen melden of hulp krijgen met connectoren en selecteert u het type feedback.