Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Obs
Det här avsnittet är en del av en självstudieserie om hur du skapar och använder anpassade anslutningsappar för Microsoft Copilot Studio Azure Logic Apps, Microsoft Power Automate, och Microsoft Power Apps. Se till att du läser översikten över anpassade anslutningsprogram för att förstå processen.
Postman är en app för att göra HTTP-begäranden, och Postman-samlingar hjälper dig att organisera och gruppera relaterade API-begäranden. Samlingar kan skynda på och förenkla utvecklingen av anpassade anslutningsprogram om du inte redan har en OpenAPI-definition för ditt API.
I den här artikeln skapar du en samling som innehåller en förfrågan och ett svar från Azure Cognitive Services textanalys-API. I ett relaterat avsnitt skapar du en anslutningsapp med hjälp av den här samlingen.
Förutsättningar
- Postman-appen
- En API-nyckel för API:et för textanalys i Cognitive Services
Skapa en HTTP-begäran för API:et
I Postman går du till fliken Builder och väljer HTTP-metoden, anger begärande-URL:en för API-slutpunkten och väljer ett auktoriseringsprotokoll, om det finns något.
Parameter Värde HTTP-metod POST Begäran-URL https://westus.api.cognitive.microsoft.com/text/analytics/v2.0/sentiment
Auktorisering No Auth (du anger ett API-nyckel i nästa steg) Ange nyckel/värde-par för begäranshuvudet. För vanliga HHTP-huvuden kan du välja från listrutan.
Key Värde Ocp-Apim-Subscription-Key Your-API-subscription-key, som du hittar i ditt Cognitive Services-konto Content-Type application/json Ange innehåll som du vill skicka i begäranstexten. Om du vill kontrollera att begäran fungerar genom att få tillbaka ett svar väljer du Skicka.
{ "documents": [{ "language": "en-us", "id": "1", "text": "I enjoyed the new movie after a long day." }] }
Svarsfältet innehåller det fullständiga svaret från API: et, inklusive resultatet eller ett fel om något sådant uppstod.
Spara samlingen
Välj Spara.
I dialogrutan Spara begäran anger du ett namn och en beskrivning för begäran. Den anpassade anslutningsappen använder dessa värden för API-åtgärdens sammanfattning och beskrivning.
Parameter Värde Namn på begäran DetectSentiment Beskrivning av begäran API:n returnerar en numerisk poäng mellan 0 och 1. Poäng nära 1 visar en positiv attityd, medan en poäng nära 0 indikerar en negativ attityd. Välj + Skapa samling och ange namnet för samlingen. Den anpassade anslutningsappen använder det här värdet när du anropar API:et. Markera bockmarkeringen (✓), som skapar en samlingsmapp, och välj sedan Spara i SentimentDemo.
Parameter Värde Samlingsnamn SentimentDemo
Spara svaret
Nu när du har sparat begäran kan du spara svaret. På så sätt visas svaret som ett exempel när du läser in begäran senare.
Ovanför svarsfönstret väljer du Spara svar.
Anpassade anslutningsappar kan endast hantera ett svar per begäran. Om du sparar flera svar per förfrågan så används bara det första.
Längst upp i appen anger du ett namn för ditt exempelsvar och väljer sedan Spara exempel.
Om API:et har fler funktioner skulle du fortsätta att bygga din Postman-samling med eventuella ytterligare begäranden och svar.
Exportera Postman-samlingen
Nu kan du exportera samlingen som en JSON-fil som du sedan importerar med hjälp av guiden för anpassade kopplingar. Innan du exporterar samlingen tar du bort innehållstypen och säkerhetsrubrikerna – dessa krävdes för att göra API-begäranden, men de hanteras på olika sätt i det anpassade anslutningsprogrammet.
På fliken Rubriker håller du muspekaren över varje rubrik och väljer X bredvid rubriken för att ta bort den. Välj Spara för att spara samlingen igen.
Välj ellipsen (...) bredvid samlingen och välj sedan Exportera.
Välj exportformatet Samling v1 , välj Exportera och bläddra sedan till den plats där du vill spara JSON-filen.
Obs
För närvarande kan du endast använda Collection v1 för anpassade kopplingar.
Nästa steg
Du är nu redo att definiera en anpassad koppling som bygger på den Postman-samling som du skapade:
Ge feedback
Vi uppskattar feedback på problem med vår anslutningsplattform eller nya funktioner. Om du vill ge feedback går du till Skicka problem eller får hjälp med anslutningsprogram och väljer din feedbacktyp.