Acervo

Notas

Decisões reais dos meus sistemas, reescritas para quem chega de fora. Cada nota existe nos dois idiomas.

• Prometa o que a sua operação aguenta

  Minha opinião: a promessa de atendimento humano é feita por default, sem ninguém checar se existe quem a cumpra — e ela custa mais caro do que não prometer nada.

• O que uma sugestão técnica não traz junto

  Toda recomendação de arquitetura embute um trade-off, e o trade-off só se resolve com números do sistema de quem recebe a sugestão — que quem sugere não tem.

• O que uma esteira agêntica cobra para cobrir a ausência

  Sistemas agênticos trocam latência e custo por desempenho na tarefa, e a decisão é sobre quando essa troca compensa; num atendimento sem plantão, o termo de comparação não é o ideal, é o silêncio.

• O que o push garante, e o que fica por conta do humano

  A especificação do Push API resolve o problema técnico de alcançar o dispositivo com o aplicativo fechado; o problema de alguém ver e agir na hora continua inteiro do outro lado.

• O que a delegação a um agente não delega

  A orientação pública para construir sistemas com modelos é começar pela solução mais simples e só aumentar a complexidade quando necessário; quem delega a construção continua dono desse critério.

• O orçamento de nuvem é uma restrição real, não uma desculpa

  Preciso de alternativas que caibam no meu orçamento de recursos cloud, e esse limite é o que me faz perguntar o preço antes de perguntar a arquitetura.

• O formulário preenchido de uma vez só é o caso difícil

  A documentação do Dialogflow CX declara que, quando vários valores chegam num turno só, normalmente um único parâmetro é preenchido — o que explica por que o visitante bem-comportado é justamente o que quebra o fluxo.

• O fluxo de contingência precisa das mesmas garantias do principal

  Seguir coletando dados enquanto ninguém atende é uma decisão defensável de produto, e ela se volta contra o visitante se a coleta repetir o que ele já forneceu.

• O dado estava lá antes da pergunta

  A informação chegou na primeira mensagem do turno e mesmo assim foi pedida de novo — o problema não foi o visitante ter sido confuso.

• O custo que a retenção correta empurra para a fila

  Todo item que um controle retém com razão vira trabalho de revisão, e a lei de Little diz quanto tempo esse trabalho fica parado.

• O botão que eu coloquei depois do primeiro turno

  Na versão mais recente há um botão de falar com atendente, que surge após o primeiro turno e dispara diversas notificações na plataforma, incluindo push.

• O aviso saiu certo e a experiência foi ruim mesmo assim

  O visitante foi avisado de que a conversa continuaria com o atendente quando ele estivesse presente, seguiu no fluxo definido, e a experiência não foi boa porque os dados já haviam sido enviados.

• Sei que é lenta e não sei mais que isso

  Não sei dizer de onde vem a lentidão do chat do acervo: a escolha foi do agente que desenvolveu, e o que eu tenho é a percepção de que é lenta e não parece correta.

• Honestidade sobre a ausência é uma saída, não uma desculpa

  A recomendação de assumir a falha e abrir uma saída vale também quando o limite não é de compreensão, mas de disponibilidade humana — e aí a saída precisa ser um caminho que não dependa de espera.

• Escalavam como quente e eram outra coisa

  As interações da campanha subiam para lead quente pelo comportamento, não pela intenção — e a intenção era procurar emprego.

• Ela avisa, tenta continuar, e não vê o que já veio

  O aviso de que alguém da equipe será acionado sai, a coleta continua para não perder o lead, mas o formulário preenchido na primeira mensagem não é capturado.

• Deleguei a escolha e fiquei com a manutenção

  A arquitetura de recuperação do chat foi decisão do agente que desenvolveu; eu não sei qual foi, e ainda assim é minha para manter e explicar.

• Conselho de fora é hipótese, não diagnóstico

  Esta é uma opinião sobre método: acho que apontamento escrito não decide arquitetura, e que o que decide é dado do próprio sistema.

