Documentação

Encaminhamento com gating por confiança

Usa a confiança como um segundo eixo. A resposta diz-te o quê; a confiança diz-te se deves agir.

Uma das funcionalidades mais poderosas da TypeSafe é a confiança. Ao aplicares o gating das decisões sobre a confiança de forma intencional, podes construir sistemas que são simultaneamente fiáveis e seguros.

Exemplo: comandos bancários por voz

Imagina que estás a construir uma interface bancária por voz para permitir que o utilizador interaja com a sua conta verbalmente. Embora queiras sempre ter uma confiança razoável ao interpretar a intenção do utilizador, algumas ações são mais arriscadas do que outras e por isso exigem um limiar de confiança mais elevado.

%%{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: determina a intenção do utilizador

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: encaminhamento 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 limiar mínimo de 0.6 apanha tudo aquilo sobre que o modelo está genuinamente incerto. Acima desse mínimo, cada tipo de ação tem o seu próprio limiar, com base nas consequências de agir sobre uma classificação errada. Consultar um saldo a 0.6 é aceitável, porque o pior caso é o utilizador ter de ouvir a leitura do saldo. Mas aprovar uma transferência exige uma confiança muito elevada (>0.85); caso contrário, o sistema deve pedir ao utilizador que confirme.

Vê Confiança para mais detalhes sobre como pensar na confiança nos teus sistemas.