Definiera och använda modereringsjobb (API-konsol)

Varning

Granskningsverktyget Content Moderator är nu inaktuellt och dras tillbaka den 31 maj 2021.

Ett modereringsjobb fungerar som en typ av omser för funktionerna för innehållsmoderering, arbetsflöden och granskningar. Den här guiden visar hur du använder jobbets REST-API:er för att initiera och kontrollera innehållsmodereringsjobb. När du förstår strukturen för API:erna kan du enkelt porta anropen till valfri REST-kompatibel plattform.

Förutsättningar

Skapa ett jobb

Om du vill skapa ett modereringsjobb går du till sidan Jobb – Skapa API-referens och väljer knappen för din prenumerationsregion. Du hittar din region i slutpunkts-URL:en på sidan Autentiseringsuppgifter i granskningsverktyget. Detta startar API-konsolen, där du enkelt kan skapa och köra REST API anrop.

Jobb – Skapa val av sidregion

Ange parametrar för REST-anrop

Ange följande värden för att skapa REST-anropet:

  • teamName: Det team-ID som du skapade när du konfigurerade ditt granskningsverktygskonto (finns i fältet Id på skärmen Autentiseringsuppgifter för granskningsverktyget).
  • ContentType: Detta kan vara "Image", "Text" eller "Video".
  • ContentId: En anpassad identifierarsträng. Den här strängen skickas till API:et och returneras via återanropet. Det är användbart för att associera interna identifierare eller metadata med resultatet av ett modereringsjobb.
  • Arbetsflödesnamn: Namnet på arbetsflödet som du skapade tidigare (eller "standard" för standardarbetsflödet).
  • CallbackEndpoint:(Valfritt) Den URL som ska ta emot återanropsinformation när granskningen har slutförts.
  • Ocp-Apim-Subscription-Key: Din Content Moderator nyckel. Du hittar den här nyckeln på Inställningar i granskningsverktyget.

Fyll i begärandetexten

Brödtexten i REST-anropet innehåller ett fält, ContentValue. Klistra in innehållet i rådatatexten om du modererar text eller ange en bild- eller video-URL om du modererar en bild eller video. Du kan använda följande exempel på bild-URL: https://moderatorsampleimages.blob.core.windows.net/samples/sample2.jpg

Jobb – Skapa konsolfrågeparametrar, rubriker och rutan Begärandetext

Skicka din begäran

Välj Skicka. Om åtgärden lyckas är svarsstatusen 200 OK , och rutan Svarsinnehåll visar ett ID för jobbet. Kopiera det här ID:t för användning i följande steg.

Granska – rutan Skapa konsolsvarsinnehåll visar gransknings-ID

Hämta jobbstatus

Om du vill hämta status och information om ett jobb som körs eller har slutförts går du till sidan Jobb Hämta API-referens och väljer knappen för din region (den region där nyckeln administreras).

Jobb – Hämta val av region

Ange parametrarna för REST-anropet som i avsnittet ovan. I det här steget är JobId den unika ID-sträng som du fick när du skapade jobbet. Välj Skicka. Om åtgärden lyckas är svarsstatusen , och rutan Svarsinnehåll visar 200 OK jobbet i JSON-format, som följande:

{  
  "Id":"2018014caceddebfe9446fab29056fd8d31ffe",
  "TeamName":"some team name",
  "Status":"Complete",
  "WorkflowId":"OCR",
  "Type":"Image",
  "CallBackEndpoint":"",
  "ReviewId":"201801i28fc0f7cbf424447846e509af853ea54",
  "ResultMetaData":[  
    {  
      "Key":"hasText",
      "Value":"True"
    },
    {  
      "Key":"ocrText",
      "Value":"IF WE DID \r\nALL \r\nTHE THINGS \r\nWE ARE \r\nCAPABLE \r\nOF DOING, \r\nWE WOULD \r\nLITERALLY \r\nASTOUND \r\nOURSELVE \r\n"
    }
  ],
  "JobExecutionReport":[  
    {  
      "Ts":"2018-01-07T00:38:29.3238715",
      "Msg":"Posted results to the Callbackendpoint: https://requestb.in/vxke1mvx"
    },
    {  
      "Ts":"2018-01-07T00:38:29.2928416",
      "Msg":"Job marked completed and job content has been removed"
    },
    {  
      "Ts":"2018-01-07T00:38:29.0856472",
      "Msg":"Execution Complete"
    },
    {  
      "Ts":"2018-01-07T00:38:26.7714671",
      "Msg":"Successfully got hasText response from Moderator"
    },
    {  
      "Ts":"2018-01-07T00:38:26.4181346",
      "Msg":"Getting hasText from Moderator"
    },
    {  
      "Ts":"2018-01-07T00:38:25.5122828",
      "Msg":"Starting Execution - Try 1"
    }
  ]
}

Jobb – Få svar från REST-anrop

Granska de nya granskningarna

Om innehållsjobbet resulterade i att en granskning skapades kan du visa den i granskningsverktyget. Välj Granska > / bildtextvideo / (beroende på vilket innehåll du använde). Innehållet bör visas, redo för mänsklig granskning. När en mänsklig moderator granskar de automatiskt tilldelade taggarna och förutsägelsedata och skickar ett slutligt modereringsbeslut skickar jobb-API:et all den här informationen till den avsedda återanropsslutpunkten.

Nästa steg

I den här guiden har du lärt dig hur du skapar och frågar innehållsmodereringsjobb med hjälp av REST API. Sedan integrerar du jobb i ett modereringsscenario från hela ända, till exempel självstudien om moderering av e-handel.