Marcar uma exceção

/api/v1/datasets/<project>/<dataset_name>/streams/<stream_name>/exceptions

Permissões necessárias: Consumir fluxos, Exibir origens.

• Bash

  curl -X PUT 'https://<my_api_endpoint>/api/v1/datasets/project1/collateral/streams/dispute/exceptions' \
      -H "Authorization: Bearer $REINFER_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
    "exceptions": [
      {
        "metadata": {
          "type": "No Prediction"
        },
        "uid": "18ba5ce699f8da1f.abcdef0123456789"
      },
      {
        "metadata": {
          "type": "Wrong Prediction"
        },
        "uid": "18ba5ce699f8da1f.0123456789abcdef"
      }
    ]
  }'

• Nó

  const request = require("request");
  
  request.put(
    {
      url: "https://<my_api_endpoint>/api/v1/datasets/project1/collateral/streams/dispute/exceptions",
      headers: {
        Authorization: "Bearer " + process.env.REINFER_TOKEN,
      },
      json: true,
      body: {
        exceptions: [
          {
            metadata: { type: "No Prediction" },
            uid: "18ba5ce699f8da1f.abcdef0123456789",
          },
          {
            metadata: { type: "Wrong Prediction" },
            uid: "18ba5ce699f8da1f.0123456789abcdef",
          },
        ],
      },
    },
    function (error, response, json) {
      // digest response
      console.log(JSON.stringify(json, null, 2));
    }
  );

• Python

  import json
  import os
  
  import requests
  
  response = requests.put(
      "https://<my_api_endpoint>/api/v1/datasets/project1/collateral/streams/dispute/exceptions",
      headers={"Authorization": "Bearer " + os.environ["REINFER_TOKEN"]},
      json={
          "exceptions": [
              {
                  "uid": "18ba5ce699f8da1f.abcdef0123456789",
                  "metadata": {"type": "No Prediction"},
              },
              {
                  "uid": "18ba5ce699f8da1f.0123456789abcdef",
                  "metadata": {"type": "Wrong Prediction"},
              },
          ]
      },
  )
  
  print(json.dumps(response.json(), indent=2, sort_keys=True))

• Resposta

  {
    "status": "ok"
  }

Esse ponto de extremidade permite que você marque comentários como exceções na plataforma, para que um treinador de modelos possa revisá-los e rotulá-los, a fim de melhorar o modelo. Recomendamos marcar os comentários para os quais o modelo não retornou previsões e comentários para os quais o modelo retornou previsões erradas. (Para ajuda com o projeto do fluxo de tratamento de exceções, consulte o Guia de Integração).

Nome	Tipo	Required	Descrição
exceptions	array<Exception>	sim	Uma lista de exceções.

Onde Exception tem o seguinte formato:

Nome	Tipo	Required	Descrição
uid	String	sim	O uid do comentário que deve ser marcado como exceção.
metadata	Metadata	sim	Um objeto que contém metadados de exceção.

Onde Metadata tem o seguinte formato:

Nome	Tipo	Required	Descrição
type	String	sim	O tipo de exceção estará disponível como uma propriedade de filtro na IU do Communications Mining. O valor pode ser uma string arbitrária. Escolha uma string curta e fácil de entender, como "Sem previsão" e "Previsão errada".