Definování a použití úloh moderování (konzola rozhraní API)

Upozornění

Nástroj pro kontrolu Content Moderator je nyní zastaralý a bude vyřazení 12/31/2021.

Úloha moderování slouží jako typ obálky pro funkčnost Moderování obsahu, pracovních postupů a revizí. V této příručce se dozvíte, jak pomocí rozhraní REST API úlohy iniciovat a kontrolovat úlohy Moderování obsahu. Jakmile pochopíte strukturu rozhraní API, můžete tato volání snadno přenést na libovolnou platformu kompatibilní s REST.

Požadavky

Vytvoření úlohy

Úlohu moderování vytvoříte tak, že přejdete na stránku s referenčními pokyny pro úlohu – vytvořit rozhraní API a vyberete tlačítko pro vaši oblast předplatného. Vaši oblast najdete na adrese URL koncového bodu na stránce s přihlašovacími údaji Nástroje pro kontrolu. Spustí se konzola rozhraní API, kde můžete snadno sestavit a spustit REST API volání.

Úloha – vytvoření výběru oblasti stránky

Zadejte parametry volání REST

Zadejte následující hodnoty pro sestavení volání REST:

  • ID týmu: ID týmu, které jste vytvořili při nastavování účtu Nástroje pro kontrolu (najdete ho v poli ID na obrazovce s přihlašovacími údaji nástroje pro kontrolu).
  • ContentType: může to být "image", "text" nebo "video".
  • ID obsahu: vlastní řetězec identifikátoru. Tento řetězec je předán rozhraní API a vrácen prostřednictvím zpětného volání. Je vhodný pro přidružení interních identifikátorů nebo metadat k výsledkům úlohy moderování.
  • Workflow: název pracovního postupu, který jste dříve vytvořili (nebo výchozí) pro výchozí pracovní postup.
  • CallbackEndpoint: (volitelné) adresa URL pro příjem informací o zpětném volání po dokončení revize.
  • OCP-APIM-Subscription-Key: váš Content moderator klíč. tento klíč najdete na kartě Nastavení nástroje pro kontrolu.

Vyplnit text žádosti

Tělo volání REST obsahuje jedno pole ContentValue. Pokud připravujete text nebo pokud jste si přihlásili obrázek nebo video, vložte obsah nezpracovaného textu do nezpracovaného textového obsahu nebo zadejte adresu URL obrázku nebo videa. Můžete použít následující adresu URL ukázkového obrázku: https://moderatorsampleimages.blob.core.windows.net/samples/sample2.jpg

Úloha – vytvoření parametrů dotazu konzoly, záhlaví a textu požadavku na konzolu

Odeslání žádosti

Vyberte Odeslat. Pokud je operace úspěšná, stav odpovědi je 200 OK a v poli obsah odpovědi se zobrazí ID úlohy. Zkopírujte toto ID, které chcete použít v následujících krocích.

Revize – pole vytvořit obsah odpovědi konzoly zobrazí ID revize.

Získat stav úlohy

Chcete-li získat stav a podrobnosti o spuštěné nebo dokončené úloze, klikněte na stránku Reference k rozhraní API pro úlohu a vyberte tlačítko pro vaši oblast (oblast, ve které je klíč spravovaný).

Úloha – získat výběr oblasti

Zadejte parametry volání REST jako v předchozí části. Pro tento krok je identifikátor JobId jedinečným řetězcem ID, který jste dostali při vytváření úlohy. Vyberte Odeslat. Pokud je operace úspěšná, stav odpovědi je 200 OK a pole obsah odpovědi zobrazí úlohu ve formátu JSON, třeba takto:

{  
  "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"
    }
  ]
}

Úloha – získat odpověď volání REST

Prozkoumejte nové revize (y)

Pokud vaše úloha s obsahem skončila vytvořením recenze, můžete ji zobrazit v nástroji pro revize. Vyberte zkontrolovat > / / video textu obrazu (v závislosti na obsahu, který jste použili). Měl by se zobrazit obsah, který je připravený pro lidskou kontrolu. Po revizi lidského moderátora zkontroluje automaticky přiřazené značky a data předpovědi a odešle konečné rozhodnutí o moderování. rozhraní API úlohy odešle všechny tyto informace do určeného koncového bodu zpětného volání.

Další kroky

V této příručce jste zjistili, jak vytvořit a dotazovat úlohy Moderování obsahu pomocí REST API. Dále Integrujte úlohy do kompletního scénáře moderování, jako je například kurz pro moderování elektronického obchodování .