Dela via

Skapa HTTP-begäranden

  • Artikel

I Copilot Studio kan du kan utöka en copilot kapacitet genom att anropa externa REST API:er med hjälp av HTTP-begäran. Detta anrop kan vara användbart när du behöver hämta data från ett externt system eller manipulera data i det systemet.

Förutsättningar

Använda noden för HTTP-begäran

  1. Välj Lägg till nod (+), öppna undermenyn Avancerat och välj Skicka HTTP-begäran.

    Skärmbild av alternativet skicka HTTP-begäran i den avancerade menyn.

  2. I rutan URL ange URL för den API-slutpunkt som ska anropas.

  3. Välj rätt begäran Metod från listrutan. Metoderna GET, POST, PATCH, PUT och DELETE stöds.

    Skärmbild av slutförd API-URL och listrutan metod

  4. Under Rubriker och brödtext i noden ska du välja knappen Redigera , som öppnar fönstret Egenskaper för HTTP-begäran.

  5. Du kan även lägga till en eller flera rubriker i HTTP-begäran. Välj knappen Lägg till för att lägga till respektive rubriks nyckel och värde.

    Skärmbild av listan med huvudnyckelpar för HTTP-nod.

  6. Som standard skickas inget innehåll i brödtexten i HTTP-begäran, men du kan ange innehåll i innehållet i brödtexten.

  7. Svar på noden Datatypen för svar från de tillgängliga alternativen.

    Du kan ge ett exempel på JSON-svar som du vanligtvis hittar i dokumentationen för det API du anropar. Detta genererar en Power Fx-variabel så att du kan använda den på andra ställen i redigeringsarbetsytan, med intellisense-stöd i Power Fx-redigeraren. Välj Från exempeldata och välj sedan Hämta schema från exempel-JSON. Klistra in exempelsvaret i redigeraren och välj Bekräfta.

    Skärmbild av Hämta schema från exempelredigeraren för JSON.

  8. Under Spara svar som väljer du var HTTP-begärans svar ska lagras, antingen skapar du en ny variabel eller markerar en befintlig.

Skicka innehåll i brödtexten för HTTP-begäran

  1. Under Rubriker och brödtext i noden ska du välja knappen Redigera , som öppnar fönstret Egenskaper för HTTP-begäran.

  2. Under Brödtext, välj lämplig innehållstyp. Som standard anges Brödtext till Inget innehåll, där inget innehåll ska finnas i denna begärans brödtext, vilket är det vanligaste innehållet i en GET-begäran. Om du vill lägga till innehåll i brödtexten väljer du bland ett av de tillgängliga alternativen.

    Skärmbild av listrutan med alternativ för innehåll

    • JSON-innehåll: JSON-innehåll kan du tillhandahålla ett JSON-objekt i begärans brödtexten. Objektet används ofta när du gör POST- eller PUT-begäranden. När du väljer det här alternativet kan du ange JSON-innehållet med en redigerare.

      Du kan också specificera ditt JSON-innehåll med Power Fx, så att du kan inkludera dynamiska värden och referensvariabler. Välj knappen Redigera JSON, väljFormel och ange sedan ett Power Fx-objekt (en befintlig JSON som konverterats till ett Power Fx-objekt åt dig), som konverteras till JSON när denna HTTP-begäran görs.

      Skärmbild av JSON-innehåll som markerats för innehållstyp.

    • Oformaterat innehåll: Med oformaterat innehåll kan du infoga en datasträng i brödtexten för förfrågan och den här strängen kan vara av valfri innehållstyp du anger. Råinnehåll anges med en Power Fx-formel, till exempel stränginnehållet som visas i följande exempel.

      Skärmbild av RAW-innehåll som markerats för innehållstyp.

Felhantering och tidsgräns

Noden HTTP-begäran har flera alternativ för hantering av situationer där denna HTTP-begäran kan misslyckas eller returnera ett fel.

Som standard skapar funktionen ett fel. Detta innebär att när en HTTP-begäran returnerar ett fel eller inte kan köras, kommer copilot att stoppa åtgärden och utlösa systemämnet Fel, och ett felmeddelande visas.

Du kan emellertid konfigurera felhanteringen till att inte utlösa systemämnet Fel. I stället fylls HTTP-statuskoden och eventuella felsvar i de variabler som du anger, vilket gör att du kan ange de här variablerna efter behov och ämnet kan fortsätta köras. Den här konfigurationen är användbar i situationer där du vill att copilot ska fortsätta med åtgärden även om en viss HTTP-begäran misslyckas.

Konfigurera felhanteringsbeteendet.

  1. Under Rubriker och brödtext i noden ska du välja knappen Redigera , som öppnar fönstret Egenskaper för HTTP-begäran.

  2. Välj önskat beteende i listrutan Felhantering.

  3. Om du väljer Fortsätt på fel konfigurerar du variablerna Statuskod och Brödtext för felsvar, antingen skapar du nya variabler eller markerar befintliga variabler i väljaren.

    Skärmbild på felhantering som konfigurerats för att fortsätta med fel med variabler som angetts för statuskod och brödtext för felsvar.

Om HTTP-förfrågan misslyckas i det här kodexemplet lagras HTTP-statuskoden i variabeln Topic.StatusCode och svarstexten i variabeln Topic.ErrorResponse. Copilot fortsätter sedan vidare till nästa steg i ämnet.

Variabeltypen Felsvar är Valfri. Du kan använda Parsa värdekod om du vill konvertera den här variabeln till en Power Fx-post.

Egenskapsfönstret innehåller också egenskapen Tidsgräns för begäran som godkänner ett värde i millisekunder. Standardvärdet är 30 sekunder, men du kan ändra det här värdet om det behövs.