HTTP-aanvragen maken

Belangrijk

Power Virtual Agents-mogelijkheden en -functies maken nu deel uit van Microsoft Copilot Studio na aanzienlijke investeringen in generatieve AI en verbeterde integraties binnen Microsoft Copilot.

Sommige artikelen en schermopnamen verwijzen mogelijk naar Power Virtual Agents terwijl we de documentatie en trainingsinhoud bijwerken.

In Copilot Studio kunt u de mogelijkheden van een copilot uitbreiden door externe REST API's aan te roepen met behulp van het knooppunt HTTP-aanvraag. Dit kan handig zijn als u gegevens van een extern systeem moet ophalen of gegevens op dat systeem moet bewerken.

Vereisten

• Onderwerpen maken en bewerken

Het knooppunt HTTP-aanvraag gebruiken

1. Selecteer Knooppunt toevoegen (+), open het submenu Geavanceerd en selecteer vervolgens HTTP-aanvraag verzenden.

   

2. Voer in het vak URL de URL in van het API eindpunt dat u wilt aanroepen.

3. Selecteer de juiste methode voor de aanvraag in de vervolgkeuzelijst. De methoden GET, POST, PATCH, PUT en DELETE worden ondersteund.

   

4. Klik onder Kopteksten en hoofdtekst op het knooppunt op de knop Bewerken. Hierdoor wordt het deelvenster HTTP-aanvraageigenschappen geopend.

5. U kunt optioneel een of meer kopteksten toevoegen aan de HTTP-aanvraag. Klik op de knop Toevoegen om de sleutel en waarde van elke koptekst toe te voegen.

   

6. Standaard wordt er geen inhoud verzonden in de hoofdtekst van de HTTP-aanvraag, maar u specificeert de inhoud die in de hoofdtekst moet worden verzonden.

7. Kies op het knooppunt het responsgegevenstype uit de beschikbare opties.

   U kunt een voorbeeld van een JSON-respons geven (dat u doorgaans kunt vinden in de documentatie voor de API die u aanroept), waarmee een sterk getypeerde Power FX-variabele wordt gegenereerd, die u elders in uw ontwerpcanvas kunt gebruiken met Intellisense-ondersteuning in de Power FX-editor. Om dit te doen, kiest u Uit voorbeeldgegevens en klikt u vervolgens op Schema ophalen uit voorbeeld-JSON, waarbij u uw voorbeeldrespons in de editor plakt die wordt weergegeven en vervolgens Bevestigen kiest.

   

8. Kies onder Respons opslaan als waar u de respons op de HTTP-aanvraag wilt opslaan, door een nieuwe variabele te maken of een bestaande variabele te selecteren.

Inhoud verzenden in de HTTP-aanvraagbody

1. Klik onder Kopteksten en hoofdtekst op het knooppunt op de knop Bewerken. Hierdoor wordt het deelvenster HTTP-aanvraageigenschappen geopend.

2. Selecteer onder Hoofdtekst het juiste inhoudstype. Standaard is dit ingesteld op Geen inhoud, waarbij er geen inhoud aanwezig mag zijn in de hoofdtekst van de aanvraag, die meestal wordt gebruikt bij de GET-aanvraag. Als u inhoud aan de hoofdtekst wilt toevoegen, selecteert u een van de beschikbare opties.

   

   • JSON-inhoud: met JSON-inhoud kunt u een JSON-object opgeven in de hoofdtekst van de aanvraag. Dit wordt vaak gebruikt bij het doen van POST- of PUT-aanvragen. Wanneer deze optie is geselecteerd, krijgt u een editor te zien waarin u uw JSON-inhoud kunt invoeren.

     U kunt uw JSON-inhoud ook opgeven met Power FX, zodat u dynamische waarden en referentievariabelen kunt opnemen. Om dit te doen, selecteert u de knop JSON bewerken, kiest u Formule en voert u vervolgens een Power FX-object in (eventuele bestaande JSON die is ingevoerd wordt voor u omgezet in een Power FX-object), dat bij het maken van de HTTP-aanvraag wordt omgezet naar JSON.

     

   • Onbewerkte inhoud: met onbewerkte inhoud kunt u een reeks gegevens in de hoofdtekst van de aanvraag invoegen, en deze tekenreeks kan elke inhoudstype zijn die u opgeeft. Onbewerkte inhoud wordt ingevoerd met behulp van een Power FX-formule, zoals de tekenreeksinhoud die in het onderstaande voorbeeld wordt weergegeven.

     

Foutafhandeling en time-out

Het knooppunt HTTP-aanvraag heeft meerdere opties voor het afhandelen van situaties waarin de HTTP-aanvraag mislukt of een fout retourneert.

Standaard zal de functie "Een fout melden". Dit betekent dat wanneer een HTTP-aanvraag een fout retourneert of niet kan worden uitgevoerd, de copilot de bewerking stopt en het systeemonderwerp Fout activeert, waarbij een foutmelding wordt weergegeven.

U kunt de foutafhandeling echter zo configureren dat het systeemonderwerp Fout niet wordt geactiveerd en in plaats daarvan de HTTP-statuscode en eventuele foutresponsen in variabelen vult die u opgeeft. zodat u deze variabelen indien nodig kunt ondervragen en het onderwerp kan blijven worden uitgevoerd. Dit is handig in scenario's waarin u wilt dat de copilot blijft werken, zelfs als een bepaalde HTTP-aanvraag mislukt.

Het foutafhandelingsgedrag configureren.

1. Klik onder Kopteksten en hoofdtekst op het knooppunt op de knop Bewerken. Hierdoor wordt het deelvenster HTTP-aanvraageigenschappen geopend.

2. Kies het gewenste gedrag in de vervolgkeuzelijst Foutafhandeling.

3. Als u Doorgaan bij fout kiest, configureert u de variabelen Statuscode en Tekst van foutreactie, door nieuwe variabelen te maken of bestaande variabelen uit de kiezer te selecteren.

   

Als de HTTP-aanvraag in dit codevoorbeeld mislukt, slaat de copilot de HTTP-statuscode op in de variabele Topic.StatusCode en de antwoordtekst in de variabele Topic.ErrorResponse. De copilot gaat dan verder met de volgende stappen in het onderwerp.

Het variabeletype Foutreactie zal Willekeurig zijn. U kunt gebruikmaken van het parseerwaardeknooppunt om dit om te zetten in een Power Fx-record.

Het eigenschappenvenster bevat ook een eigenschap Time-out voor aanvraag, die een waarde in milliseconden accepteert. De standaardwaarde is 30 seconden, maar u kunt deze waarde indien nodig wijzigen.