Documentação

Roteamento com gating por confiança

Use a confiança como um segundo eixo. A resposta diz o quê; a confiança diz se você deve agir.

Uma das funcionalidades mais poderosas da TypeSafe é a confiança. Sendo intencional na forma como você aplica gating a decisões com base na confiança, você pode construir sistemas que são ao mesmo tempo confiáveis e seguros.

Exemplo: comandos bancários por voz

Vamos imaginar que você está construindo uma interface bancária por voz para permitir que o usuário interaja com a conta verbalmente. Embora você sempre queira ter uma confiança razoável ao interpretar a intenção do usuário, algumas ações são mais arriscadas do que outras e, portanto, exigem um limiar de confiança mais alto.

%%{init: {"fontFamily": "Inter, sans-serif", "flowchart": {"rankSpacing": 35, "wrappingWidth": 300, "subGraphTitleMargin": {"top": 12, "bottom": 36}}}}%%
flowchart LR
    command["voice banking command"]

    subgraph req["TypeSafe evaluates<br/>the question"]
        intent["<b>Choice:</b> intent"]
    end

    command -- "one request<br/>command + intent<br/>question" --> req
    req -- "one response<br/>intent answer +<br/>confidence" --> gate{"<b>confidence high enough?</b><br/>your code"}
    gate -- "below 0.6<br/>or other intent" --> human["send to a support agent"]
    gate -- "check_balance<br/>at least 0.6" --> balance["show the balance"]
    gate -- "approve_transfer<br/>0.6 to 0.85" --> confirm["ask the user to confirm"]
    gate -- "approve_transfer<br/>above 0.85" --> approve["approve the transfer"]

Passo 1: determine a intenção do usuário

questions
{
  "intent": {
    "type": "choice",
    "instructions": "What action is the user requesting?",
    "criteria": {
      "check_balance": "Check the balance of an account",
      "approve_transfer": "Approve the pending transfer request",
      "other": "Something else"
    }
  }
}

Passo 2: roteamento com gating por confiança

action = response.answers["intent"]

# Below 0.6 confidence on any action, route to a human
if action.confidence < 0.6:
    route_to_support_agent(account_id)

elif action.choice == "check_balance":
    # Low stakes. 0.6 confidence is sufficient.
    show_balance(account_id)

elif action.choice == "approve_transfer":
    if action.confidence > 0.85:
        # High stakes, but high confidence. Safe to act automatically.
        approve_transfer(account_id)
    else:
        # High stakes, moderate confidence. Verify intent first.
        ask_user_to_confirm("Just to confirm: you would like to approve this transfer, is that correct?")

else:
    route_to_support_agent(account_id)

O piso de 0.6 captura qualquer coisa sobre a qual o modelo esteja genuinamente incerto. Acima desse piso, cada tipo de ação tem seu próprio limiar com base nas consequências de agir sobre uma classificação errada. Verificar um saldo com 0.6 é aceitável porque o pior caso é o usuário ter de ouvir a leitura do saldo. Mas aprovar uma transferência exige confiança muito alta (>0.85); caso contrário, o sistema deve pedir que o usuário confirme.

Veja Confiança para mais detalhes sobre como pensar a confiança nos seus sistemas.