Entender as mensagens de erro do chat de IA e o que o agente guarda sobre você

Quando o agente de IA do chat não consegue responder, o Kryia One mostra uma mensagem em linguagem simples. Ele não mostra o texto técnico do banco de dados (nome de tabela, de coluna ou trecho de SQL): esse texto não ajuda a resolver o problema e expõe detalhes internos. O detalhe completo fica só no log de suporte.

Para o uso geral do assistente, veja receber avisos e perguntar ao assistente.

Quando a resposta falha de vez

Se o agente falha de forma inesperada, o servidor responde com a frase fixa:

Falha ao processar com o agente.

A frase é a mesma, seja qual for a causa. Ela vai como evento de erro quando a resposta chega aos poucos (streaming) e como erro 500 quando chega de uma vez. O texto original da falha não é enviado à tela.

Em alguns casos a conexão pode acabar sem que o agente devolva os dados finais. Nesse caso, o programa do chat lança a mensagem “A conexão foi encerrada sem retornar os dados finais.”. A forma exata como o chat exibe cada uma dessas mensagens pode variar.

O que fazer: refaça a pergunta com outras palavras ou com mais detalhe sobre o dado procurado. Se a falha se repetir, informe o suporte; é no log dele que está o motivo técnico.

Avisos durante a resposta

Para responder, o agente usa ferramentas, como consultas aos dados. Se uma ferramenta falha no meio do caminho, o agente emite um aviso (evento tool_error) e continua tentando por outro caminho. O aviso tem texto fixo, escolhido pelo tipo de erro do banco. Exemplos:

Aviso	Quando aparece
“A consulta cita uma tabela que não existe.”	A consulta do agente apontou para uma tabela inexistente.
“A consulta cita uma coluna que não existe.”	A consulta apontou para uma coluna inexistente.
“A consulta tem um erro de sintaxe.”	O comando montado pelo agente está mal escrito.
“A consulta demorou mais que o permitido.”	A consulta passou do tempo limite.
“A ferramenta não concluiu; o agente vai tentar outro caminho.”	A falha não veio do banco, ou não tem um motivo conhecido.

Esses avisos não exigem ação sua: o agente segue tentando. Se ele não chegar a uma resposta, vale o que está na seção anterior.

Limite de ferramentas por etapa

O agente executa no máximo 8 ferramentas por etapa de raciocínio. As que excederem o limite recebem de volta a resposta interna “Chamada ignorada: limite de 8 ferramentas por passo.”. Essa resposta volta ao modelo, e não é exibida diretamente a você. O limite evita consumo excessivo.

O que o agente guarda sobre você

O agente mantém uma memória sobre o usuário, para personalizar as respostas. Ela guarda só estes campos:

• nome de tratamento;
• cargo;
• estilo de resposta;
• preferências;
• último tema.

Qualquer outro campo é recusado, e nada é gravado. Cada campo aceita até 2.000 caracteres. Quem passa disso é recusado, em vez de ser cortado: 2.000 caracteres passam, 2.001 não.

Se a gravação dessa memória falhar, o retorno do agente traz só um texto fixo, como “Falha ao gravar a memória.”, às vezes com um código entre parênteses. O texto técnico do banco fica no log.