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

O Prism é um espaço de trabalho LaTeX colaborativo e nativo de IA, baseado em modelos de fronteira e concebido para ajudar os investigadores a pensar, escrever e aperfeiçoar o seu trabalho mais rapidamente. A Inteligência integrada aumenta a rapidez e a profundidade do trabalho científico.

Este guia explica como resolver problemas comuns e onde obter ajuda adicional.

Como aceder ao Prism

O Prism está disponível em prism.openai.com para todos os utilizadores com uma conta ChatGPT Free, Go, Plus ou Pro que não sejam nem tenham sido membros de um espaço de trabalho Business ou Enterprise. Vamos expandir o acesso ao Business, Enterprise e Edu num futuro próximo.

1. Utilizar a Inteligência integrada do Prism

O Prism inclui um assistente integrado no editor, baseado nos modelos de fronteira da OpenAI. O assistente compreende o contexto do documento e pode ajudar a gerar LaTeX, diagnosticar erros e sugerir correções sem sair do editor. Pode aceder-lhe através do painel situado na parte inferior do espaço de trabalho.

1. Gerar fragmentos de LaTeX: Peça ao Prism para criar elementos LaTeX comuns, por exemplo, «Cria uma tabela 4 × 4» ou «Adiciona uma figura com uma legenda». O Prism devolve código LaTeX pronto a utilizar e apresenta as opções Manter e Anular, para que possa inseri-lo diretamente no projeto.

2. Diagnosticar problemas de compilação: Se não conseguir compilar o documento, descreva o problema no painel (por exemplo, «O meu documento não está a compilar»). O Prism fará perguntas de esclarecimento e irá orientá-lo pelas causas mais prováveis, como comandos em falta ou referências não resolvidas.

3. Corrigir erros diretamente no texto: Os erros e avisos aparecem como marcadores vermelhos ou amarelos na margem do editor. Pode pedir ao Prism que corrija um erro específico. O Prism analisará as linhas relevantes, explicará o problema e sugerirá alterações específicas. Pode aplicar diretamente a sugestão e voltar a compilar para confirmar a correção.

4. Rever o texto: Peça ao Prism para rever uma secção, assinalar erros ou falhas de lógica e sugerir formas de melhorar a clareza da secção. Pode tirar partido de Competências, como a Revisão de Artigos, para obter comentários editoriais e factuais.

5. Pesquisar literatura: Adiciona uma bibliografia ao meu artigo e sugere trabalhos relacionados que eu possa não ter encontrado.

2. Diagnosticar erros de compilação

Se o seu documento LaTeX não compilar, experimente os seguintes passos:

1. Verifique o marcador de erro: Os marcadores vermelhos e amarelos assinalam os locais onde o Prism detetou um problema. Clique no marcador para ver os detalhes e utilize o assistente integrado para diagnosticar o erro.

2. Consulte o registo de compilação: Quando a compilação falha, o painel de pré-visualização do PDF apresenta um registo de compilação. Concentre-se na primeira mensagem de erro (por exemplo, um \end{document} em falta), pois os erros posteriores são frequentemente efeitos em cadeia. Partilhe esta mensagem com o Prism para obter orientações mais precisas.

3. Anule as alterações recentes: Se o erro tiver surgido após uma edição recente, anule ou transforme temporariamente essa alteração num comentário para verificar se a compilação é concluída.

4. Reduza o documento a um exemplo mínimo: Se os problemas persistirem, simplifique o documento, mantendo apenas o conteúdo essencial. A remoção de secções não relacionadas ajuda a isolar a origem do erro.

3. Boas práticas para evitar problemas

1. Mantenha a sessão iniciada: Trabalhe sempre com a sessão iniciada, para garantir que as alterações são guardadas e ficam disponíveis entre sessões.

2. Utilize pacotes suportados: O Prism suporta muitos dos pacotes LaTeX mais utilizados. Os pacotes pouco comuns, 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. Assim, será mais fácil identificar a alteração que introduziu um erro e recuperar rapidamente.

Transferir projetos LaTeX para o Prism

Este guia explica como transferir projetos LaTeX existentes — provenientes do Overleaf ou do seu computador — para o Prism. A importação dos projetos mantém tudo num único local e permite-lhe continuar a trabalhar sem ter de recriar manualmente os ficheiros.

Importar projetos do Overleaf

Para transferir um projeto do Overleaf para o Prism, comece por transferir os ficheiros do projeto a partir do Overleaf e, em seguida, carregue-os no Prism.

Transferir um único projeto

1. Abra o painel de projetos do Overleaf.

2. Localize o projeto que pretende transferir.

