Solução de problemas e obtenção de ajuda no Prism

Prism é um workspace colaborativo nativo de IA para LaTeX, desenvolvido com base em modelos de ponta — projetado para ajudar pesquisadores a pensar, escrever e iterar mais rápido. Sua inteligência incorporada amplia tanto a velocidade quanto a profundidade do trabalho científico.

Este guia explica como solucionar problemas comuns e onde encontrar ajuda adicional.

Como acessar o Prism

O Prism está disponível em prism.openai.com para todos os usuários com uma conta ChatGPT Free, Go, Plus ou Pro que não sejam nem tenham sido membros de um workspace Business ou Enterprise. Expandiremos o acesso para Business, Enterprise e Edu em breve.

1. Usando a inteligência integrada do Prism

O Prism inclui um assistente nativo do editor, alimentado pelos modelos de ponta da OpenAI. Ele entende o contexto do seu documento e pode ajudar a gerar LaTeX, diagnosticar erros e sugerir correções sem que você precise sair do editor. Você pode acessá-lo pelo painel na parte inferior do workspace.

1. Gerar snippets de LaTeX: Peça ao Prism para criar elementos comuns de LaTeX, como “Criar uma tabela 4×4” ou “Adicionar uma figura com legenda”. O Prism retornará LaTeX pronto para uso e fornecerá as opções Keep e Undo para que você possa inseri-lo diretamente no seu projeto.

2. Diagnosticar problemas de compilação: Se o seu documento não compilar, descreva o problema no painel (por exemplo, “Meu documento não está compilando”). O Prism fará perguntas de esclarecimento e orientará você sobre causas prováveis, como comandos ausentes ou referências não resolvidas.

3. Corrigir erros inline: Erros e avisos aparecem como marcadores vermelhos ou amarelos na margem do editor. Você pode pedir ao Prism para corrigir um erro específico, e ele analisará as linhas relevantes, explicará o que está errado e sugerirá edições direcionadas. Você pode aplicar a sugestão diretamente e recompilar para confirmar a correção.

4. Revisar: Peça ao Prism para revisar uma seção e destacar quaisquer erros ou lacunas de lógica, além de fazer sugestões de como posso melhorar a clareza da seção. Você pode aproveitar Skills, como uma Paper Review, para receber feedback editorial e factual.

5. Busca de literatura: Adicione uma bibliografia ao meu artigo, incluindo sugestões de trabalhos relacionados que eu possa ter deixado passar.

2. Diagnosticando erros de compilação

Se o seu documento LaTeX não compilar, tente as seguintes etapas:

1. Verifique o marcador de erro: Marcadores vermelhos e amarelos destacam onde o Prism detectou um problema. Clique no marcador para ver os detalhes e use o assistente integrado para diagnosticar o erro.

2. Revise o log de compilação: Quando a compilação falha, o painel de visualização do PDF mostra um log de compilação. Foque na primeira mensagem de erro (por exemplo, um \end{document} ausente), pois os erros posteriores geralmente são efeitos em cascata. Compartilhe essa mensagem com o Prism para receber orientações mais precisas.

3. Desfaça alterações recentes: Se o erro apareceu após uma edição recente, desfaça ou comente temporariamente essa alteração para ver se a compilação é concluída com sucesso.

4. Reduza para um exemplo mínimo: Se os problemas persistirem, simplifique o documento para deixar apenas o conteúdo essencial. Remover seções não relacionadas ajuda a isolar a origem do erro.

3. Práticas recomendadas para evitar problemas

1. Permaneça conectado: Sempre trabalhe estando conectado para garantir que suas alterações sejam salvas e fiquem disponíveis entre sessões.

2. Use pacotes compatíveis: O Prism oferece suporte a muitos pacotes LaTeX comumente usados. Pacotes raros, desatualizados ou sem manutenção podem causar erros de compilação inesperados.

3. Edite de forma incremental: Faça pequenas alterações e compile com frequência. Isso facilita identificar qual edição introduziu um erro e recuperar rapidamente.

Movendo projetos LaTeX para o Prism

Este guia explica como mover projetos LaTeX existentes — do Overleaf ou do seu computador local — para o prism. Importar seus projetos mantém tudo em um só lugar e permite que você continue trabalhando sem reconstruir seus arquivos manualmente.

Importando projetos do Overleaf

Para mover um projeto do Overleaf para o prism, primeiro baixe os arquivos do projeto do Overleaf e depois faça upload deles para o prism.

