HumanClarificationRead

Уточнение с участием человека (human-in-the-loop): когда бот не уверен в середине диалога, он может задать вопрос оператору-человеку и дождаться ответа, прежде чем ответить лиду. Эта запись хранит вопрос, ответ оператора и то, как был получен ответ.

idIdrequired

Уникальный числовой идентификатор записи.

clarification_idClarification Idrequired

Внешний/строковый идентификатор запроса на уточнение.

dialogue_idDialogue Idrequired

Идентификатор диалога, к которому относится запись.

agent_idAgent Idrequired

Идентификатор агента (настроенного ИИ-ассистента/бота), которому принадлежит запись.

product_idProduct Idrequired

Идентификатор продукта (рабочего пространства), которому принадлежит запись. Большинство эндпоинтов разграничивают доступ по продукту.

statusStatusrequired

Статус жизненного цикла уточнения.

user_message objectrequired

Сообщение лида, вызвавшее уточнение.

anyOf

• string
• null

string

user_message_id objectrequired

Идентификатор этого сообщения лида.

anyOf

• integer
• null

integer

question_textQuestion Textrequired

Вопрос, заданный оператору-человеку.

dialogue_history objectrequired

Снимок истории диалога, переданный как контекст.

anyOf

• string
• null

string

lead_field_snapshot object[]required

Упорядоченный снимок выбранных полей лида, сохранённый при открытии уточнения.

Array [

nameNamerequired

Ключ CRM-поля лида, показываемый менеджеру.

value objectrequired

Сырое значение из lead.crm_fields, сохранённое в момент создания уточнения.

anyOf

• string
• integer
• number
• boolean
• string[]
• object

string

]

manager_response objectrequired

Ответ оператора.

anyOf

• string
• null

string

answer_sourceHumanClarificationAnswerSourcerequired

Откуда взят ответ — от менеджера или восстановлен из предыдущего уточнения.

Possible values: [manager, hitl_recall]

answer_source_clarification_idsstring[]required

Идентификаторы прежних уточнений, из которых взят восстановленный ответ.

answer_source_reason objectrequired

Почему выбран этот источник ответа.

anyOf

• string
• null

string

response_message_id objectrequired

Идентификатор сообщения бота, которым ответ доставлен лиду.

anyOf

• integer
• null

integer

response_text objectrequired

Текст, в итоге отправленный лиду.

anyOf

• string
• null

string

reformulated_question objectrequired

Переформулированная версия вопроса, если она была получена.

anyOf

• string
• null

string

rag_entry objectrequired

Запись базы знаний, созданная из этого уточнения, если есть.

anyOf

• string
• null

string

rag_statusRag Statusrequired

Статус превращения этого уточнения в запись базы знаний.

rag_error objectrequired

Детали ошибки шага создания записи базы знаний, если есть.

anyOf

• string
• null

string

error objectrequired

Общие детали ошибки, если есть.

anyOf

• string
• null

string

created_atdate-timerequired

Время создания (UTC, ISO 8601).

completed_at objectrequired

Когда уточнение было завершено (UTC).

anyOf

• date-time
• null

date-time

HumanClarificationRead

{
  "id": 0,
  "clarification_id": "string",
  "dialogue_id": 0,
  "agent_id": 0,
  "product_id": 0,
  "status": "string",
  "user_message": "string",
  "user_message_id": 0,
  "question_text": "string",
  "dialogue_history": "string",
  "lead_field_snapshot": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "manager_response": "string",
  "answer_source": "manager",
  "answer_source_clarification_ids": [
    "string"
  ],
  "answer_source_reason": "string",
  "response_message_id": 0,
  "response_text": "string",
  "reformulated_question": "string",
  "rag_entry": "string",
  "rag_status": "string",
  "rag_error": "string",
  "error": "string",
  "created_at": "2024-07-29T15:51:28.071Z",
  "completed_at": "2024-07-29T15:51:28.071Z"
}