Del via

Foretag HTTP-forespørgsler

  • Artikel

I Copilot Studio kan du udvide en copilots muligheder ved at kalde eksterne REST-API'er ved hjælp af HTTP-anmodningsnoden. Dette kald kan være nyttigt, når du skal hente data fra et eksternt system eller manipulere data på det pågældende system.

Forudsætninger

Brug af HTTP-anmodningsnoden

  1. Vælg Tilføj node (+), åbn undermenuen Avanceret , og vælg derefter Send HTTP-anmodning.

    Skærmbillede af indstillingen med send HTTP-anmodning i den avancerede menu.

  2. I feltet URL-adresse skal du angive webadressen til den API slutpunkt du vil ringe til.

  3. Vælg den rette anmodning Metode på rullelisten. Metoderne HENT, POST, PATCH, PUT og SLET understøttes.

    Skærmbillede af fuldført URL-adresse til API og metode dropdown

  4. Vælg Overskrifter og brødtekst på noden, vælg knappen Rediger, som åbner ruden med egenskaber for HTTP-anmodninger.

  5. Du kan også føje en eller flere overskrifter til HTTP-anmodningen. Vælg knappen Tilføj for at tilføje nøglen og værdien i de enkelte overskrifter.

    Skærmbillede af listen over header-nøgleværdipar for HTTP-node.

  6. Der sendes som standard ikke indhold i brødteksten til HTTP-anmodningen, men du kan angive indhold i brødteksten.

  7. Vælg datatypen Respons blandt de tilgængelige indstillinger i noden.

    Du kan komme med et eksempel på JSON-svar, som du som regel kan finde i dokumentationen til den API, du kalder. Der oprettes en Power Fx-variabel, så du kan bruge den andre steder i dit oprettelseslærred med IntelliSense-support i editoren Power Fx. Vælg Fra eksempeldata, og vælg derefter Hent skema fra eksempel-JSON. Indsæt eksempelsvaret i editoren, og vælg Bekræft.

    Skærmbillede af hent skemaet fra JSON-eksempeleditoren.

  8. Under Gem svar som kan du vælge, hvor HTTP-anmodningsresponset skal gemmes, ved enten at oprette en ny variabel eller vælge en eksisterende variabel.

Sende indhold i brødteksten til HTTP-anmodningen

  1. Vælg Overskrifter og brødtekst på noden, vælg knappen Rediger, som åbner ruden med egenskaber for HTTP-anmodninger.

  2. Vælg den rette indholdstype under Brødtekst. Som standard er Brødtekst angivet til Intet indhold, hvor der ikke skal være indhold i brødteksten af anmodningen, som normalt bruges sammen med GET-anmodningen. Hvis du vil føje indhold til brødteksten, skal du vælge en af de tilgængelige indstillinger.

    Rulleliste med indstillinger for brødtekstindhold

    • JSON-indhold: JSON-indhold giver dig mulighed for at levere et JSON-objekt i brødteksten til anmodningen. Dette objekt bruges ofte, når du foretager POST- eller PUT-anmodninger. Når denne indstilling er valgt, kan du angive JSON-indholdet i en editor.

      Du kan også angive dit JSON-indhold ved hjælp af Power Fx, så du kan inkludere dynamiske værdier og referencevariabler. Vælg knappen Rediger JSON, vælg Formel, og angiv derefter et Power Fx-objekt (alle eksisterende JSON-objekter, der er angivet, konverteres til et Power Fx-objekt for dig), der konverteres til JSON, når HTTP-anmodningen foretages.

      Skærmbillede af JSON-indhold, der er valgt til indholdstype.

    • Råt indhold: Råt indhold giver dig mulighed for at indsætte en streng med data i brødteksten i anmodningen, og denne streng kan være af enhver indholdstype du angiver. Råt indhold angives ved hjælp af en Power Fx-formel, f.eks. det strengindhold, der vises i følgende eksempel.

      Skærmbillede af RAW-indhold, der er valgt til indholdstype.

Håndtering af fejl og timeput

Noden HTTP-anmodning har flere indstillinger til håndtering af de situationer, hvor HTTP-anmodningen kan mislykkes eller returnere en fejl.

Som standard vil funktionen "udløse en fejl". Det betyder, at når en HTTP-anmodning returnerer en fejl eller ikke udføres, standser copiloten sin handling og udløser systememnet Fejl og viser en fejlmeddelelse.

Du kan dog konfigurere fejlhåndteringen, så den ikke udløser systememnet Fejl. I stedet udfyldes HTTP-statuskoden og eventuelle fejlsvars brødtekst i variabler, du angiver, så du kan kontrollere variablerne efter behov og fortsætte med at køre emnet. Denne konfiguration er nyttig i scenarier, hvor copiloten skal fortsætte driften, også selvom en bestemt HTTP-anmodning ikke kan udføres.

Sådan konfigureres funktionsmåden for fejlhåndtering.

  1. Vælg Overskrifter og brødtekst på noden, vælg knappen Rediger, som åbner ruden med egenskaber for HTTP-anmodninger.

  2. Vælg den ønskede funktionsmåde på rullelisten Fejlhåndtering.

  3. Hvis du vælger Fortsæt ved-fejl, skal du konfigurere brødtekstvariablerne Statuskode og Fejlsvar enten ved at oprette nye variabler eller vælge eksisterende variabler fra vælgeren.

    Skærmbillede af fejlhåndtering konfigureret til at fortsætte ved fejl med variabler angivet for statuskode og brødtekst for fejlrespons.

Hvis HTTP-anmodningen mislykkes i dette kodeeksempel, gemmer copilot HTTP-statuskoden i variablen Topic.StatusCode og svarteksten i variablen Topic.ErrorResponse. Copiloten fortsætter derefter til næste trin i emnet.

Variabeltypen Fejlsvar er Enhver. Du kan bruge noden Fortolkningsværdi til at konvertere denne variabel til en Power Fx-post.

Egenskabsruden indeholder også egenskaben Anmod om timeput, der accepterer en værdi i millisekunder. Standardværdien er 30 sekunder, men du kan ændre denne værdi efter behov.