Arquivos & artefatos
Trabalhar com o Imaginne é, na maior parte do tempo, trabalhar com arquivos: você dá um arquivo de entrada ao agente e ele devolve artefatos — um .pptx, uma planilha, um PDF, uma imagem ou código. Esta página explica como apontar arquivos para o agente e onde encontrar o que ele produz.
Referenciar um arquivo no contexto
O agente só "vê" um arquivo se você o trouxer para o contexto. A forma de fazer isso varia por superfície.
- Desktop
- Terminal (TUI)
- VS Code
- Chat no navegador
@menção— digite@seguido do caminho (ex.:@docs/relatorio.md) para inserir uma referência literal ao arquivo na mensagem. Use quando quiser apontar o arquivo pelo nome.- + Context — o botão + Context (no painel de arquivos e no dock de Preview) injeta o conteúdo do arquivo no contexto da conversa. É o que você usa quando quer que o agente realmente leia o arquivo. O limite por injeção é de cerca de 100 KB.
@caminho— digite@seguido do caminho para que o terminal leia e injete inline o conteúdo do arquivo:@dados.csv,@"caminho com espaços",@/abs/oluto,@~/home/arquivo.- A tecla Tab completa o caminho (modos path e fuzzy); as setas ↑/↓ navegam nas sugestões.
- Diretórios, arquivos binários e arquivos acima de 100 KB são ignorados.
- A extensão anexa contexto automaticamente a cada turno: a raiz do workspace, o arquivo ativo, a seleção, diagnósticos e abas abertas. As pílulas acima do input mostram o que foi anexado.
@arquivoinjeta o conteúdo de um arquivo específico.- Use Pin Active File/Selection para manter um arquivo fixo entre turnos. Veja Usar no VS Code.
O chat web roda no servidor e não tem acesso ao seu disco — você anexa os arquivos: pelo clipe 📎 do composer, arrastando para a janela ou colando no campo de mensagem. São aceitos documentos, planilhas, apresentações, imagens, texto/código e compactados, até 50 MB por arquivo e 10 anexos por mensagem. Veja Anexos & arquivos da conta.
No Desktop e na TUI, @ aponta para um arquivo, mas é o conteúdo injetado (botão + Context no Desktop; injeção automática do @ na TUI) que o agente realmente lê. Se ele responde "não vejo esse arquivo", confirme que o conteúdo entrou no contexto, não só o nome.
O que são artefatos
Artefatos são os arquivos que o agente gera durante uma sessão. Os tipos mais comuns são:
| Tipo | Extensão | Gerado por |
|---|---|---|
| Apresentação | .pptx | skill ppt_skill |
| Documento | .docx | skill docx |
| Planilha | .xlsx | skill excel |
.pdf | skill pdf | |
| Imagem | .png | /image (Desktop) |
| Código | vários | edições do agente no workspace |
Entre esses artefatos estão os image artifacts: o agente cria imagens a partir de prompts (por exemplo, com /image no Desktop) e elas aparecem como artefatos, ao lado de apresentações, documentos, planilhas e código.
Cada tipo vem de uma capacidade do agente (veja Skills inclusas). Você não precisa invocar a skill manualmente: peça em linguagem natural ("gere um deck sobre X") e o agente escolhe a ferramenta certa.
Onde os arquivos ficam
Nas superfícies locais (Desktop, TUI, VS Code), os artefatos são gravados no disco, dentro do workspace do projeto, em pastas previsíveis:
| Pasta | Conteúdo |
|---|---|
outputs/ | Saídas das skills (.pptx, .docx, .xlsx, .pdf) |
generated-images/ | Imagens criadas com /image |
generated-canvas/ | Canvases (whiteboards) criados com /canvas |
Como os arquivos são locais, eles continuam disponíveis depois que você fecha o app. Veja Execução local para entender por que o Imaginne é local-first.
No chat no navegador não há disco seu envolvido: o sistema de arquivos da execução é efêmero e sobrevivem apenas duas coisas — os anexos que você enviou (guardados com a conversa) e os arquivos que o agente entregou (guardados na sua conta, no painel Arquivos).
Abrir e baixar por superfície
- Desktop
- Terminal (TUI)
- VS Code
- Chat no navegador
- Painel Files (sidebar): navegue na árvore do projeto, clique para abrir um arquivo com o app do sistema, ou use o menu para mover, renomear e excluir.
- Dock de Preview (Alt+1): renderiza PDF, DOCX, XLSX e diagramas Mermaid dentro do app; de lá você pode Abrir com o sistema, usar @ Insert ou + Context.
- Para criar um arquivo do zero, use Novo arquivo (Text, Markdown, Word, Excel, PowerPoint).
Os artefatos são gravados no diretório do projeto. Abra-os com as ferramentas do seu sistema (ex.: o explorador de arquivos ou o aplicativo correspondente). A transcrição informa o caminho de cada arquivo gerado.
Edições de código entram primeiro em Proposed Changes (Composer): revise o diff e use Apply / Reject por arquivo ou trecho. Artefatos binários (como .pptx) aparecem em outputs/ no Explorer. Veja Usar no VS Code.
Os artefatos aparecem na transcrição como cartões (ícone + nome + tipo·tamanho + botão Baixar); imagens ganham prévia. O artefato principal é destacado com ⭐; os demais ficam em "Outros arquivos da execução".
Além da conversa, tudo que o agente entrega fica guardado na sua conta, no painel Arquivos da barra lateral — com 100 MB de espaço por usuário, download e exclusão. Veja Anexos & arquivos da conta.
Locais de leitura autorizados (Desktop)
Por padrão, o agente opera dentro do workspace do projeto. No Desktop, além do workspace, ele pode ler (somente leitura) de algumas pastas comuns do seu usuário:
- Documents, Downloads e Desktop
- iCloud Drive e OneDrive (apenas leitura)
Qualquer escrita vai para o workspace do projeto — o agente não modifica arquivos fora dele sem que a política autorize. Esse limite é o cofre descrito em Autonomia & permissões.
Os artefatos e o estado da sessão ficam em arquivos no seu disco, em texto legível. Trate a máquina como você trataria qualquer pasta com documentos de trabalho. Veja Segurança & privacidade.
Veja também
Esta página ajudou?
Reportar um problema nesta páginaNão envie senhas, chaves, tokens ou dados de clientes.