Resolução de Problemas
O sistema apresenta erro [código de erro]. Como resolver?
Registre um chamado diretamente na Apoia pela opção "Ajuda / Abrir chamado" no menu do usuário: o sistema anexa automaticamente o contexto do erro e um assistente virtual busca a solução imediatamente (veja Sistema de Chamados). Se preferir, também é possível entrar em contato com o suporte técnico do CNJ em: https://suporteti.cnj.jus.br
Erro acessando processo
Recebi um erro do tipo:
Error: Não foi possível acessar o processo [número do processo] no DataLake/Codex da PDPJ (Error: Erro ao realizar consulta. Exception: br.jus.cnj.datalake.exception.ConsultaProcessoException - Erro ao realizar consulta. Exception: br.jus.cnj.datalake.exception.RegistroNaoEncontradoException - Não foram encontrados registros. Origem: br.jus.cnj.datalake.repository.impl.ProcessoRepositoryImpl.buscarProcessoPorPath)
Isso é um erro bem comum, mas não é um erro da Apoia.
A Apoia utiliza o Datalake para obter informações sobre os processos e também o conteúdo das peças processuais.
Esse erro acontece quando a Apoia solicita os metadados de um processo e o datalake responde com um erro.
Este erro pode ser causado por um problema na fila de processamento do Datalake ou na integração entre o tribunal em questão e o Datalake. Se o processo for sigiloso, este erro pode estar relacionado à omissão de processos sigilosos.
Sugimos entrar em contato com a equipe que cuida do datalake para resolver esse problema.
Erro recuperando peça processual
Recebi um erro do tipo:
Error: Não foi possível obter o texto da peça no DataLake/Codex da PDPJ. (Error: Erro interno na API do Codex. - número do processo/identificador da peça)
Isso é um erro bem comum, mas não é um erro da Apoia.
A Apoia utiliza o Datalake para obter informações sobre os processos e também o conteúdo das peças processuais.
Esse erro acontece quando o Datalake diz que um processo tem determinada peça e quando a Apoia solicita o conteúdo textual dessa peça, o datalake responde com um erro.
Este erro pode ser causado por um problema na fila de processamento do Datalake ou na integração entre o tribunal em questão e o Datalake.
Sugimos entrar em contato com a equipe que cuida do datalake para resolver esse problema.
Peça processual indisponível na listagem
Existem novos eventos e peças processuais que não aparecem na lista de seleção de peças da Apoia.
Isso é um erro bem comum, mas não é um erro da Apoia.
A Apoia utiliza o Datalake para obter informações sobre os processos e também o conteúdo das peças processuais.
Este erro pode ser causado por um problema na integração entre o tribunal em questão e o Datalake.
Sugimos entrar em contato com a equipe que cuida do datalake ou a TI do próprio tribunal para resolver esse problema.
Não é possível acessar processos e peças sigilosos
A Apoia utiliza o Datalake para obter informações sobre os processos e também o conteúdo das peças processuais.
O Datalake omite a existência de processos sigilosos e também omite a existência de peças sigilosas.
Está sendo feito um estudo a respeito da liberação dessas peças para pessoas específicas, como por exemplo para o magistrado responsável.
Quando esse estudo for concluído, é possível que algumas situações de sigilo possam ser tratadas pela Apoia. No entanto, mesmo assim ainda haverá questões delicadas em relação ao envio de informações sigilosas para empresas provedoras de IA, como OpenAI, Google e Anthropic.
Enquanto essas duas questões não são resolvidas, a Apoia fica restrita aos processos e peças não sigilosas.
Erro ao utilizar modelos da OpenAI
Caso esteja usando uma chave privada e tente acessar os modelos gpt-5 e gpt-5-mini, é possível que receba o seguinte erro:
Erro na comunicação com o provedor de inteligência artificial: AI_APICallError: Your organization must be verified to stream this model. Please go to: https://platform.openai.com/settings/organization/general and click on Verify Organization. If you just verified, it can take up to 15 minutes for access to propagate.
Isso não é um problema da Apoia, mas sim uma exigência da OpenAI. Para acessar os modelos mais novos é necessário fazer a verificação. Isso incluí o envio de foto de documento de identidade e também do reconhecimento facial. Vá para https://platform.openai.com/settings/organization/general e clique em "Verify Organization" para inicial o processo de verificação.
Erro ao acessar a Apoia
Para acessar a Apoia é necessário utilizar o Login Corporativo do CNJ, veja mais informações em entrando-na-apoia.md.
Erro ao selecionar automaticamente as peças processuais relevantes
A Apoia conta como uma heurística para a seleção automática das peças processuais mais importantes. É importante enviar para a IA apenas as peças principais pois, se enviarmos todas elas, o custo será maior e a qualidade da resposta será pior.
Para identificar as peças importantes, a Apoia se baseia no tipo da peça, que deve estar de acordo com a Tabela Unificada de Documentos Processuais.
Alguns sistemas usam uma tabela própria e isso inviabiliza que a Apoia realize a seleção automática. Se for esse o caso, será sempre necessário selecionar as peças manualmente como pode ser visto em execucao-de-prompts-baseados-em-pecas-processuais.md.
Não consigo visualizar [elemento específico]. O que pode estar acontecendo?
Verifique se você está usando um navegador compatível e se sua conexão está estável. Tente atualizar a página ou utilizar outro navegador.
O sistema está lento. O que posso fazer?
Certifique-se de que sua chave de API está ativa e com créditos suficientes. Modelos como o gpt-4o-mini da OpenAI são recomendados para contas novas por oferecerem maior limite de uso.