3. Clique no ícone de transferência situado na mesma linha que o nome do projeto.

4. O Overleaf transfere todo o projeto para o seu computador como um ficheiro .zip.

Transferir vários projetos

1. Abra a sua lista de projetos do Overleaf.

2. Selecione os projetos através da caixa de seleção no início de cada linha.

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

2. Depois de selecionar os projetos, clique no ícone de transferência no canto superior direito da lista de projetos.

Os projetos selecionados serão transferidos como ficheiros .zip.

Importar projetos para o Prism

O Prism pode importar projetos de três formas: carregando uma pasta, carregando um arquivo .zip ou arrastando e largando ficheiros na vista Todos os projetos.


Para importar um projeto através do menu Importar:

1. Abra o Prism e aceda a Importar.

2. Clique no símbolo de seta junto a Importar para escolher o tipo de importação.

Selecione uma das seguintes opções:

1. Abra o Prism e aceda à opção Importar.

2. Clique no símbolo de seta junto a Importar para escolher o tipo de importação.

3. Selecione uma das seguintes opções:

Importar um ficheiro .zip: Escolha no computador o arquivo do projeto que transferiu. O Prism irá descompactar e carregar automaticamente o projeto.


Importar uma pasta: Escolha no computador a pasta do projeto. O Prism irá importar os ficheiros .tex, os ficheiros de bibliografia, as imagens e os restantes recursos do projeto.


Para importar através da função de arrastar e largar: Na vista Todos os projetos, arraste e largue no Prism uma pasta de projeto ou um ficheiro .zip. O Prism irá criar automaticamente um novo projeto e importar os ficheiros por si.

Quando o carregamento terminar, o Prism abre o projeto completo para que possa começar a editar e a compilar.

Outras perguntas frequentes

Conta, segurança e faturação

P: Onde posso encontrar a vossa política de privacidade? R: Pode consultar a política de privacidade do Prism aqui.

P: Utilizam os meus dados para treinar os vossos modelos? R: Os utilizadores têm controlo total sobre a utilização dos seus dados para ajudar a melhorar os nossos modelos, em conformidade com a nossa Política de Privacidade.

P: Utilizam a opção «Retenção Zero de Dados» (ZDR)? Que registos são mantidos e durante quanto tempo? R: Atualmente, o Prism não utiliza a opção de API «Retenção Zero de Dados» (ZDR) e mantém registos durante algum tempo após os pedidos, para melhorar o produto.


P: Disponibilizam um modo de privacidade no qual nenhum texto seja armazenado ou revisto por pessoas e/ou residência de dados exclusivamente na UE? R: Estas funcionalidades foram solicitadas e constam do plano de desenvolvimento ou da lista de tarefas pendentes, mas ainda não existe um prazo definido.

Partilha e colaboração

P: Porque não posso partilhar uma ligação que permita a qualquer pessoa editar? (O menu pendente apenas permite escolher «qualquer pessoa pode ver».) R: Atualmente, este comportamento é intencional. A partilha através de uma ligação que permita a qualquer pessoa editar ainda não é suportada; os editores têm de ser adicionados como colaboradores e ter uma conta Prism.


P: Os colaboradores não estão a receber os e-mails de convite. Como podem aceder ao projeto? R: Peça-lhes que verifiquem a pasta de spam ou correio não solicitado e que iniciem sessão com o endereço de e-mail que recebeu o convite. O projeto partilhado deverá aparecer após o primeiro início de sessão.

Importação e exportação de projetos

P: O carregamento ou a importação do meu ZIP ficou bloqueado em «a importar o seu projeto». O que devo fazer? R: Tente carregar novamente. Se continuar bloqueado após uma nova tentativa, partilhe o ficheiro ZIP com o Apoio ao Cliente para que o processo de importação possa ser analisado.


P: Como posso exportar ou transferir o meu projeto em formato ZIP? R: Clique no nome do projeto e escolha Exportar para transferir uma cópia comprimida do projeto. Poderá demorar alguns segundos a estabelecer a ligação ao backend antes de ser possível exportar.

Fiabilidade, interrupções e conectividade

P: Os meus projetos desapareceram depois de atualizar. Perdi-os? R: Atualize novamente e volte a consultar a lista de projetos. Os seus dados deverão reaparecer.


P: Os meus projetos desapareceram depois de atualizar a página. Perdi-os? R: Isto pode acontecer durante uma interrupção do serviço de um fornecedor. Tente novamente; os seus projetos deverão reaparecer. Caso contrário, o Apoio ao Cliente poderá ajudar a recuperá-los.


