Session Tags

A plataforma Tech4AI aplica tags sistêmicas (SessionTag) às sessões de conversa automaticamente para classificar erros, eventos e comportamentos. Essas tags são persistidas por sessão e ficam disponíveis via API e no backoffice.

As tags se aplicam tanto à API v1 quanto à API v2. Duas tags são exclusivas da v2 e estão sinalizadas na tabela: with-file e message-queued.

Referência

Erros de LLM

Valor	Label	Descrição
error-llm-timeout	Timeout do LLM	A requisição ao LLM excedeu o tempo limite configurado.
error-llm-max-retries	Limite de tentativas do LLM excedido	O número máximo de retentativas ao LLM foi atingido sem sucesso.
error-llm-gateway	Erro no gateway do LLM	Falha no gateway intermediário entre a plataforma e o provedor de LLM.
error-llm-content-filter	Bloqueado por content filter do provedor	O provedor de LLM rejeitou o prompt enviado (incluindo a mensagem do usuário) por violar suas políticas de conteúdo.
error-llm-bad-request	Requisição inválida ao LLM	A requisição enviada ao LLM continha parâmetros inválidos ou malformados.
error-context-overflow	Estouro de contexto do LLM	O contexto da conversa ultrapassou o limite de tokens suportado pelo modelo.
llm-retried	Retry no LLM	A chamada ao LLM foi refeita após uma falha transitória.
llm-fallback-used	LLM fallback ativado	Um modelo de fallback foi utilizado em substituição ao modelo principal.

Erros de Actions

Valor	Label	Descrição
error-tool-failure	Falha na execução de tool	Uma action (tool call) retornou erro durante a execução.
error-action-timeout	Timeout na action	A action não respondeu dentro do tempo limite configurado.
error-action-network	Erro de rede na action	Falha de conectividade ao executar uma action.
error-action-json-parse	Erro de parse JSON na action	A resposta da action não pôde ser interpretada como JSON válido.
error-action-syntax	Erro de sintaxe na action	A action contém erro de sintaxe que impediu sua execução.
error-action-runtime	Erro de runtime na action	Exceção lançada durante a execução da action.
action-503-retried	Retry por 503 na action	A action retornou HTTP 503 e foi reexecutada automaticamente.
error-max-tool-recursion	Limite de recursão de tools atingido	O agente excedeu o número máximo permitido de chamadas encadeadas de tools.

Erros Gerais

Valor	Label	Descrição
error-unhandled-exception	Exceção não tratada	Uma exceção não esperada ocorreu durante o processamento da sessão.
error-http-client	Erro HTTP no cliente de integração	Falha em uma requisição HTTP realizada pelo cliente de integração interno.
error-external-http	Erro HTTP externo	Falha em uma requisição HTTP a um serviço externo.
error-guardrails-block	Bloqueado por guardrail	A mensagem foi bloqueada por um guardrail configurado no agent.
guardrail-low-confidence-pass	Detectado pelo guardrail com baixa confiança (permitido)	O guardrail classificou a mensagem como insegura, mas com confiança abaixo do min_confidence configurado; a mensagem foi liberada.
guardrail-shadow-block	Bloqueio pelo guardrail em shadow mode (turno não interrompido)	O guardrail classificou a mensagem como insegura com confiança suficiente, mas o agent está em shadow mode; o bloqueio foi registrado sem interromper o turno.
error-memory-limit	Limite de memória atingido	O uso de memória da sessão ultrapassou o limite permitido.
error-agent-transfer	Erro na transferência entre agentes	Ocorreu um erro ao tentar transferir a conversa para outro agente.

Transferências e Fluxo

Valor	Label	Descrição
transferred-human	Transferido para humano	A conversa foi transferida para atendimento humano.
transferred-agent	Transferido para outro agente	A conversa foi transferida para outro agente da plataforma.
skill-redirected	Skill redirecionada	O agente redirecionou a execução para uma skill diferente.

Limites e Timeouts

Valor	Label	Descrição
max-interactions-reached	Limite de interações atingido	A sessão atingiu o número máximo de trocas de mensagens configurado.
message-limit-reached	Limite de mensagens da conversa atingido	O limite de mensagens por conversa foi atingido.
idle-timeout	Timeout por inatividade	A sessão foi encerrada por inatividade do usuário.

Knowledge Base

Valor	Label	Descrição
kb-used	KB utilizada	A base de conhecimento foi consultada durante a sessão.
kb-forced-search	Busca forçada na KB	Uma busca na base de conhecimento foi forçada independente do contexto.

Mídia e Arquivos

Valor	Label	Descrição
with-file	Áudio e/ou imagem recebida	A sessão recebeu um arquivo de áudio ou imagem do usuário. Exclusivo da API v2.
vision-used	Vision utilizado	O módulo Vision foi acionado para processar uma imagem.

Fila e Infraestrutura

Valor	Label	Descrição
message-queued	Mensagem enfileirada	A sessão já estava processando outra mensagem quando a requisição chegou. A nova mensagem não foi processada e o agent retornou uma resposta padrão. Exclusivo da API v2.

Eval

Valor	Label	Descrição
eval	Sessão de eval	A sessão foi gerada por uma execução de eval (runner ou canário), e não por uma conversa real de usuário.