Köra automatiseringsarbetsflöden från åtgärder i agenter med Azure AI Foundry och Azure Logic Apps (förhandsversion)

Gäller för: Azure Logic Apps (Förbrukning)

Anmärkning

Den här funktionen är i förhandsversion, kan medföra avgifter och omfattas av de kompletterande användningsvillkoren för Förhandsversioner av Microsoft Azure.

När du har en AI-app i Azure AI Foundry som behöver automatisera processer i flera steg eller integrera med olika tjänster, system, appar och datakällor kan du lägga till åtgärder i agenter för att köra automatiseringsarbetsflöden i Azure Logic Apps.

I Azure AI Foundry använder en agent en åtgärd och en AI-modell för att självständigt eller interaktivt slutföra en uppgift. Agenter använder till exempel åtgärder för att besvara frågor, hämta information och utföra andra jobb med hjälp av AI-modeller.

I Azure Logic Apps automatiserar ett arbetsflöde för logikappar processer och kan integrera Azure, Microsoft och tjänster, system, appar och datakällor i andra ekosystem – vanligtvis utan extra kod. Arbetsflödet använder en fördefinierad utlösare och åtgärder från ett galleri med över 1 400 anslutningsappar tillsammans med körningsbaserade eller inbyggda åtgärder.

Följande diagram visar hur en åtgärd på en agent i Azure AI Foundry relaterar till ett logikapparbetsflöde i Azure Logic Apps:

Den här guiden visar hur du lägger till en åtgärd i en agent i Azure AI Foundry så att agenten skapar ett arbetsflöde för förbrukningslogikappen som körs i Azure Logic Apps med flera klientorganisationer. En guide vägleder dig genom stegen för att konfigurera den här åtgärden med ett fördefinierat arbetsflöde för logikappar. När du har lagt till åtgärden kan du utöka arbetsflödet baserat på ditt scenarios behov med hjälp av den grafiska designern i Azure Logic Apps.

Mer information finns i följande dokumentation:

• Vad är Azure AI Foundry?
• Vad är Azure Logic Apps?
• Arbetsflöde för logikapp för konsumtion – Alternativ för värdtjänster

Förutsättningar

• Ett Azure-konto och prenumeration. Om du heller inte har någon Azure-prenumeration kan du registrera ett kostnadsfritt Azure-konto.

• Ett Azure AI Foundry-projekt som skapas med en standardhubb.

  Det här projektet organiserar ditt arbete och sparar tillståndet när du skapar dina AI-appar. Hubben är värd för ditt projekt och tillhandahåller en gruppsamarbetesmiljö.

  För att skapa ett projekt med en hubb behöver du någon av följande roller för rollbaserad åtkomstkontroll i Microsoft Entra (RBAC), baserat på principen om lägsta behörighet:

  • Deltagare (minst behörighet)

  • Ägare

  Om du innehar någon annan roll behöver du få hubben skapad för dig. Mer information finns i följande dokumentation:

  • Standardroller för projekt

  • Standardroller för hubbar

• En distribuerad Azure OpenAI-tjänstmodell för ditt projekt.

  Om du inte har någon distribuerad modell kan du läsa Distribuera en modell.

• En agent i projektet.

  Det här kravet omfattar distribution av en modell i Azure OpenAI-tjänsten som agenten ska använda medan arbetsflödet körs.

Kan jag skapa och använda mina egna arbetsflöden som åtgärder?

Ja, för att göra dina egna arbetsflöden för logikappar tillgängliga via åtgärdsgalleriet i Azure AI Foundry-portalen måste dina arbetsflöden uppfylla följande krav:

• Logikappresursen som innehåller arbetsflödet använder värdalternativet Förbrukning .

• Den logiska appresursen använder den Azure-prenumeration som du har med Azure AI Foundry.

• Arbetsflödet börjar med utlösaren med namnet När en HTTP-begäran tas emot.