Baixar um único projeto

1. Abra seu painel de projetos do Overleaf.

2. Localize o projeto que você quer transferir.

3. Clique no ícone de download na mesma linha do nome do projeto.

4. O Overleaf baixa o projeto inteiro como um arquivo .zip para o seu computador.

Baixar vários projetos

1. Abra sua lista de projetos do Overleaf.

2. Selecione os projetos usando a caixa de seleção no início de cada linha.

   

3. Para selecionar tudo, clique na primeira caixa de seleção da lista.

4. Depois de selecionar, clique no ícone de download no canto superior direito da lista de projetos.

   

Os projetos selecionados serão baixados como arquivos .zip.

Importando projetos para o Prism

O Prism pode importar projetos de três formas: fazendo upload de uma pasta, fazendo upload de um arquivo .zip ou arrastando e soltando arquivos na visualização All Projects.


Para importar um projeto pelo menu Import:

1. Abra o Prism e vá até Import.

2. Clique no chevron ao lado de Import para escolher o tipo de importação.

Selecione uma das opções abaixo:

1. Abra o prism e navegue até a opção Import.

2. Clique no chevron ao lado de Import para escolher o tipo de importação.

3. Selecione uma das opções abaixo:

Importar um arquivo .zip: Escolha o arquivo do projeto baixado no seu computador. O Prism vai descompactar e carregar o projeto automaticamente.

Importar uma pasta: Escolha a pasta do projeto no seu computador. O Prism importará seus arquivos .tex, arquivos de bibliografia, imagens e outros recursos do projeto.

Para importar arrastando e soltando: Na visualização All Projects, arraste e solte uma pasta de projeto ou um arquivo .zip no Prism. O Prism criará automaticamente um novo projeto e importará os arquivos para você.

Depois que o upload terminar, o Prism abrirá o projeto completo para que você possa começar a editar e compilar.

Outras perguntas frequentes

Conta, segurança e cobrança

P: Onde posso encontrar a política de privacidade de vocês?
R: Você pode encontrar a política de privacidade do Prism aqui.

P: Vocês treinam com meus dados?
R: Os usuários têm controle total sobre se seus dados são usados para ajudar a melhorar nossos modelos, de acordo com nossa política de privacidade.

P: Vocês usam “zero retenção de dados” (ZDR)? Que registro/retenção acontece?
R: O Prism não usa atualmente a opção de API “zero retenção de dados” (ZDR) e mantém logs por um período após as solicitações para melhorar o produto.


P: Vocês oferecem um modo de privacidade em que nenhum texto é armazenado nem revisado por humanos e/ou residência de dados somente na UE?
R: Esses são recursos solicitados; eles estão no roadmap/backlog, mas ainda não há um cronograma definido.

Compartilhamento e colaboração

P: Por que não consigo compartilhar um link “qualquer pessoa pode editar”? (O menu suspenso só permite “qualquer pessoa pode visualizar”.)
R: Atualmente, isso é intencional. O compartilhamento por link “editável por qualquer pessoa” ainda não é compatível; os editores precisam ser adicionados como colaboradores (com uma conta Prism).

P: Os colaboradores não estão recebendo os e-mails de convite — como podem acessar o projeto?
R: Peça que verifiquem a pasta de spam/lixo eletrônico e que façam login usando o endereço de e-mail convidado; o projeto compartilhado deve aparecer para eles após o primeiro login.

Importação e exportação de projetos

P: Meu upload/importação de ZIP ficou preso em “importando seu projeto”. O que devo fazer?
R: Tente reenviar o upload. Se ainda ficar travado após a nova tentativa, compartilhe o arquivo ZIP com o Suporte para que o caminho de importação possa ser depurado.

P: Como exporto/baixo meu projeto como ZIP?
R: Clique no nome do projeto e escolha Export para baixar uma cópia compactada do projeto. Pode levar alguns segundos para que a conexão de backend seja estabelecida antes que a exportação fique disponível.

Confiabilidade, interrupções e conectividade

P: Meus projetos desapareceram depois de atualizar. Eles foram perdidos?
R: Atualize novamente e verifique a lista de projetos de novo; seus dados devem reaparecer.

P: Meus projetos desapareceram depois de atualizar a página. Eles foram perdidos?
R: Isso pode acontecer durante uma indisponibilidade de um provedor. Tente novamente; seus projetos devem reaparecer. Se não reaparecerem, o suporte pode ajudar a recuperá-los.

