Quando um modelo fica indisponível, a interface precisa explicar
Estados explícitos de disponibilidade evitam que falhas de provedor pareçam erro do usuário ou do prompt.
Falha sem contexto é falha de UX
Se o envio falha porque a rota escolhida está temporariamente indisponível, a pessoa precisa saber que o problema não está no conteúdo enviado. Esconder esse estado gera tentativas repetidas e diagnóstico errado.
Informação mínima útil
- Qual modelo ou rota está afetado.
- Se o problema é temporário ou exige outra ação.
- Qual alternativa está disponível sem perder o trabalho atual.
Fallback não deve ser invisível
Trocar de rota pode ser útil, mas a interface deve manter a pessoa informada. Confiabilidade inclui saber qual sistema realmente executou a tarefa.
Onde Fallback precisa mudar de caminho de verdade realmente ganha qualidade
Quando um modelo fica indisponível, o fallback deve usar outro provedor, outra rota ou outra estratégia. Tentar o mesmo endpoint com outro rótulo produz uma ilusão de resiliência e geralmente repete a falha original.
- causa raiz vem antes do fallback
- mudança não quebra subsistemas fora do escopo
- logs e códigos permitem reproduzir a falha
Falha específica: Fallback precisa mudar de caminho de verdade
O risco é vazar mensagem crua do provedor, como crédito esgotado, e apresentá-la ao usuário como se fosse limite da própria conta Giorgio.
Evidência que fecha Fallback precisa mudar de caminho de verdade
O comportamento correto diferencia limite do usuário, limite do provedor, indisponibilidade transitória e falha permanente; registra a troca e preserva a identidade pública do modelo selecionado.
Falha que esse desenho evita como gate
Em “Quando um modelo fica indisponível, a interface precisa explicar”, o ponto técnico que fecha a análise é tratar ownership, recuperação e observabilidade como parte do mesmo contrato. A implementação deixa de ser convincente quando uma dessas dimensões existe só no texto, mas não aparece no comportamento verificável do produto.
- definir o estado esperado antes da ação
- observar o efeito real e registrar a evidência
- se o gate falhar, reparar a causa antes de ampliar o escopo