• Utlösaren innehåller en beskrivning som du anger i fönstret utlösarinformation i arbetsflödesdesignern.

• Arbetsflödet avslutas med åtgärden Svar.

Din AI-app har nästan oändliga alternativ för att köra arbetsflöden som interagerar med Azure, Microsoft och andra tjänster eller produkter, samt åtgärder som hjälper dig att hantera, forma, konvertera och transformera data. Om det inte finns någon fördefinierad anslutningsapp för det du vill göra kan du också skapa en egen.

Mer information finns i följande dokumentation:

• Snabbstart: Skapa ett exempelflöde för en förbrukningslogikapp med hjälp av Azure-portalen
• Vad är anslutningar i Azure Logic Apps
• Hanterade anslutningar som körs i den globala, multitenanta Azure-miljön
• Teknisk referens för hanterade kontakter för Azure Logic Apps
• Inbyggda åtgärder som körs med Azure Logic Apps-körning
• Anpassade kontakter i Azure Logic Apps

Begränsningar och kända problem

Den här versionen har följande begränsningar eller kända problem:

Begränsning

Beskrivning

Stöd för arbetsflöde för logikapp

Agentåtgärder stöder för närvarande endast arbetsflöden för konsumtionslogikappar i Azure Logic Apps med flera klienter. En förbrukningslogikappresurs kan bara ha ett arbetsflöde. Mer information finns under Hostingalternativ för distributioner. Agentåtgärder stöder för närvarande inte standardarbetsflöden för logikappar i Azure Logic Apps för en enda klientorganisation, App Service-miljöer eller hybriddistributioner. En standardlogikapp kan ha flera arbetsflöden. Mer information finns under Hostingalternativ för distributioner.

Lägga till en åtgärd i din agent

Följ de här stegen för att konfigurera en åtgärd för agenten för att skapa och köra ett logikapparbetsflöde.

1. Logga in på Azure AI Foundry-portalen och öppna projektet.

2. I projektöversikten går du till portalens navigeringsmeny och under Skapa och anpassa väljer du Agenter. På sidan Agenter går du till Mina agenter och väljer din agent.

   

3. I avsnittet Installation bredvid listan med agenter rullar du ned till avsnittet Åtgärder och väljer Lägg till.

   

4. I fönstret Lägg till åtgärd väljer du Azure Logic Apps.

   

5. Under Välj en åtgärd väljer du en fördefinierad åtgärd med någon av följande etiketter:

   Åtgärdsetikett	Beskrivning
   Författad av Microsoft	Den här åtgärden använder en Microsoft-skapad mall för att skapa arbetsflödet för åtgärden.
   Arbetsflöde	Den här åtgärden använder ett berättigat logikapparbetsflöde i din Azure-prenumeration som en mall för att skapa arbetsflödet för åtgärden. Obs! Om du väljer det här alternativet går du vidare till avsnittet Bekräfta åtgärdsinformation. Om dina arbetsflöden inte visas som förväntat i åtgärdsgalleriet kontrollerar du kraven.

   I exempel nedan används Microsoft-skapade åtgärden med namnet Get Weather forecast for today via MSN Weather:

   