P: O site parece estar offline ou a aplicação indica que não consegue estabelecer ligação ao backend. O que devo fazer? R: Tente novamente ou recarregue a página. Se o problema persistir, envie ao Apoio ao Cliente os detalhes do que está a observar e, se possível, uma ligação para o projeto, para que a situação possa ser investigada.

Integridade e recuperação de dados, cópias de segurança e histórico de versões

P: O meu documento bloqueou; depois, desapareceu conteúdo e as âncoras dos comentários mudaram de posição. Posso restaurá-lo? R: Comece por transferir uma cópia de segurança em formato .zip. O Prism também inclui um histórico de versões, que poderá permitir-lhe restaurar uma versão anterior. Nem sempre é possível recuperar as posições das âncoras dos comentários e, atualmente, os comentários não são exportados nas cópias de segurança. Se a formatação tiver mudado, experimente usar o formatador de código para a corrigir.


P: Reabri um projeto e os ficheiros ou conteúdos foram revertidos ou desapareceram. O que aconteceu? R: Durante algum tempo, a gravação dos projetos dependeu de um fornecedor externo que não conseguiu acompanhar um pico de utilização. A gravação foi migrada para um sistema interno, de modo a reduzir os erros de ligação e evitar que o problema voltasse a ocorrer, e foram adicionadas outras salvaguardas.


P: É possível recuperar as posições dos comentários? Os comentários são incluídos nas cópias de segurança dos projetos? R: Poderá não ser possível recuperar posteriormente as posições dos comentários. Existem agora cópias de segurança periódicas (por exemplo, a cada 10 minutos, aproximadamente) para permitir a recuperação em futuros incidentes, mas os comentários não são atualmente exportados nas cópias de segurança em formato ZIP.

Integrações

Zotero

P: Porque não consigo importar bibliotecas de grupo do Zotero para o Prism? R: As bibliotecas de grupo do Zotero ainda não são suportadas. As bibliotecas individuais funcionam, mas as de grupo não são atualmente suportadas.


P: A minha integração com o Zotero está bloqueada (por exemplo, após mudar de conta ou de chave de API). Como posso corrigi-la? R: O Apoio ao Cliente precisará do seu ID numérico do Zotero, e não do seu nome de utilizador, para desassociar a integração do utilizador anterior ou anónimo. Depois, poderá voltar a associá-la à sua conta. Este vídeo mostra como fazê-lo: https://www.youtube.com/watch?v=7vDiZ8o_eHk

Git

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

Compilação de LaTeX e resolução de problemas

P: Como posso forçar uma recompilação limpa, eliminando os artefactos Aux/toc/bbl? R: Recarregue a página. A atualização da página força uma compilação nova e limpa.


P: As figuras ou imagens não são carregadas no Prism, mas o mesmo código LaTeX funciona noutro local. R: Utilize caminhos relativos ao ficheiro .tex que efetua a importação. Se o ficheiro .tex estiver numa subpasta e a imagem estiver na raiz do projeto, acrescente ../ no início do caminho.


P: A compilação é extremamente lenta ou nunca termina. Como posso identificar a causa? R: Transforme secções em comentários — e depois partes mais pequenas dessas secções — até a compilação ser concluída. Em seguida, reduza progressivamente a área analisada até encontrar a linha exata que causa o problema. Consulte também os avisos e erros nos registos, começando pelo primeiro.


P: Estou a receber avisos «Underfull/Overfull \hbox» no ficheiro .bbl gerado. Trata-se de um erro de compilação? R: Não. São avisos de composição tipográfica, não erros fatais de compilação. Se o PDF tiver um aspeto aceitável, geralmente pode ignorar o aviso.


P: No Beamer, porque é que os ambientes lstlisting/listings geram um erro dentro de uma frame (por exemplo, «Extra }, or forgotten \endgroup»)? R: Ao utilizar ambientes de listagem, marque a frame do Beamer como [fragile]. Isto resolve frequentemente estes erros.


P: As minhas citações \cite aparecem como «[?]», embora o ficheiro .bib exista e os comandos da bibliografia estejam presentes. Que configuração funciona? Uma solução que tem funcionado consiste em garantir que a bibliografia está corretamente incluída a partir do documento principal. Para fluxos de trabalho ao estilo do BibTeX, inclua \bibliographystyle{plain} e \bibliography{refs} (em que refs.bib é o seu ficheiro).

Interface do produto e pedidos de funcionalidades

P: O Prism disponibiliza um modo claro? R: Sim. O Prism disponibiliza três definições de aparência: Sistema, Claro e Escuro. Pode escolher o tema que melhor se adapta às suas preferências.