Solução de Problemas

Esta página cobre problemas comuns no AI Cockpit Lens e as primeiras verificações a realizar antes de escalar um problema.

Não encontro um agente, projeto, workflow ou base de conhecimento

1. Confirme que a organização correta está selecionada.
2. Limpe termos de busca e filtros.
3. Clique em Atualizar quando a página incluir essa ação.
4. Confirme se o item foi criado na organização atual.
5. Peça para um administrador revisar seu acesso se o item deveria estar visível.

Uma lista está vazia

O ambiente pode ainda não ter recursos, ou os filtros atuais podem estar restritivos demais.

1. Limpe filtros e termos de busca.
2. Confirme a organização ativa.
3. Crie o primeiro recurso pela página quando tiver permissão.

O upload de documento não termina

1. Aguarde o processamento terminar.
2. Evite fechar a página enquanto upload ou processamento estiver em andamento.
3. Se aparecer erro no documento, revise o arquivo e envie novamente.
4. Tente um arquivo menor ou um formato suportado quando o arquivo atual continuar falhando.

Uma importação falha

1. Confirme que o adaptador relacionado está configurado.
2. Abra a base de conhecimento e tente importar novamente.
3. Se a lista de projetos ou fontes não carregar, peça para o time responsável pela integração revisar a conexão.

Um workflow não executa

1. Confirme que o workflow está ativo.
2. Verifique se todas as etapas têm agentes configurados.
3. Confirme que bases de conhecimento e adaptadores obrigatórios estão disponíveis.
4. Execute o workflow novamente e revise a mensagem de erro.

O resultado da execução está incompleto ou incorreto

1. Use Chat rápido com IA para solicitar um ajuste na saída.
2. Use Editar manualmente para corrigir o conteúdo diretamente.
3. Execute o workflow novamente se o problema parecer temporário.
4. Revise os agentes, prompts, bases de conhecimento e etapas usados na execução.

Uma opção mencionada na documentação não aparece

Algumas ações dependem da organização ativa, da configuração do ambiente ou das permissões da sua conta.

1. Confirme a organização ativa.
2. Confirme se a funcionalidade está habilitada para essa organização.
3. Peça para um administrador revisar sua função e permissões.

Boas práticas

• Use nomes claros para projetos, agentes, bases de conhecimento e workflows.
• Escreva descrições curtas para que outros usuários entendam cada recurso.
• Teste agentes no playground antes de adicioná-los a workflows importantes.
• Revise resultados gerados antes de exportar ou enviar a integrações.
• Evite excluir recursos antes de confirmar se outros workflows dependem deles.
• Mantenha credenciais de adaptadores atualizadas.
• Confira a organização ativa sempre que os dados parecerem incorretos.