6. I åtgärdsfönstret Lägg till logikapp under Ange grundläggande information anger du följande information:

   Parameter	Krävs	Värde	Beskrivning
   Ditt åtgärdsnamn	Ja	< action-name>	Ett vänligt, men uppgiftsfokuserat, verb-först, koncist namn för åtgärden. Det här namnet används också för logikappens resurs och arbetsflöde i Azure Logic Apps. Obs! – Åtgärdsnamnet kan bara använda bokstäver, siffror och följande specialtecken: -, (, ), _eller .. – Du kan inte använda blanksteg eller andra specialtecken. – En konsumtionslogikappresurs och ett arbetsflöde kombineras och har en 1:1-relation, vilket innebär att de använder samma namn. Som jämförelse kan en standardlogikappresurs ha flera arbetsflöden som använder olika namn. I det här exemplet används Get-weather-forecast-today.
   Din åtgärdsbeskrivning	Ja	< åtgärdsbeskrivning>	En beskrivning som tydligt beskriver syftet med åtgärden. I det här exemplet används Den här åtgärden skapar ett anropbart arbetsflöde för förbrukningslogikappen som hämtar väderprognosen för idag och körs i globala Azure Logic Apps med flera klientorganisationer.
   Prenumeration	Ja	< Azure-prenumeration>	Den Azure-prenumeration som ska användas, förmodligen samma som ditt projekt och din modell.
   resursgrupp	Ja	< Azure-resursgrupp>	Den Azure-resursgrupp som ska användas.
   Läge	Ja	< Azure-region>	Den Azure-region där du ska vara värd för logikappens resurs och arbetsflöde.

   Följande skärmbild visar exempelinformationen för exempelåtgärden Get-weather-forecast-today:

   

7. När du är klar väljer du Nästa.

Skapa och autentisera anslutningar

Följ de här stegen för att skapa anslutningar som åtgärden behöver och autentisera åtkomst till relevanta tjänster, system, appar eller datakällor. Den underliggande mallen anger vilka anslutningar som ska användas för den här åtgärden och arbetsflödet i logikappen.

1. I åtgärdsfönstret Lägg till logikapp går du igenom alla anslutningar som du behöver för att skapa och autentisera under Autentisera.

2. I kolumnen Anslutning väljer du Anslut för den relaterade tjänsten eller datakällan.

   Följande skärmbild visar exempelanslutningen för att skapa och autentisera för MSN Weather-tjänsten:

   

   Vissa anslutningar kräver mer information, så följ anvisningarna för att ange den begärda informationen.

3. Upprepa de här stegen för varje nödvändig anslutning.

4. När du är klar väljer du Nästa.

Bekräfta detaljer för åtgärden

Granska och kontrollera att all åtgärdsinformation visas korrekt. Om du har valt en Microsoft-redigerad åtgärd granskar och godkänner du bekräftelseutdraget.

1. I åtgärdsfönstret Lägg till logikapp går du till Resurs och kontrollerar all angivet åtgärdsinformation.

2. Utför följande steg för en vald Microsoft-redigerad åtgärd:

   1. Granska uttalandet där du bekräftar och förstår följande händelser som inträffar efter att du lämnat resurssidan genom att välja Nästa:

      • Du kan inte återgå till föregående steg.

      • Åtgärden skapar en logikappsresurs av typen Consumption.

      • Anslutning till Azure Logic Apps medför avgifter i ditt Azure-konto.

        Mer information om faktureringsmodellen för arbetsflöden för förbrukningslogikappar finns i följande dokumentation:

        • Användningsmätning, fakturering och prissättning

        • Prissättning för Azure Logic Apps (förbrukningsplan – flera klientorganisationer)

   2. Om du vill godkänna väljer du bekräftelserutan, till exempel:

      

3. När du är klar väljer du Nästa

Slutför skapandet av åtgärden

I det sista steget går du igenom den information som portalen genererar om verktyget som används av agenten för att köra din åtgärd och autentisera åtkomst till relevanta tjänster eller resurser från Azure, Microsoft och andra tjänster eller resurser än Microsoft.

1. I åtgärdsfönstret Lägg till logikapp går du till sidan Schema och granskar följande information och ser till att ange en beskrivning av omständigheterna för att anropa verktyget:

   Parameter	Beskrivning
   Verktygsnamn	Det redigerbara namnet på verktyget som agenten använder för att köra din åtgärd och få åtkomst till Azure, Microsoft, externa tjänster, datakällor eller specialiserade AI-modeller så att agenten kan hämta data, köra uppgifter och interagera med andra plattformar. Obs! – Åtgärdsnamnet kan bara använda bokstäver, siffror och understreck (_). – Du kan inte använda blanksteg eller andra specialtecken.
   Anslutning för autentisering	Skrivskyddat namn för anslutningen som agenten använder för att komma åt Azure, Microsoft och externa resurser utan att behöva be om autentiseringsuppgifter varje gång. För mer information, se Connections in Azure AI Foundry portal.
   Beskriva hur du anropar verktyget	Beskrivningen som anger omständigheterna för när agenten anropar verktyget.
   Skema	Schemat för logikappens arbetsflöde i JSON-format (JavaScript Object Notation).

   

