> ## 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.

# Sessões e contexto do projeto

> Adicione arquivos, oriente tarefas ativas, encontre trabalhos anteriores e confira o contexto.

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 sessão de Código reúne a conversa, os resultados das ferramentas e o ambiente selecionado. Use-a para investigar um problema, orientar uma tarefa ativa e retomar o trabalho depois. Comece pelo [início rápido](/pt/docs/mka1-code/first-task) se ainda não executou uma sessão.

## Inicie e organize uma sessão

Abra **Código → Nova sessão**, escolha uma pasta e confira branch, modelo e permissões antes da primeira mensagem. Essa mensagem vincula o ambiente à sessão. Para trabalhar em outro ambiente de execução, crie uma sessão e escolha o destino primeiro.

Dê a cada sessão um objetivo específico, como investigar um teste de checkout ou revisar uma mudança de API. Use o menu da sessão para renomear, fixar trabalhos frequentes ou arquivar o que terminou. Sessões arquivadas continuam em **Arquivadas**. Excluir uma sessão local remove seu histórico deste computador; leia a confirmação antes de continuar.

Uma conversa nova não cria outra cópia do repositório. Se duas tarefas precisarem editar o projeto de forma independente, use [worktrees separados](/pt/docs/mka1-code/workspaces).

## Adicione contexto do projeto

Mencione caminhos de arquivos com `@` ou anexe a saída do teste que falhou. O campo de mensagem aceita seleção de arquivos, arrastar e soltar e anexos colados, incluindo especificações e capturas de tela. O envio de imagens exige um modelo que aceite esse tipo de entrada.

### Faça uma solicitação verificável

Inclua comportamento observado, resultado esperado e como verificá-lo. Nomes de arquivos e saída do erro ajudam o agente a começar pelo código relevante:

> O checkout retorna 12 para três itens com preço 12. Leia @checkout.js e @checkout.test.js. Adicione um teste que falhe esperando total 36, corrija o cálculo e execute npm test. Preserve a assinatura pública da função.

Selecione o item correto nas sugestões de `@` antes de enviar. Anexe um design ou captura quando a aparência importar e explique a região relevante. Alguns documentos exigem uma skill; o aplicativo avisa quando ela está inativa.

Na miniatura da captura, abra a opção de marcação da imagem para destacar um controle ou região. Revise o resultado e escolha **Aplicar**. A imagem marcada substitui o anexo dessa mensagem.

## Acompanhe uma tarefa em execução

A linha do tempo registra as respostas e a atividade das ferramentas durante a tarefa. Cada cartão mostra uma ação e seu resultado: leitura de arquivo, execução de comando ou resposta de um serviço conectado. No exemplo da compra, examine primeiro a falha do teste e compare-a com o resultado após a mudança no cálculo. Clique no cartão para expandir o comando e sua saída.

Quando o aplicativo pedir aprovação, examine a ação proposta antes de aprová-la ou negá-la. Responda às perguntas do agente na sessão e envie novas instruções se precisar mudar o rumo da tarefa.

O envio de mensagens durante uma execução segue **Ajustes → Compositor → Mensagem durante uma execução**. **Enfileirar** guarda a mensagem até a execução terminar. **Interromper** a entrega na próxima interação com o modelo, permitindo mudar a ação seguinte do agente. Para encerrar a execução ativa, escolha **Cancelar a execução**.

### Enfileire, redirecione ou pare

Use **Enfileirar** quando a mensagem depender do resultado atual, como um resumo após os testes. Use **Interromper** para mudar a próxima ação, por exemplo corrigindo um nome de arquivo ou reduzindo o escopo. A interrupção chega na próxima interação com o modelo; confira na linha do tempo o que já foi executado.

Cancelar para o turno ativo. Depois, confira as alterações da sessão para saber quais edições permaneceram e decidir como continuar. Cancelar não reverte arquivos pelo Git.

## Retome um trabalho anterior

Para retomar um trabalho, use **Buscar sessões** para localizar uma sessão pelo nome ou pelo texto da conversa. Selecione-a para reabrir a conversa e continuar no ambiente salvo. Use **Buscar nesta sessão** para encontrar um resultado em um histórico longo.

### Retome uma decisão

Fixe uma mensagem útil e abra **Fixados** para encontrá-la depois. Quando a opção de criar uma ramificação a partir da mensagem estiver disponível, use-a para explorar outra abordagem em uma conversa separada. Isso ramifica a discussão; use uma branch Git ou worktree se os arquivos também precisarem de isolamento.

**Reiniciar a partir desta mensagem** e a opção de editar e reiniciar substituem a conversa posterior. A confirmação pode oferecer restaurar arquivos alterados desde aquele ponto. Confira a lista: manter a transcrição, substituir mensagens e restaurar arquivos são operações diferentes.

<Frame caption="A busca encontra sessões anteriores para retomar a conversa e consultar seus resultados.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/sessions.jpg" alt="Resultados da busca de sessões do exemplo do carrinho" width={2720} height={1660} x={875} y={690} cropWidth={970} cropHeight={247} maxWidth="100%" />
</Frame>

## Entenda o uso de contexto

O indicador de contexto mostra quanto da janela de contexto do modelo está em uso. Quando **Compactar sessão** está disponível, a ação resume o histórico anterior para liberar espaço; a transcrição original permanece na sessão. Abra o indicador para examinar os detalhes. Os totais de solicitações e tokens do gateway aparecem separadamente em [Consumo](/pt/docs/mka1-code/troubleshooting).

## Use conversas junto com a programação

Mude para **Conversas** para discutir uma abordagem ou pedir explicações a um modelo. Use **Código** para trabalhar em um projeto selecionado com ferramentas de arquivos e comandos. Em Conversas, as respostas aparecem à medida que são geradas e o histórico fica armazenado localmente. Você pode renomear conversas, interromper uma resposta ou gerar novamente a última resposta.

Conversas e Código aceitam ditado. Grave sua solicitação pelo microfone ao lado do campo de mensagem e revise a transcrição antes de enviar.

Continue com [Planejamento e permissões](/pt/docs/mka1-code/permissions).