AgentHumanClarificationConfig

Сохраняемые настройки передачи нерешённого вопроса клиента менеджеру.

enabledEnabled

Может ли агент отложить диалог и обратиться к менеджеру-человеку за помощью.

Default value: false

channel_id object

Чат или канал, куда отправляются уведомления менеджеру об уточнениях.

anyOf

• string
• null

string

message_thread_id object

Необязательная тема или тред внутри менеджерского канала.

anyOf

• string
• null

string

timeout_secondsTimeout Seconds

Как долго уточнение может оставаться в ожидании до истечения.

Possible values: >= 1

Default value: 14400

extra_text object

Необязательный дополнительный статический текст в уведомлении менеджеру.

anyOf

• string
• null

string

follow_up_enabledFollow Up Enabled

Нужно ли отправлять клиенту промежуточное сообщение-ожидание после успешного уведомления менеджера.

Default value: true

follow_up_message_source object

Необязательный источник сообщения-ожидания клиенту. Готовый контент (text, prepared_message_id, waba_template_id, файлы) отправляется как есть; источник только с prompt_id генерирует сообщение этим промптом; без источника сообщение генерируется встроенным промптом.

anyOf

• MessageSource
• null

text object

anyOf

• string
• null

string

prompt_id object

anyOf

• integer
• null

integer

prompt_version_id object

anyOf

• integer
• null

integer

prepared_message_id object

anyOf

• integer
• null

integer

waba_template_id object

anyOf

• integer
• null

integer

file_idsinteger[]

caption object

anyOf

• string
• null

string

timeout_follow_up_message_source object

anyOf

• MessageSource
• null

text object

anyOf

• string
• null

string

prompt_id object

anyOf

• integer
• null

integer

prompt_version_id object

anyOf

• integer
• null

integer

prepared_message_id object

anyOf

• integer
• null

integer

waba_template_id object

anyOf

• integer
• null

integer

file_idsinteger[]

caption object

anyOf

• string
• null

string

lead_field_namesstring[]

Упорядоченные ключи CRM-полей лида, которые нужно сохранять в каждое уточнение.

gate_modeHitlGateMode

Как участвует предварительный классификатор уточнений. В режиме enforce (по умолчанию) отдельный классификатор для каждого сообщения клиента решает, можно ли агенту обратиться к менеджеру, а промпт типа clarification применяется как политика этого классификатора, а не как инструкции в основном промпте. В режиме shadow классификатор работает и его вердикты записываются, но на агента не влияют. В режиме off классификатор не запускается. Автоматические повторные генерации (ресьюмер, пинги) не обращаются к менеджеру ни в одном из режимов.

Possible values: [off, shadow, enforce]

Default value: enforce

gate_arming_labelsHitlGateLabel[]

Вердикты классификатора, при которых агент может обратиться к менеджеру в режиме enforce. По умолчанию — needs_manager_fact и likely_needs_manager_fact; для самой строгой фильтрации оставьте только needs_manager_fact.

Possible values: [needs_manager_fact, likely_needs_manager_fact, answerable_or_clarify, out_of_scope, background_turn, gate_error]

max_clarifications_per_day object

Максимум обращений к менеджеру по одному диалогу за скользящие 24 часа (по умолчанию 3). Сверх лимита агент отвечает по доступным знаниям, не обращаясь к менеджеру. Null — без лимита.

anyOf

• integer
• null

integer

Possible values: >= 1

AgentHumanClarificationConfig

{
  "enabled": false,
  "channel_id": "string",
  "message_thread_id": "string",
  "timeout_seconds": 14400,
  "extra_text": "string",
  "follow_up_enabled": true,
  "follow_up_message_source": {
    "text": "string",
    "prompt_id": 0,
    "prompt_version_id": 0,
    "prepared_message_id": 0,
    "waba_template_id": 0,
    "file_ids": [
      0
    ],
    "caption": "string"
  },
  "timeout_follow_up_message_source": {
    "text": "string",
    "prompt_id": 0,
    "prompt_version_id": 0,
    "prepared_message_id": 0,
    "waba_template_id": 0,
    "file_ids": [
      0
    ],
    "caption": "string"
  },
  "lead_field_names": [
    "string"
  ],
  "gate_mode": "enforce",
  "gate_arming_labels": [
    "needs_manager_fact"
  ],
  "max_clarifications_per_day": 0
}