2. När du är klar väljer du Skapa.

   Portalen returnerar dig till sidan Agenter för den valda agenten. I avsnittet Installation visar avsnittet Åtgärder nu namnet på verktyget som kör åtgärden och visar ikonen för Azure Logic Apps bredvid verktygsnamnet, till exempel:

   

Testa agentåtgärden

Följ dessa steg för att prova den nya åtgärden för din agent med hjälp av agenternas lekplats:

1. På sidan Agenter, överst i avsnittet Konfiguration, välj Prova i testmiljön.

2. På sidan Agenters lekplats i chattrutan för användarfrågor ställer du en fråga om vädret, till exempel:

   Vad är vädret i London? Visa resultatet i punktlistformat.

   Agenten returnerar ett svar som liknar följande exempel:

   

Granska underliggande logikapp och arbetsflöde

När åtgärden har körts kan du visa den underliggande logikappresursen och arbetsflödet i Azure-portalen. Du kan granska arbetsflödets körningshistorik, som du kan använda för att felsöka eller identifiera problem som arbetsflödet kan uppleva.

1. Logga in på Azure-portalen. I sökrutan för portalens namnlist anger du namnet på den åtgärd som du skapade.

2. I resultatlistan går du till Resurser och väljer logikappresursen.

   

3. Om du vill visa arbetsflödets körningshistorik, indata, utdata och annan information går du till logikappmenyn under Utvecklingsverktyg och väljer Kör historik.

4. I listan Körningshistorik väljer du den senaste arbetsflödeskörningen, till exempel:

   

5. När övervakningsvyn öppnas och visar status för varje åtgärd i arbetsflödet väljer du en åtgärd för att öppna informationsfönstret och granska åtgärdens indata och utdata.

   I det här exemplet väljs åtgärden Get forecast for today (Hämta prognos för idag), till exempel:

   

   Mer information om arbetsflödeskörningshistorik finns i Visa arbetsflödesstatus och körningshistorik.

Öppna arbetsflödet i designern

Följ de här stegen för att granska arbetsflödets definition och åtgärder eller redigera arbetsflödet genom att öppna arbetsflödesdesignern.

1. På logikappmenyn går du till Utvecklingsverktyg och väljer designern.

   Arbetsflödet öppnas i designern. Nu kan du granska arbetsflödets åtgärder, som refererar till utlösaren och åtgärderna, till exempel:

   

2. Om du vill visa en åtgärds parametrar och inställningar i designern väljer du åtgärden, till exempel:

   

