Anropa Azure Logic Apps som funktioner med Hjälp av Azure OpenAI-assistenter
Kommentar
Den här funktionen är för närvarande endast tillgänglig i Azure OpenAI Studio.
Azure Logic Apps är en integrationsplattform i Azure som gör att du kan skapa arbetsflöden för program och automatisering med verktyg med låg kod som ger utvecklare produktivitet och snabbare tid till marknaden. Genom att använda den visuella designern och välja mellan hundratals fördefinierade anslutningsappar kan du snabbt skapa ett arbetsflöde som integrerar och hanterar dina appar, data, tjänster och system.
Azure Logic Apps hanteras helt av Microsoft Azure, vilket gör att du inte behöver bekymra dig om att hantera, skala, hantera, övervaka och underhålla lösningar som skapats med dessa tjänster. När du använder dessa funktioner för att skapa serverlösa appar och lösningar kan du bara fokusera på affärslogik och funktioner. Dessa tjänster skalas automatiskt för att uppfylla dina behov, göra automatiseringsarbetsflöden snabbare och hjälpa dig att skapa robusta molnappar med lite eller ingen kod.
Funktionsanrop i Azure Logic Apps via Assistants Playground
För att påskynda och förenkla skapandet av intelligenta program gör vi nu det möjligt att anropa Logic Apps-arbetsflöden via funktionsanrop i Azure OpenAI-assistent.
Assistenternas lekplats räknar upp och visar alla arbetsflöden i din prenumeration som är berättigade till funktionsanrop. Här följer kraven för dessa arbetsflöden:
- Förbrukningslogikappar: För närvarande stöder vi endast förbrukningsarbetsflöden.
- Utlösare för begäran: Funktionsanrop kräver ett REST-baserat API. Logic Apps med en begärandeutlösare tillhandahåller en REST-slutpunkt. Därför stöds endast arbetsflöden med en begärandeutlösare för funktionsanrop.
- Schema: De arbetsflöden som du vill använda för funktionsanrop bör ha ett JSON-schema som beskriver indata och förväntade utdata. Med Logic Apps kan du förenkla och ange schema i utlösaren, som automatiskt importeras som en funktionsdefinition.
Om du redan har arbetsflöden med över tre krav bör du kunna använda dem i Azure OpenAI Studio och anropa dem via användarfrågor. Om du inte har befintliga arbetsflöden kan du följa stegen i den här artikeln för att skapa dem. Det finns två primära steg:
- Skapa en logikapp på Azure-portalen.
- Importera dina Logic Apps-arbetsflöden som en funktion i Assistants Playground.
Skapa Logic Apps-arbetsflöden för funktionsanrop
Här följer stegen för att skapa ett nytt Logic Apps-arbetsflöde för funktionsanrop.
I sökrutan i Azure-portalen anger du logikappar och väljer Logikappar.
På sidan Logikappar väljer du Lägg till.
På sidan Skapa logikapp väljer du först plantypen för logikappresursen. På så sätt visas bara alternativen för den plantypen.
I avsnittet Plan väljer du Förbrukning för att endast visa resursinställningarna för förbrukningslogikappen.
Ange följande information för logikappresursen: Prenumeration, Resursgrupp, Logikappnamn och Region.
När du är klar väljer du Granska + Skapa.
På valideringssidan som visas bekräftar du all angivet information och väljer Skapa.
När Azure har distribuerat logikappresursen väljer du Gå till resurs. Du kan också söka efter och välja din logikappresurs genom att skriva namnet i Azure-sökrutan.
Öppna Logic Apps-arbetsflödet i designern. Välj Utvecklingsverktyg + Logikappdesigner. Då öppnas ditt tomma arbetsflöde i designern. Eller så väljer du Tom logikapp från mallar
Nu är du redo att lägga till ytterligare ett steg i arbetsflödet. Ett arbetsflöde börjar alltid med en enda utlösare, som anger villkoret som ska uppfyllas innan efterföljande åtgärder i arbetsflödet körs.
Arbetsflödet måste ha en utlösare för begäran för att generera en REST-slutpunkt och en svarsåtgärd för att returnera svaret till Azure OpenAI Studio när det här arbetsflödet anropas.
Lägg till en utlösare (begäran)
Välj Lägg till en utlösare och sök sedan efter utlösare för begäran. Välj åtgärden När en HTTP-begäran tas emot .
Ange JSON-schemat för begäran. Om du inte har schemat använder du alternativet för att generera schema.
Här är ett exempel på begärandeschemat. Du kan lägga till en beskrivning för arbetsflödet i kommentarsrutan. Detta importeras av Azure OpenAI Studio som funktionsbeskrivning.
Spara arbetsflödet. Detta genererar REST-slutpunkten för arbetsflödet.
Beroende på affärsanvändningsfallet kan du nu lägga till ett eller flera steg/åtgärder i det här arbetsflödet. Du kan till exempel använda MSN-väderanslutningen för att hämta väderprognosen för den aktuella platsen.
I åtgärden för att få prognos för idag använder vi platsegenskapen som skickades till det här arbetsflödet som indata.
Konfigurera svaret. Arbetsflödet måste returnera svaret tillbaka till Azure OpenAI Studio. Detta görs med hjälp av åtgärden Svar.
I svarsåtgärden kan du välja utdata från något av föregående steg. Du kan också ange ett JSON-schema om du vill returnera utdata i ett visst format.
Arbetsflödet är nu klart. I Azure OpenAI Studio kan du importera den här funktionen med funktionen Lägg till funktion i Assistenternas lekplats.
Importera dina Logic Apps-arbetsflöden som funktioner
Här följer stegen för att importera dina Logic Apps-arbetsflöden som funktion i Assistants Playground i Azure OpenAI Studio:
I Azure OpenAI Studio väljer du Assistenter. Välj en befintlig assistent eller skapa en ny. När du har konfigurerat assistenten med ett namn och instruktioner är du redo att lägga till en funktion. Välj + Lägg till funktion.
Alternativet Lägg till funktion öppnar en skärm med två flikar. Gå till fliken för Logic Apps för att bläddra i dina arbetsflöden med en begärandeutlösare. Välj arbetsflödet i listan och välj Spara.
Kommentar
Den här listan visar bara SKU-arbetsflöden för förbrukning och med en begärandeutlösare.
Nu har du importerat arbetsflödet och det är redo att anropas. Funktionsspecifikationen genereras baserat på logikapparnas arbetsflödesswaagger och innehåller schemat och beskrivningen baserat på vad du konfigurerade i utlösaråtgärden för begäran.
Arbetsflödet anropas nu av Azure OpenAI Assistants baserat på användarprompten. Nedan visas ett exempel där arbetsflödet anropas automatiskt baserat på användarens uppmaning för att hämta vädret.
Du kan bekräfta anropet genom att titta på loggarna och arbetsflödets körningshistorik.
Vanliga frågor
Vad är Logic Konektor aplikacija s?
Azure Logic Apps har kopplingar till hundratals verksamhetsspecifika program och databaser, inklusive men inte begränsat till: SAP, Salesforce, Oracle, SQL med mera. Du kan också ansluta till SaaS-program eller dina interna program som finns i virtuella nätverk. Dessa färdiga anslutningsappar tillhandahåller åtgärder för att skicka och ta emot data i flera format. Om du använder dessa funktioner med Azure OpenAI-assistenter bör du snabbt kunna hämta dina data för Intelligent Insights som drivs av Azure OpenAI.
Vad händer när en Logic Apps importeras i Azure OpenAI Studio och anropas
Logic Apps swagger-filen används för att fylla i funktionsdefinitioner. Azure Logic App publicerar en OpenAPI 2.0-definition (swagger) för arbetsflöden med en begärandeutlösare baserat på anteckningar i arbetsflödet. Användare kan ändra innehållet i den här swagger genom att uppdatera sitt arbetsflöde. Azure OpenAI Studio använder detta för att generera de funktionsdefinitioner som assistenten kräver.
Hur fungerar autentisering från Azure OpenAI Studio till Logic Apps?
Logic Apps stöder två primära typer av autentiseringar för att anropa en begärandeutlösare.
Sas-baserad autentisering (Signatur för delad åtkomst).
Användare kan hämta en motringnings-URL som innehåller en SAS med hjälp av URL-API:et för återanrop i listan. Logic Apps har också stöd för att använda flera nycklar och rotera dem efter behov. Logic Apps har också stöd för att skapa SAS-URL:er med en angiven giltighetsperiod. Mer information finns i Logic Apps-dokumentationen.
Microsoft Entra ID-baserad OAuth-basautentiseringsprincip.
Logic Apps stöder även autentiseringsutlösare med Microsoft Entra ID OAuth, där du kan ange autentiseringsprinciper som ska användas för att verifiera OAuth-token. Mer information finns i Logic Apps-dokumentationen.
När Azure OpenAI Assistants kräver att en logikapp anropas som en del av funktionsanropet hämtar Azure OpenAI Studio återanrops-URL:en med SAS för att anropa arbetsflödet.