Перейти к основному содержимому

API

Раздел описывает методы взаимодействия с ML-модулем платформы.

POST https://api.dev.intelligent-engineer.ru/ml/predict/full​

Метод используется для получения:

  • предсказанной причины неисправности
  • списка рекомендованных работ

на основе текста клиентского обращения и дополнительных параметров.

Request​

Endpoint: POST https://api.dev.intelligent-engineer.ru/ml/predict/full

Body:

{
  "shortProblem": "string",
  "symptomCategories": ["string"],
  "systemNodeId": "string | null",
  "manifestationConditions": ["string"],
  "errorCodes": ["string"],
  "urgency": "string | null",
  "requestType": "string | null",
  "mileageOrHours": 0,
  "isWarranty": true,
  "equipmentBrand": "string | null",
  "equipmentModel": "string | null"
}

Параметры:​

  • shortProblem — краткое описание проблемы
  • symptomCategories — категории симптомов
  • systemNodeId — узел системы
  • manifestationConditions — условия проявления
  • errorCodes — коды ошибок
  • urgency — срочность
  • requestType — тип обращения
  • mileageOrHours — пробег или наработка
  • isWarranty — гарантийный случай
  • equipmentBrand — бренд техники
  • equipmentModel — модель техники

Response

{
  "model_input_text": "string",
  "failure_reason": {
    "label": "string | null",
    "score": 0.0
  },
  "recommended_work_labels": [
    {
      "label": "string",
      "score": 0.0
    }
  ]
}

Поля ответа:​

  • model_input_text — текст, сформированный для модели
  • failure_reason — предсказанная причина неисправности
    • label — название причины
    • score — уровень уверенности
  • recommended_work_labels — список рекомендованных работ
    • label — наименование работы
    • score — вероятность релевантности

Пример использования​

curl -X POST https://api.dev.intelligent-engineer.ru/ml/predict/full \
  -H "Content-Type: application/json" \
  -d '{
    "shortProblem": "Двигатель потерял мощность, появился черный дым",
    "symptomCategories": ["потеря мощности"],
    "systemNodeId": "engine",
    "manifestationConditions": ["под нагрузкой"],
    "errorCodes": [],
    "urgency": "high",
    "requestType": "breakdown",
    "mileageOrHours": 7800,
    "isWarranty": false,
    "equipmentBrand": "John Deere",
    "equipmentModel": "8320R"
  }'

Метод используется в платформе для автоматической обработки клиентских обращений и формирования рекомендаций при создании заявок.