Del via

Foretag HTTP-forespørgsler

  • Artikel

I Copilot Studio kan du udvide agentens 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.

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

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 timeout

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

Som standard udløser funktionen en fejl. Det betyder, at når en HTTP-anmodning returnerer en fejl eller ikke udføres, stopper agenten driften og udløser systememnet Ved fejl og viser en fejlmeddelelse.

Du kan dog konfigurere fejlhåndteringen, så den ikke udløser systememnet Ved 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 agenten skal fortsætte driften, selvom en bestemt HTTP-anmodning mislykkes.

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 agenten HTTP-statuskoden i variablen Topic.StatusCode og svarteksten i variablen Topic.ErrorResponse. Agenten fortsætter til sine 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.