• Horário de atendimento é necessário e não é suficiente

  Declarar uma janela resolve a expectativa; cumprir a promessa dentro dela exige alguém de plantão, e um levantamento sobre resposta a leads mostra que quase uma em cada cinco empresas não respondia de forma alguma.

• Entre não indexar e indexar, existe o meio-termo textual

  O caminho barato não é escolher entre nada e um pipeline vetorial completo: a busca textual clássica combinada com embeddings é o arranjo recomendado, e a metade textual dela não cobra por consulta.

• Avisei, continuei, e não dei saída nenhuma

  O aviso dizia que a conversa continuaria quando o atendente estivesse presente; o que o visitante recebeu para fazer enquanto isso foi responder perguntas.

• Perguntar de novo é um defeito de estado, não de conversa

  Existe mecanismo declarado para o dado que já está na sessão preencher o formulário sozinho; quando a repergunta acontece, o que falhou foi a propagação do estado, não o entendimento da frase.

• As três medidas que transformam "está lento" em diagnóstico

  Tempo até o primeiro token, tempo total de geração e número de tokens de saída separam um chat lento por espera de um chat lento por escrita.

• As peças de uma KB indexada, uma a uma

  Ingestão, particionamento, geração de embeddings, armazenamento e busca são cinco decisões distintas; tratá-las como um pacote único é o que faz o projeto parecer grande demais para começar.

• Aproximadamente duas horas

  Esse foi o tempo entre o pedido de atendimento e a minha resposta.

• A saída de emergência é parte do desenho, não admissão de derrota

  A recomendação de usabilidade para chatbots inclui oferecer um caminho explícito para um humano; o que ela não resolve é o que acontece quando esse caminho é acionado e não há ninguém do outro lado.

• A revisão humana entra no projeto, não no fim dele

  O framework de gestão de risco em IA do NIST trata confiabilidade como consideração de projeto ao longo de todo o ciclo — o que inclui dimensionar quem revisa o que o sistema retém.

• A preferência não é por humano; é por não ficar preso

  O que a pesquisa de usabilidade registra como bem recebido é o bot assumir a falha e oferecer uma saída — o que desloca a questão de "humano ou IA" para "resolve ou não resolve".

• A operação de uma pessoa só precisa ser desenhada como tal

  Minha opinião: o erro não foi perder as duas conversas, e sim ter desenhado um fluxo que só funciona se eu estiver disponível.

• A linha de base é o que torna "escalar" uma frase com sentido

  Sem medida anterior, escalar não tem critério de sucesso: não há número que diga se a mudança funcionou, e a percepção de melhora é o pior juiz disponível.

• A campanha que rendeu candidatos, não clientes

  A primeira campanha, feita sem dados de SERP e guiada por prompts simples, encheu o chat de interações que escalavam como lead quente e eram gente procurando emprego.

• Proteger o chat sem saber quem pergunta

  Três tetos, um banimento manual e uma única exceção, cercada por escrito: como o chat deste site se protege de abuso sem guardar quem está perguntando.

• Cerque o acervo, não a resposta

  Tudo que entra no corpus de um chat público pode sair pela boca dele. A checagem de confidencialidade que funciona acontece na entrada, documento a documento, e não num filtro correndo atrás de cada resposta.

• Fail-open ou fail-closed: o que existe para proteger?

  Mantenho dois sistemas com defaults de falha opostos, de propósito. A escolha entre travar e seguir não é dogma: é uma pergunta sobre o que a falha custaria em cada direção.

• O redirect por idioma quebra o link compartilhado

  Detectar o idioma do navegador e redirecionar parece cortesia. Na prática, troca a página que alguém escolheu compartilhar, e quem mandou o link nunca fica sabendo.

• Somente leitura por construção

  O jeito mais confiável de garantir que o site nunca escreve no CMS não foi regra nem review: foi um tipo de busca sem lugar para pôr uma escrita.

• Documento por idioma, não campo localizado

  Num site bilíngue, a decisão invisível é onde a tradução mora no CMS. Campo localizado esconde o que falta traduzir; documento por idioma transforma a ausência em fato verificável.