Defina e use trabalhos de moderação (REST)Define and use moderation jobs (REST)

Um trabalho de moderação serve como uma espécie de invólucro para a funcionalidade de moderação de conteúdos, fluxos de trabalho e revisões.A moderation job serves as a kind of wrapper for the functionality of content moderation, workflows and reviews. Este guia mostra-lhe como usar o trabalho REST APIs para iniciar e verificar os trabalhos de moderação de conteúdos.This guide shows you how to use the job REST APIs to initiate and check content moderation jobs. Assim que compreender a estrutura das APIs, pode facilmente fazer com que estas chamadas possam fazer qualquer plataforma compatível com REST.Once you understand the structure of the APIs, you can easily port these calls to any REST-compatible platform.

Pré-requisitosPrerequisites

Criar uma tarefaCreate a job

Para criar um trabalho de moderação, vá à página de referência Job - Create API e selecione o botão para a sua região de subscrição (pode encontrá-lo no URL endpoint na página de Credenciais da ferramenta 'Revisão').To create a moderation job, go to the Job - Create API reference page and select the button for your subscription region (you can find this in the Endpoint URL on the Credentials page of the Review tool). Isto inicia a consola API, onde podes facilmente construir e executar chamadas REST API.This starts the API console, where you can easily construct and run REST API calls.

Job - Criar a seleção da região de página

Insira os parâmetros de chamada RESTEnter REST call parameters

Introduza os seguintes valores para construir a chamada REST:Enter the following values to construct the REST call:

  • nome de equipa: O ID da equipa que criou quando configura a sua conta de ferramentas 'Rever' (encontrada no campo Id no ecrã de Credenciais da ferramenta De revisão).teamName: The team ID that you created when you set up your Review tool account (found in the Id field on your Review tool's Credentials screen).
  • ConteúdoType: Isto pode ser "Imagem", "Texto" ou "Vídeo".ContentType: This can be "Image", "Text", or "Video".
  • ContentId: Uma cadeia de identificador personalizado.ContentId: A custom identifier string. Esta corda é passada para a API e devolvida através da chamada.This string is passed to the API and returned through the callback. É útil para associar identificadores internos ou metadados com os resultados de um trabalho de moderação.It is useful for associating internal identifiers or metadata with the results of a moderation job.
  • Nomede fluxo de trabalho : O nome do fluxo de trabalho que criou anteriormente (ou "padrão" para o fluxo de trabalho predefinido).Workflowname: The name of the workflow you previously created (or "default" for the default workflow).
  • CallbackEndpoint: (Opcional) O URL para receber informações de chamada quando a revisão estiver concluída.CallbackEndpoint: (Optional) The URL to receive callback information when the review is completed.
  • Chave de subscrição Ocp-Apim: A sua tecla moderadora de conteúdo.Ocp-Apim-Subscription-Key: Your Content Moderator key. Pode encontrá-lo no separador Definições da ferramenta Rever.You can find this on the Settings tab of the Review tool.

Preencha o órgão de pedidoFill in the request body

O corpo da sua chamada REST contém um campo, ContentValue.The body of your REST call contains one field, ContentValue. Colhe no conteúdo de texto bruto se estiver a moderar texto, ou introduza um URL de imagem ou vídeo se estiver a moderar a imagem/vídeo.Paste in the raw text content if you are moderating text, or enter an image or video URL if you're moderating image/video. Pode utilizar o seguinte URL de imagem da amostra:https://moderatorsampleimages.blob.core.windows.net/samples/sample2.jpgYou can use the following sample image URL: https://moderatorsampleimages.blob.core.windows.net/samples/sample2.jpg

Job - Criar parâmetros de consulta de consola, cabeçalhos e caixa corporal de pedido

Submeta o seu pedidoSubmit your request

Selecione Enviar.Select Send. Se a operação for bem 200 OKsucedida, o estado de Resposta é , e a caixa de conteúdo resposta apresenta um ID para o trabalho.If the operation succeeds, the Response status is 200 OK, and the Response content box displays an ID for the job. Copie este ID para utilizar nos seguintes passos.Copy this ID to use in the following steps.

Review - Create console Response content box displays the review ID

Obter o estatuto de empregoGet job status

Para obter o estado e os detalhes de um trabalho em execução ou concluído, vá à página de referência De Trabalho - Obtenha API e selecione o botão para a sua região (a região em que a sua chave é administrada).To get the status and details of a running or completed job, go to the Job - Get API reference page and select the button for your region (the region in which your key is administered).

Job - Obtenha a seleção da região

Introduza os parâmetros de chamada REST como na secção acima.Enter the REST call parameters as in the above section. Para este passo, jobId é a cadeia de identificação única que recebeu quando criou o trabalho.For this step, JobId is the unique ID string you received when you created the job. Selecione Enviar.Select Send. Se a operação for bem 200 OKsucedida, o estado de Resposta é , e a caixa de conteúdo resposta apresenta o trabalho em formato JSON, como o seguinte:If the operation succeeds, the Response status is 200 OK, and the Response content box displays the job in JSON format, like the following:

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

Job - Obter resposta de chamada REST

Examinar a nova revisão(s)Examine the new review(s)

Se o seu trabalho de conteúdo resultou na criação de uma revisão, pode vê-lo na ferramenta Review.If your content job resulted in the creation of a review, you can view it in the Review tool. Selecione Revê > o Vídeo de Texto/deImagem/(dependendo do conteúdo utilizado).Select Review > Image/Text/Video (depending on what content you used). O conteúdo deve aparecer, pronto para revisão humana.The content should appear, ready for human review. Depois de um moderador humano rever as etiquetas e dados de previsão atribuídos automaticamente e apresentar uma decisão final de moderação, os postos de trabalho a API submete todas estas informações ao ponto final designado.After a human moderator reviews the auto-assigned tags and prediction data and submits a final moderation decision, the jobs API submits all of this information to the designated callback endpoint endpoint.

Passos seguintesNext steps

Neste guia, aprendeu a criar e consultar trabalhos de moderação de conteúdos utilizando a API REST.In this guide, you learned how to create and query content moderation jobs using the REST API. Em seguida, integrar os empregos num cenário de moderação de ponta a ponta, como o tutorial de moderação do comércio eletrónico.Next, integrate jobs into an end-to-end moderation scenario, such as the E-commerce moderation tutorial.