P: O site parece offline / o app diz que não consegue se conectar ao backend. O que devo fazer?
R: Tente novamente/recarregue. Se o problema persistir, envie ao suporte os detalhes do que você está vendo (e, se possível, um link do projeto) para que isso possa ser investigado.

Integridade de dados, recuperação, backups e histórico de versões

P: Meu documento travou, depois o conteúdo desapareceu e as âncoras dos comentários mudaram. Posso restaurá-lo?
R: Comece baixando um backup .zip. O Prism também inclui histórico de versões, o que pode permitir restaurar uma versão anterior. As posições das âncoras dos comentários nem sempre podem ser recuperadas, e os comentários não são exportados nos backups no momento. Se a formatação mudou, tente o formatador de código para corrigi-la.

P: Reabri um projeto e os arquivos/conteúdo voltaram para uma versão anterior ou desapareceram — o que aconteceu?
R: Houve um período em que o salvamento de projetos dependia de um provedor externo que não conseguiu acompanhar um pico de uso. O salvamento foi migrado para um sistema interno para reduzir erros de conexão e evitar recorrência, e salvaguardas adicionais foram acrescentadas.

P: As posições dos comentários podem ser recuperadas e os comentários estão incluídos nos backups do projeto?
R: As posições dos comentários podem não ser recuperáveis depois do ocorrido. Agora há backups periódicos (por exemplo, a cada ~10 minutos) para recuperação em incidentes futuros, mas os comentários não são exportados nos backups ZIP no momento.

Integrações

Zotero

P: Por que não consigo importar bibliotecas de grupo do Zotero para o Prism?
R: As bibliotecas de grupo do Zotero ainda não são compatíveis; bibliotecas individuais funcionam, mas bibliotecas de grupo não são compatíveis no momento.

P: Minha integração com o Zotero está travada (por exemplo, após trocar de conta ou chaves de API). Como isso pode ser corrigido?
R: O Suporte precisará do seu ID numérico do Zotero (não do seu nome de usuário) para desvincular a integração do usuário anterior/anônimo, após o que você poderá vinculá-la novamente à sua conta. Exemplo de como fazer isso: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

P: Posso clonar um projeto do Prism via Git (GitHub/GitLab) ou mantê-lo sincronizado com a plataforma Git da minha instituição?
R: A integração com Git ainda não está disponível, mas é um projeto de desenvolvimento futuro de alta prioridade.

Build do LaTeX e solução de problemas

P: Como forço uma reconstrução limpa (limpar artefatos Aux/toc/bbl)?
R: Recarregue a página. Atualizar a página força um build novo e limpo.

P: Figuras/imagens não carregam no Prism, mas o mesmo LaTeX funciona em outro lugar.
R: Use caminhos relativos ao arquivo .tex que faz a importação. Se o arquivo .tex estiver em uma subpasta e a imagem estiver na raiz do projeto, prefixe o caminho com ../.

P: A compilação está extremamente lenta ou nunca termina. Como identifico a causa?
R: Comente seções (e depois partes menores dentro dessas seções) até que a compilação seja concluída com sucesso e, em seguida, reduza até encontrar a linha exata que causa o problema. Revise também avisos e erros nos logs, começando pelo primeiro.

P: Estou recebendo avisos “Underfull/Overfull \hbox” no .bbl gerado. Isso é um erro de compilação?
R: Não, esses são avisos de composição tipográfica, não erros fatais de compilação. Se a saída em PDF parecer aceitável, o aviso geralmente pode ser ignorado.

P: No Beamer, por que ambientes lstlisting/listings dão erro dentro de um frame (por exemplo, “Extra }, or forgotten \endgroup”)?
R: Marque o frame do Beamer como [fragile] ao usar ambientes de listing; isso geralmente resolve esses erros.

P: Minhas citações \cite aparecem como “[?]” mesmo com meu .bib existindo e os comandos de bibliografia presentes. Qual é uma configuração funcional?
Uma solução alternativa que tem funcionado é garantir que a bibliografia seja incluída corretamente a partir do documento principal; para fluxos de trabalho no estilo BibTeX, inclua \bibliographystyle{plain} e \bibliography{refs} (em que refs.bib é o seu arquivo).

UI do produto e solicitações de recursos

P: O Prism oferece modo claro?
R: Sim. O Prism oferece três configurações de aparência: Sistema, Claro e Escuro. Você pode escolher o tema que funciona melhor para você.