Send HTTP-forespørsler
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
Velg Legg til node (+), åpne undermenyen Avansert, og velg deretter Send HTTP-forespørsel.
I boksen URL angir du URL for API-endepunktet du vil kalle opp.
Velg aktuell Metode for forespørsel fra rullegardinlisten. Metodene GET, POST, PATCH, PUT og DELETE støttes.
Uder Overskrifter og brødtekst på noden klikker du Rediger-knappen. Dette åpner ruten for HTTP-forespørselsegenskaper.
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.
Som standard sendes ikke innhold i brødteksten i HTTP-forespørselen, men du angir innhold som skal sendes på brødteksten.
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.
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
Uder Overskrifter og brødtekst på noden klikker du Rediger-knappen. Dette åpner ruten for HTTP-forespørselsegenskaper.
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.
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.
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.
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.
Uder Overskrifter og brødtekst på noden klikker du Rediger-knappen. Dette åpner ruten for HTTP-forespørselsegenskaper.
Velg ønsket virkemåte fra rullegardinlisten Feilhåndtering.
Hvis du velger Fortsett ved feil, konfigurerer du variablene Statuskode og Feil svartekst, enten ved å opprette nye variabler eller velge eksisterende variabler fra velgeren.
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.
Tilbakemeldinger
https://aka.ms/ContentUserFeedback.
Kommer snart: Gjennom 2024 faser vi ut GitHub Issues som tilbakemeldingsmekanisme for innhold, og erstatter det med et nytt system for tilbakemeldinger. Hvis du vil ha mer informasjon, kan du se:Send inn og vis tilbakemelding for