> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mka1.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentos e arquivos

> Anexe material de referência e revise PDFs, planilhas, apresentações e documentos em sessões locais.

export const ScreenshotCrop = ({src, alt, width, height, x = 0, y = 0, cropWidth = width, cropHeight = height, maxWidth = "100%"}) => <div className="not-prose" style={{
  position: "relative",
  overflow: "hidden",
  width: "100%",
  maxWidth,
  margin: "0 auto",
  aspectRatio: `${cropWidth} / ${cropHeight}`
}}>
    <img src={src} alt={alt} width={width} height={height} style={{
  position: "absolute",
  display: "block",
  margin: 0,
  maxWidth: "none",
  width: `${width / cropWidth * 100}%`,
  height: "auto",
  left: `${-x / cropWidth * 100}%`,
  top: `${-y / cropHeight * 100}%`
}} />
  </div>;

Uma tarefa pode incluir requisitos, a captura de um erro, um CSV ou um relatório gerado a partir do projeto. Use anexos para fornecer entradas e prévias para examinar saídas compatíveis ao lado da conversa.

## Adicione material de referência

Em uma sessão local de Código, adicione arquivos pelo menu **+**, cole ou arraste anexos ao compositor. Informe a parte relevante e o resultado desejado:

> Leia os requisitos anexados e compare as regras de quantidade com checkout.js. Liste diferenças com referências ao requisito e ao código. Não edite arquivos ainda.

Algumas operações precisam de uma skill. Se o aplicativo avisar que ela está inativa, ative-a em **Ajustes → Extensões → Habilidades** antes de repetir. Imagens exigem modelo compatível. Para arquivos já no projeto, selecione com `@` em vez de anexar outra cópia.

<Frame caption="Anexe o material de referência e descreva a comparação desejada antes de enviar a solicitação.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/documents.jpg" alt="Arquivo de requisitos junto a uma solicitação para comparar código e testes" width={2720} height={1660} x={1000} y={1230} cropWidth={1160} cropHeight={410} maxWidth="100%" />
</Frame>

## Peça uma saída que possa revisar

Informe formato, dados de origem e finalidade. Por exemplo: “Crie um PDF sobre a correção do checkout, incluindo bug original, arquivos alterados, comando de testes e resultados reais. Salve na pasta reports do projeto.” Confira se os resultados vêm da saída das ferramentas.

Ferramentas de criação e edição dependem das skills ativas e do ambiente. Resolva requisitos ausentes antes de esperar a geração do documento. A prévia mostra arquivos compatíveis; não fornece sozinha todas as ferramentas para criá-los.

## Visualize documentos

**Visualizar documento** abre um documento da resposta ao lado da conversa. A visualização aceita arquivos PDF, DOCX, XLSX, PPTX, CSV e TSV na pasta do projeto da sessão local, com navegação por páginas, planilhas ou slides. Ela é somente leitura e se atualiza quando o arquivo muda. A visualização de planilhas mostra os valores salvos sem recalcular fórmulas; os números exibidos dependem do que foi salvo no arquivo.

A visualização de documentos não está disponível em sessões remotas ou na nuvem. Formatos antigos `.doc`, `.xls` e `.ppt`, documentos protegidos por senha e arquivos do Office com macros não são aceitos.

### Examine e revise um documento

1. Abra **Visualizar documento** no link do arquivo da resposta.
2. Use **Expandir prévia** e percorra páginas, planilhas ou slides.
3. Informe localização e correção na conversa. Por exemplo: “A última coluna da tabela da página 2 do PDF está cortada. Ajuste a largura e gere o arquivo novamente.”
4. Confira a prévia atualizada após a edição. Use **Atualizar prévia** se necessário.

A prévia não edita o arquivo. Para planilhas, peça para recalcular e salvar antes de confiar nos valores das fórmulas. Se a prévia falhar, tente novamente e confira se o arquivo existe na pasta do projeto. Abra formatos incompatíveis no aplicativo que os criou.

Continue com [Conectores, skills e plugins](/pt/docs/mka1-code/extensions).