3. Om du vill utöka arbetsflödets beteende kan du lägga till fler åtgärder genom att följa stegen i Skapa ett arbetsflöde med en utlösare eller åtgärd.

   För att det här arbetsflödet eller något annat arbetsflöde ska visas i åtgärdsgalleriet och köras som en åtgärd i en agent måste arbetsflödet alltid uppfylla följande krav:

   • Logikappresursen som innehåller arbetsflödet måste använda värdalternativet Förbrukning.

   • Logikappresursen måste använda samma Azure-prenumeration som du använder med Azure AI Foundry.

   • Arbetsflödet måste börja med utlösaren När en HTTP-begäran tas emot.

   • Utlösaren kräver en beskrivning, som du kan hitta i informationen om utlösaren i designern.

   • Arbetsflödet måste avslutas med åtgärden Svar.

   Försiktighet

   Även om du kan lägga till åtgärder och ändra arbetsflödet ska du inte redigera den ursprungliga utlösaren och åtgärderna för att undvika att bryta relationen mellan arbetsflödet, agenten och åtgärden. Deras parametrar har konfigurerats för att fungera tillsammans, så ändringar i dessa åtgärder riskerar att bryta åtgärden i agenten. Överväg i stället att skapa en anpassad version eller ett annat arbetsflöde som du kan lägga till som en åtgärd i en agent.

   Utlösaren använder till exempel följande parametrar, som är nödvändiga för att anropa utlösaren:

   Parameter	Beskrivning
   Namn	Det här namnet är en del av utlösarens HTTPS-URL. Externa anropare, till exempel andra tjänster, utanför arbetsflödet skickar en HTTPS-begäran till den här URL:en, vilket utlöser utlösaren och startar arbetsflödet. Utlösaren är alltid det första steget i ett arbetsflöde och anger villkoret som ska uppfyllas för att utlösaren ska köras.
   HTTPS-URL	När arbetsflödet sparas för första gången genereras den här URL:en och används för att anropa en slutpunkt som utlösaren skapar för arbetsflödet.
   Metod	Den här inställningen anger om utlösaren accepterar alla eller endast specifika HTTPS-metoder.
   JSON-schema för begärandetext	Om du vill verifiera de indata som utlösaren förväntar sig att ta emot i HTTPS-begäran som skickas från externa anropare, anger det här schemat det JSON-schema som ska användas för att verifiera indata.

4. Om du vill spara ändringar som du gör i designerverktygsfältet väljer du Spara.

Testa ett arbetsflöde i designern

Om du har gjort ändringar i väderarbetsflödet eller testat ett annat arbetsflöde följer du dessa steg:

1. I designerverktygsfältet väljer du Kör>kör med nyttolast.

2. När fönstret Kör med nyttolast öppnas anger du förväntade utlösarindata i JSON-format i fältet Brödtext , till exempel:

   {
       "location": {
           "type": "London",
           "description": "Location for the weather"
       }
   }
   

3. När du är klar väljer du Kör.

   På fliken Utdata innehåller svarstexten resultatet och svaret från arbetsflödet.

4. Om arbetsflödeskörningen genererar fel eller kräver felsökning öppnar du arbetsflödets körningshistorik så att du kan undersöka varje åtgärds indata och utdata med hjälp av relevanta steg i Granska underliggande logikapp och arbetsflöde.

Fakturering och prissättning

Arbetsflöden för förbrukningslogikappar medför avgifter baserade på faktureringsmodellen "betala för användning". Mer information om den här modellen finns i följande resurser:

• Användningsmätning, fakturering och prissättning
• Prissättning för Azure Logic Apps (förbrukningsplan – flera klientorganisationer)

Information om Azure AI Foundry finns i följande resurser:

• Planera och hantera kostnader för Azure AI Foundry
• Prissättning för Azure AI Foundry

Rensa resurser

Om du inte behöver de resurser som du skapade för den här guiden tar du bort resurserna så att du inte fortsätter att debiteras. Du kan antingen följa de här stegen för att ta bort resursgruppen som innehåller dessa resurser, eller så kan du ta bort varje resurs individuellt.

1. I Azure AI Foundry-portalen väljer du knappen ellipser (...) bredvid åtgärdsnamnet för att ta bort åtgärden från agenten och väljer sedan Ta bort.

2. I sökrutan i azure-portalens namnlist anger du resursgrupper och väljer Resursgrupper.

3. Leta reda på resursgruppen som innehåller dina distribuerade hubbresurser.

4. I verktygsfältet Översikt väljer du Ta bort resursgrupp.

5. När bekräftelsefönstret visas anger du resursgruppens namn och väljer Ta bort.

Relaterat innehåll

• Vad är anslutningar i Azure Logic Apps?
• Vad är Azure AI Foundry?
• Vad är Azure Logic Apps?