Använda Azure OpenAI-kopplingar i visualiseringsuttryck
Förutom att lägga till Azure OpenAI-frågor och -svar i din apps datamodell med laddningsskriptet kan du också utföra de här åtgärderna direkt i ett diagram i din app. Data för ett enstaka fält skickas fram och tillbaka mellan dig och Azure OpenAI-tjänsten.
I många fall kan koden som används för en laddningsskriptskoppling modifieras och återanvändas för användning i ett diagram, med några skillnader.
Om användningscachen baseras på användarinmatning kan du använda en analyskoppling och motsvarande syntax för komplement på serversidan i ditt diagramuttryck till att skapa interaktiva diagram som visualiserar data som tagits emot från modellens slutpunkter.
Överväganden för dataförfrågningsvolymer
Vi rekommenderar att du endast använder Azure OpenAI-kopplingar i diagramuttryck för en eller ett fåtal rader med data. Vi avråder från att använda diagramuttryck för att skicka stora mängder data till tjänsten.
Det är viktigt att vara medveten om hur många rader du skickar med varje begäran. Fel vid konfigurering av Azure OpenAI-kopplingen i ett diagramuttryck kan leda till oavsiktligt stora begäran (t.ex. identiska rader med samma fråga på grund av felaktig användning av datamodellen i ett diagram). Ju större begäran du skickar till Azure OpenAI-tjänsten, desto större blir kostnaden för Microsoft Azure. Trots att det finns en begränsning för begäran på 25 rader per begäran för den här kopplingen är det ändå viktigt att ha detta i åtanke.
Följ dessa riktlinjer för att begränsa storleken på dina Azure OpenAI-begäran.
-
Använd bara dina Azure OpenAI-kopplingar i ett text och bild-diagramuttryck. Vi avråder starkt från att använda en Azure OpenAI-koppling i ett tabellobjekt, framför allt om du lägger till uttrycket i en tabell där en eller flera dimensioner redan har lagts till.
-
Om diagramuttrycket är länkat till din apps datamodell använder du en If-sats i uttrycket för att enbart beräkna diagrammet när ett enda urval görs i appen. Då reducerar du drastiskt antalet rader i de begäran som ditt diagram skickar till Azure OpenAI-tjänsten.
-
Om du använder en Azure OpenAI-koppling för att skicka stora begäran använder du kopplingen i ditt laddningsskript i stället för i ett diagramuttryck, så att data förladdas i din datamodell.
Snabbexempel
Här kan du hitta exempeluttryck som kan användas när du kommer igång med Azure OpenAI-kopplingen. Tänk på följande detaljer:
-
Använd endast uttryck med ett Text och bild-objekt.
-
Överväg att lägga till en if-förklaring till dina uttryck för att kontrollera när diagrammet beräknas om, och för att uppdatera beroende på användarval i appen.
-
För att uttrycken ska fungera måste du ersätta connectionname-värdet och eventuella fältnamn så att de matchar dina egna kopplingar och appar.
Ytterligare exempel hittar du här: Introduktionskurs – använda OpenAI-analyskopplingen i Qlik Cloud.
| Kopplingskonfiguration | Uttryck | Sammanfattning |
|---|---|---|
| OpenAI Completions API (GPT-3) – Rader | endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"OpenAI Connection for Rows Completions (GPT-3)","column":"choices.text"}}', 'Translate this text from english to spanish: The sun was rising over the new tomorrow with a tinge of excitement.') |
Denna sats kommer att returnera svaret på en enda fråga som har angivits i uttrycket. Anteckning om varning
Det här uttrycket använder inte en if-sats, och är därför inte lämpligt att användas om det är kopplat till ett fält i din datamodell. Det är endast lämpligt för användning i ett fristående uttryck med en cell för enkelvärdesindata som innehåller ett hårdkodat värde. |
| OpenAI Completions API (GPT-3) – Rader | if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_OpenAI_Connection_Rows_3","column":"choices.text"}}',vQuestion)) |
Detta är en sats som kan användas i ett Text och bild-objekt länkat till en Kontroll för variabelinmatning. Diagrammet beräknas endast när indata anges. När användaren anger indata i objektet och trycker på Enter, visar diagrammet svaret på deras indata. En genomgång finns här: Övning: Skapa en textindatabox med en variabel. |
| OpenAI Chat Completions API (GPT-3.5, GPT-4) – Rader | if(GetSelectedCount(BusinessTopic)=1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_OpenAI_Connection_Rows_3", "column":"choices.message.content"}}', 'What are people saying about ' & 'BusinessTopic'), 'Please select a single value for BusinessTopic.') | Detta är en komplex if-sats där diagrammet endast beräknas om användaren har valt ett värde för fältet BusinessTopic. Diagrammet uppdateras bara om användaren har gjort detta val i appen, och om de inte har gjort det, visar diagrammet följande alternativa meddelande: Please select a single value for BusinessTopic. |
| OpenAI Chat Completions API (GPT-3.5, GPT-4) – Rader | if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_OpenAI_Connection_Rows_3","column":"choices.message.content"}}',vQuestion)) |
Detta är en sats som kan användas i ett Text och bild-objekt länkat till en Kontroll för variabelinmatning. Diagrammet beräknas endast när indata anges. När användaren anger indata i objektet och trycker på Enter, visar diagrammet svaret på deras indata. En genomgång finns här: Övning: Skapa en textindatabox med en variabel. |
| OpenAI Chat Completions API (GPT-3.5, GPT-4) – Rader | if( count(distinct [IssueCategory]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"My_OpenAI_Connection_Chat_3_5","column":"choices.message.content"}}', 'write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory])) | I det här exemplet beräknas diagrammet endast om ett distinkt värde har valts från fältet IssueCategory i appens datamodell. En begäran skickas för att be om ett exempelsvar från en avdelning för teknisk support om en allmän typ av problem, en lista som finns i fältet IssueCategory. Diagrammet uppdateras beroende på det värde som valts av användaren. |
Detaljerade exempel
Exempel som visar hur du använder Azure OpenAI-kopplingen i diagramuttrycken finns i introduktionskursen för OpenAI-kopplingen. Observera att Azure Open AI-kopplingen kommunicerar med modellerna via Microsoft Azure-plattformen i stället för OpenAI-plattformen.
Introduktionskurs – använda OpenAI-analyskopplingen i Qlik Cloud
Exempel 1: Konfiguration med "OpenAI Completions API (GPT-3) – Rader"
Exempel 3: Konfiguration med "OpenAI Chat Completions API (GPT-3.5, GPT-4,) – Rader"
OpenAI -analyskoppling – Interaktivt exempel