Del via

Send HTTP-forespørsler

  • Artikkel

Viktig!

Power Virtual Agents-funksjoner er nå en del av Microsoft Copilot Studio etter betydelige investeringer i generativ kunstig intelligens og forbedrede integreringer på tvers av Microsoft Copilot.

Enkelte artikler og skjermbilder kan henvise til Power Virtual Agents når vi oppdaterer dokumentasjons- og opplæringsinnhold.

I Copilot Studio kan du utvide egenskapene til en kopilot ved å kalle opp eksterne REST-API-er ved hjelp av noden HTTP-forespørsel. Dette kan være nyttig når du må hente data fra et eksternt system eller endre data på systemet.

Forutsetning

Bruk noden HTTP-forespørsel

  1. Velg Legg til node (+), åpne undermenyen Avansert, og velg deretter Send HTTP-forespørsel.

    Skjermbilde av sende alternativet HTTP-forespørsels på den avanserte menyen.

  2. I boksen URL angir du URL for API-endepunktet du vil kalle opp.

  3. Velg aktuell Metode for forespørsel fra rullegardinlisten. Metodene GET, POST, PATCH, PUT og DELETE støttes.

    Skjermbilde av fullført URL-adresse for API og rullegardinmeny for metode

  4. Uder Overskrifter og brødtekst på noden klikker du Rediger-knappen. Dette åpner ruten for HTTP-forespørselsegenskaper.

  5. Du kan eventuelt legge til ett eller flere overskrifter i HTTP-forespørselen. Klikk Legg til-knappen for å legge til nøkkel og verdi for hver overskrift.

    Skjermbilde av listen over nøkkelverdipar for overskrifter for HTTP-node.

  6. Som standard sendes ikke innhold i brødteksten i HTTP-forespørselen, men du angir innhold som skal sendes på brødteksten.

  7. På noden velger du Svardatatype fra de tilgjengelige alternativene.

    Du kan gi et eksempel på JSON-svar (som du vanligvis finner i dokumentasjonen for API-en du ringer), som genererer en kraftig typesikker Power FX-variabel, slik at du kan bruke den andre steder på redigeringslerretet med intellisense-støtte i Power FX-redigeringsprogrammet. Dette gjør du ved å velge Fra eksempeldata og deretter Hent skjema fra eksempel-JSON, lime inn eksempelsvaret i redigeringsprogrammet som vises, og velge Bekreft.

    Skjermbilde av Hent skjema fra JSON-eksempelredigeringsprogrammet.

  8. Under Lagre svar som velger du hvor du vil at HTTP-forespørselssvaret skal lagres, enten ved å opprette en ny variabel eller velge en eksisterende.

Send innhold i teksten for HTTP-forespørsel

  1. Uder Overskrifter og brødtekst på noden klikker du Rediger-knappen. Dette åpner ruten for HTTP-forespørselsegenskaper.

  2. Under Brødtekst velger du riktig innholdstype. Som standard er dette satt til Uten innhold, der det ikke skal være innhold i forespørselsteksten, som brukes oftest med GET-forespørselen. Hvis du vil legge til innhold i brødteksten, velger du blant ett av de tilgjengelige alternativene.

    Skjermbilde av rullegardinmenyen for alternativer for brødtekst

    • JSON-innhold: JSON-innhold gjør det mulig å angi et JSON-objekt i forespørselsteksten. Dette brukes ofte når du foretar POST- eller PUT-forespørsler. Når du velger dette alternativet, får du et redigeringsprogram der du kan skrive inn JSON-innholdet.

      Du kan også angi JSON-innhold ved hjelp av Power FX, slik at du kan inkludere dynamiske verdier og referansevariabler. Dette gjør du ved å velge Rediger JSON-knappen , velge Formel og deretter angi et Power FX-objekt (alle eksisterende JSON-er som allerede er angitt, blir konvertert til et Power FX-objekt for deg), som konverteres til JSON når HTTP-forespørselen er utført.

      Skjermbilde av JSON-innhold som er valgt for innholdstype.

    • Råinnhold: Råinnhold gjør det mulig å sette inn en datastreng i forespørselsteksten, og denne strengen kan være av en innholdstype du angir. Råinnhold angis ved hjelp av en Power FX-formel, for eksempel strenginnholdet som vises i eksemplet nedenfor.

      Skjermbilde av RAW-innhold som er valgt for innholdstype.

Feilbehandling og tidsavbrudd

HTTP-forespørsel-noden har flere alternativer for håndtering av situasjoner der HTTP-forespørselen kan mislykkes eller returnere en feil.

Funksjonen oppretter en feil som standard. Dette betyr at når en HTTP-forespørsel returnerer en feil eller ikke kan kjøres, stopper kopiloten operasjonen og utløser systememnet Feil, slik at en feilmelding vises.

Du kan imidlertid konfigurere Feil-systememnet og, i stedet, fylle ut HTTP-statuskoden og eventuell meldingstekst for feilsvar i variabler du angir, slik at du kan avhøre disse variablene etter behov slik at emnet skal fortsette å kjøre. Dette er nyttig i scenarioer der du vil at kopiloten skal fortsette å fungere selv om en bestemt HTTP-forespørsel mislykkes.

Konfigurere virkemåten for feilhåndtering.

  1. Uder Overskrifter og brødtekst på noden klikker du Rediger-knappen. Dette åpner ruten for HTTP-forespørselsegenskaper.

  2. Velg ønsket virkemåte fra rullegardinlisten Feilhåndtering.

  3. Hvis du velger Fortsett ved feil, konfigurerer du variablene Statuskode og Feil svartekst, enten ved å opprette nye variabler eller velge eksisterende variabler fra velgeren.

    Skjermbilde av feilhåndtering konfigurert til å fortsette ved feil med variabler angitt for statuskode og feilsvartekst.

Hvis HTTP-forespørselen mislykkes i dette kodeekseplet, lagrer kopiloten HTTP-statuskoden i variabelen Topic.StatusCode og svarteksten i variabelen Topic.ErrorResponse. Kopiloten går deretter videre til de neste trinnene i emnet.

Variabeltypen Feilsvar vil være Alle. Du kan bruke analyseverdinode til å konvertere dette til en Power Fx-oppføring.

Egenskapsruten inneholder også en Request timeout-egenskap, som godtar en verdi i millisekunder. Standardverdien er 30 sekunder, men du kan endre denne verdien om nødvendig.