Маршрутизация поддержки

Направляйте сообщения в поддержку в нужный отдел, оценивайте их срочность и передавайте человеку, когда это нужно, с шаблоном «Маршрутизация поддержки».

Цель: каждое входящее сообщение в поддержку попадает в нужную очередь с уровнем срочности, а сообщения, которым нужен человек, — рассерженный клиент, угроза судом, потеря данных, отмена подписки — минуют автоматический ответ.

Создайте решение

Шаблоны → Маршрутизация поддержки → Создать решение:

ЧастьСодержимое
Statemessage (string, обязательное), plan (string)
departmentchoice — billing (счета, списания, возвраты, способы оплаты), technical (баги, ошибки, интеграции, сбои), account (вход, доступ, пользователи, настройки), sales (повышение тарифа, новые тарифы, коммерческие предложения), other — минимальная уверенность 0.6
urgencyscore — low, normal, high, urgent
human_requiredprobability — нужен ли здесь человек вместо автоматического ответа? Да: рассерженный клиент, угроза судом, потеря данных, отмена подписки. Нет: простой вопрос, на который отвечает документация.
Политики1. human_required ≥ 0.7 → escalate
Fallbackescalate — для other и для department с уверенностью ниже 60%

Вызовите его

curl -X POST https://api.dcision.io/v1/decisions/support-routing \
  -H "Authorization: Bearer $DCISION_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ticket-55120" \
  -d '{ "state": { "message": "I was charged twice this month and need a refund today.", "plan": "pro" } }'
200 OK
{
  "decision_id": "dec_Rb6Tn2Wq8Lx4Mk9Pz1Cv",
  "execution_id": "exec_Ys3Fp7Kd1Qw9Bn5Lt2Gh",
  "schema": "support-routing",
  "version": 1,
  "result": { "department": "billing", "urgency": "high", "human_required": 0.82 },
  "confidence": { "department": 0.9375, "urgency": 0.61, "human_required": 0.64 },
  "scores": { "urgency": 3.11 },
  "action": "escalate",
  "action_reason": { "type": "policy", "rule": 0 },
  "metrics": { "latency_ms": 356, "engine": "jev", "model": "jev-1.13.0", "estimated_cost_usd": 0.00001386, "input_tokens": 330, "output_tokens": 33 }
}

human_required равно 0.82 — выше порога 0.7 правила 0, поэтому действие — escalate. Вопрос «как сделать» ("How do I export invoices?") обычно возвращается с низким human_required и continue. Сообщение, которое решение не может отнести к отделу — department с уверенностью ниже 60%, — получает действие fallback, escalate, с action_reason.type = "low_confidence".

Действуйте по результату

import os

import requests


def route_ticket(ticket):
    response = requests.post(
        "https://api.dcision.io/v1/decisions/support-routing",
        headers={
            "Authorization": f"Bearer {os.environ['DCISION_API_KEY']}",
            "Idempotency-Key": f"ticket-{ticket['id']}",
        },
        json={"state": {"message": ticket["message"], "plan": ticket["plan"]}},
        timeout=10,
    )
    if not response.ok:
        return helpdesk.assign(ticket, queue="triage")  # a person decides on errors

    decision = response.json()
    queue = decision["result"]["department"]
    if queue == "other":
        queue = "triage"
    priority = decision["result"]["urgency"]

    if decision["action"] == "escalate":
        return helpdesk.assign(ticket, queue=queue, priority=priority, agent="human")
    return helpdesk.auto_reply(ticket, queue=queue, priority=priority)

Настройте его

  • Повторите свои очереди: переименуйте или добавьте отделы как варианты и опишите границы («возвраты идут в billing, даже при технических сбоях»).

  • Используйте тариф: добавьте context, например "Enterprise customers have a 1-hour SLA", — поле plan уже есть в state.

  • Передавайте срочные тикеты человеку независимо от human_required — по ответу или по взвешенному уровню, чтобы ловить и тикеты, склоняющиеся к срочным:

    { "field": "urgency", "on": "score", "operator": "gte", "value": 3.5, "action": "escalate" }
  • Настройте порог маршрутизации: department поставляется с "minConfidence": 0.6. Повысьте его, чтобы отправлять больше неясных сообщений в действие fallback, понизьте — чтобы автоматизировать больше.

  • Отвечайте на большее в том же вызове: добавьте спекулятивные вопросы, например refund_requested или has_reproducible_steps, — см. Спекулятивный fan-out и его шаблон ticket-triage.

  • Не храните персональные данные в журналах, если они есть в сообщениях: выключите storeInput в настройках решения.

На этой странице