Агрегировать ответы на одно задание

POST /aggregated-solutions/aggregate-by-task

Запускает агрегацию ответов на одно задание.

Примеры запросов

curl -X POST 'https://tasks.yandex.ru/api/v1/aggregated-solutions/aggregate-by-task' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -H 'Content-Type: application/json' \
     -d '{"pool_id":"1238218","task_id":"000012e4ca--62e97a75dbab805456309d81", "type":"WEIGHTED_DYNAMIC_OVERLAP", "answer_weight_skill_id":"12648", "fields":[{"name":"result"}]}'
import requests

url = "https://tasks.yandex.ru/api/v1/aggregated-solutions/aggregate-by-task"
headers = {
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
  'Content-Type': 'application/json'
}
payload = {
  "pool_id": "1238218",
  "task_id": "000012e4ca--62e97a75dbab805456309d81",
  "type": "WEIGHTED_DYNAMIC_OVERLAP",
  "answer_weight_skill_id": "12648",
  "fields": [
    {
      "name": "result"
    }
  ]
}
response = requests.post(url, headers=headers, json=payload)

print(response.text)
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://tasks.yandex.ru/api/v1/aggregated-solutions/aggregate-by-task',
  'qs': {},
  'headers': {
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here',
    'Content-Type': 'application/json'
  },
  'body': JSON.stringify({
    "pool_id": "1238218",
    "task_id": "000012e4ca--62e97a75dbab805456309d81",
    "type": "WEIGHTED_DYNAMIC_OVERLAP",
    "answer_weight_skill_id": "12648",
    "fields": [
      {
        "name": "result"
      }
    ]
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Заголовки

Заголовок

Описание

Authorization

API-токен для авторизации аккаунта. В качестве префикса добавьте OAuth.

Content-Type

Указывает формат данных (application/json) в передаваемом теле запроса.

Тело и параметры запроса

{
  "type": "DAWID_SKENE",
  "pool_id": 1491600,
  "task_id": "000016c290--64382dfc97aa9547ff8a2299",
  "fields": [
    {
      "name": "result"
    }
  ]
}
{
  "type": "WEIGHTED_DYNAMIC_OVERLAP",
  "pool_id": "1238218",
  "task_id": "000012e4ca--62e97a75dbab805456309d81",
  "fields": [
    {
      "name": "result"
    }
  ],
  "answer_weight_skill_id": "12648"
}

Параметр

Описание

type*

string

Тип агрегации.

  • WEIGHTED_DYNAMIC_OVERLAP — агрегация ответов в пуле с динамическим перекрытием (incremental relabeling, IRL).
  • DAWID_SKENE — агрегация ответов в пуле без динамического перекрытия. Ключ answer_weight_skill_id для этого типа агрегации игнорируется.

pool_id*

string

Идентификатор пула.

task_id

string

Идентификатор задания.

fields*

object

Поля выходных данных, ответы на которые будут агрегированы. Для получения наилучших результатов каждое из этих полей должно иметь ограниченное количество вариантов ответа.

fields.name*

string

Имя поля выходных данных.

answer_weight_skill_id

string (обязательный при условии)

Обязателен, если выбран тип агрегации WEIGHTED_DYNAMIC_OVERLAP.

Навык, который определяет вес ответа исполнителя.

Ответ

Содержит агрегированный ответ на задание.

Пример ответа
{
  "confidence": 0.937152,
  "output_values": {
    "result": "OK"
  },
  "pool_id": "283",
  "task_id": "afd1234d-12314a-cfd1424d-31214b"
}

Параметр

Описание

confidence

integer

Уверенность в агрегированном ответе.

output_values

object

Поля выходных данных и агрегированный ответ.

pool_id

string

Идентификатор пула.

task_id

string

Идентификатор задания.

Обязательный параметр