Registros de incidentes de IA
A REDA AI captura automaticamente erros e eventos inesperados como registros de Registro de incidentes de IA. Esses registros dão aos seus administradores visibilidade total do que está acontecendo nos bastidores — para que os problemas possam ser identificados, investigados e resolvidos rapidamente, sem suposições.
Como os registros de incidentes são criados
Quando ocorre um erro — por exemplo, uma ferramenta não consegue recuperar dados, uma ação não pode ser concluída, ou o serviço de IA retorna uma resposta inesperada — a REDA AI cria automaticamente um registro de Registro de incidentes de IA. Isso acontece em segundo plano, sem exigir nenhuma ação do usuário ou do administrador.
Cada incidente é classificado por gravidade e recebe um status para que você possa priorizar e acompanhar a resolução.
Nem toda entrada aqui é uma falha. Algumas registram uma parada deliberada — uma proteção que decidiu que uma ação não deveria seguir adiante. A mais comum é uma ação agendada cuja condição não pôde ser verificada: em vez de ser executada sem verificação, ela é ignorada e o motivo é anotado, para que a decisão fique visível em vez de silenciosa. Quando você vir uma dessas, leia o motivo antes de tratá-la como um defeito; muitas vezes a explicação é que um campo ao qual a condição se referia foi renomeado ou removido, e a condição precisa ser atualizada. Consulte Execução Condicional.
Distinguir os dois casos importa quando você está percorrendo uma lista: uma falha real precisa ser corrigida, enquanto uma omissão registrada pode ser exatamente o sistema fazendo o que deveria.
Como acessar os registros de incidentes
- Abra o app REDA AI — Clique no Iniciador de aplicativos e abra a REDA AI.
- Clique no menu "Mais" — Na barra de navegação da REDA AI, clique na seta (Mais) para revelar guias adicionais.
- Selecione "Registros de incidentes de IA" — O modo de exibição de lista mostra todos os registros de Registro de incidentes de IA, ordenados do mais recente para o mais antigo.
Entendendo os campos do registro de incidentes
Um registro de incidente reúne três grupos de informação: o que aconteceu (Severity, Error Type, Error Message), onde exatamente (Class Name, Method Name, Line Number, Stack Trace) e em que contexto (Agent, Conversation, User, Record Id). O grupo do meio é o que transforma um chamado de suporte de uma descrição em um diagnóstico — inclua-o quando escalar.
| Campo | O que mostra |
|---|---|
| Severity | ERROR, WARNING ou CRITICAL — os valores exatos, em maiúsculas, pelos quais você filtra uma exibição de lista. |
| Status | New, Investigating, Resolved ou Dismissed. |
| Ocorreu em | Quando o erro foi capturado. |
| Tipo de erro | A classe da exceção, por exemplo System.QueryException ou System.DmlException. O jeito mais rápido de agrupar uma falha recorrente. |
| Mensagem de erro | A mensagem em si. Erros da plataforma podem citar o valor que os causou, então trate este campo como algo que pode conter dados de registros. |
| Contexto de erro | O que a REDA AI estava fazendo quando falhou — normalmente a classe e a operação, como REDAAIArchivalBatch.attachFile (DML). |
| Nome da turma | A classe Apex que levantou o erro. |
| Nome do método | O método dentro dessa classe. |
| Número da linha | A linha em que o erro foi levantado. Junto com Class Name e Method Name, é o que o suporte da REDA precisa para localizar a falha com exatidão. |
| Rastreamento de pilha | O rastreamento completo. O campo mais útil quando você escala um incidente. |
| Agente | A Definição de Agente envolvida, quando a falha aconteceu dentro de um turno do agente. Vazio em jobs de toda a organização, como o arquivamento. |
| Conversa | A conversa em que o erro ocorreu. Clique para ver a transcrição. |
| Ação Programada | A ação agendada envolvida, quando a falha veio de uma. |
| User | O usuário que interagia com o agente no momento, quando aplicável. |
| ID do registro | O registro sobre o qual se operava quando a falha ocorreu, quando aplicável. |
| Notas de resolução | Texto livre para quem trabalhar o incidente — o que foi e o que resolveu. |
Gerenciando o status do incidente
Use o campo Status para acompanhar seu progresso. Os valores são os quatro que a lista de opções realmente traz, e aparecem em inglês em todos os idiomas — o objeto Incident Log não tem traduções, então o que você filtra é o valor em inglês.
- New — registrado, ainda não analisado.
- Investigating — alguém está analisando ativamente.
- Resolved — a causa raiz foi encontrada e corrigida.
- Dismissed — nenhuma ação necessária. Uma falha transitória, uma duplicata ou um erro que você decidiu aceitar.
Seja qual for, registre o motivo em Resolution Notes. Um incidente descartado sem nota é indistinguível, no trimestre seguinte, de um que ninguém olhou.
Filtragem e monitoramento
Use os modos de exibição de lista do Salesforce para filtrar incidentes por status, gravidade, agente ou intervalo de datas. Por exemplo, crie um modo de exibição de lista para "Novos incidentes nos últimos 7 dias" e verifique-a regularmente como parte da sua rotina de manutenção da plataforma.
A gravidade é um destes três valores: WARNING, ERROR ou CRITICAL. Se você criar um Flow do Salesforce para avisar sua equipe quando um incidente for registrado, filtre por esses valores exatos — por exemplo Severity = 'CRITICAL'. Todo incidente é sempre gravado no log por completo, qualquer que seja sua gravidade.
Automação e confiabilidade
Invocações em massa pelo Flow podem retornar IDs de solicitações adiadas em vez de respostas imediatas. Revise elementos seguintes que esperam resposta, créditos ou resultados na mesma transação. Ações automáticas preservam canal e modo configurados e registram resultados reais no contexto, sem garantir uma narração adicional. Deslocamentos horários explícitos são preservados nos caminhos compatíveis de eventos, agendamentos, gravação de campos e CSV. Sem deslocamento, permanece a interpretação do usuário executor. O modo Sistema não gera avisos apenas por ser usado; registros e notificações de nível ERROR permanecem. Extração respeita o limite de saída, cores funcionam nos temas Salesforce compatíveis e testes empacotados evitam referências estáticas que bloqueavam instalação sem tipos de registro de Conta.
Perguntas frequentes
Os registros de incidentes ficam armazenados na sua organização do Salesforce indefinidamente, a menos que você os exclua manualmente ou configure um processo automatizado de arquivamento. O lote de arquivamento da REDA AI tem como alvo principal os registros de conversas; os registros de Registro de incidentes de IA seguem o ciclo de vida padrão de registros e as regras de armazenamento do Salesforce da sua organização.
Um fluxo constante de incidentes WARNING é normal — erros transitórios acontecem em qualquer sistema conectado. O que merece investigação é um volume alto, ou incidentes CRITICAL repetidos para o mesmo agente ou ferramenta merece investigação. Use o recurso Depuração com IA para obter uma explicação em linguagem simples de cada incidente e as próximas etapas recomendadas.
Não. O acesso aos registros de Registro de incidentes de IA é restrito a usuários com o conjunto de permissões REDA AI Admin. Usuários comuns (conjunto de permissões REDA AI User) não têm visibilidade sobre os registros de incidentes.