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

# Automação do navegador

> Teste uma aplicação web, acompanhe o navegador e assuma o controle quando necessário.

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>;

Use o aplicativo desktop para examinar uma página web em execução ou ler um documento gerado ao lado da conversa. O exemplo de checkout continua o [início rápido](/pt/docs/mka1-code/first-task).

## Use o navegador

Em uma sessão local de Código, peça ao agente para examinar sua aplicação web em execução ou uma página relevante para a tarefa. O navegador integrado permite ler a página, interagir com controles e conferir o resultado de uma alteração no código. Capturas de tela exigem um modelo que aceite imagens. Inicie o servidor de desenvolvimento do projeto ou peça ao agente para iniciá-lo e aprove o comando quando solicitado. Quando a página de checkout estiver disponível, peça:

> Abra a página local de checkout, defina a quantidade como três e verifique se três itens de US\$ 12 totalizam US\$ 36. Informe o total exibido.

A página oferece outra verificação da correção: a quantidade deve mostrar `3` e o total deve mostrar `US$ 36,00`. O teste unitário e o resultado visível verificam partes diferentes do fluxo.

As abas abertas pelo agente pertencem à sessão. Uma aba vinculada a outra sessão não pode ser anexada à sessão atual. Para disponibilizar uma aba que você abriu, escolha **Anexar aba atual** no painel do navegador. Ocultar o painel não interrompe as ações do navegador em segundo plano.

<Frame caption="O exemplo de checkout em localhost:7395, com três itens que totalizam US$ 36,00. Use a URL exibida pelo seu próprio servidor de desenvolvimento.">
  <ScreenshotCrop src="/images/mka1-code/guides/pt/previews.jpg" alt="Navegador integrado com o exemplo local de checkout, quantidade 3 e total de US$ 36,00" width={2320} height={1200} x={1284} y={0} cropWidth={1036} cropHeight={1108} maxWidth="100%" />
</Frame>

### Verifique um fluxo no navegador

Informe a URL mostrada pelo servidor de desenvolvimento e uma sequência com resultado observável:

> Abra a URL local de checkout indicada no terminal. Defina a quantidade como 1 e confira se o total é 12.00. Mude para 3 e confira se o total é 36.00. Informe diferenças e não envie nenhum pagamento.

Confira o valor do controle e o resultado exibido. Se a página não abrir, examine a saída do servidor e confirme que continua em execução. Um erro antes de carregar a página é diferente de um cálculo incorreto dentro dela.

Você também pode reproduzir problemas de navegação, comparar a validação de um formulário com os requisitos ou examinar uma página após mudar o layout. Declare o comportamento esperado para receber um resultado específico.

### Assuma o controle e retome

Abra **Navegador** no cabeçalho da sessão. **Assumir controle** pausa a automação para você navegar ou concluir uma etapa. Usar a barra de endereços ou redimensionar a página também pausa o agente. Depois, escolha **Retomar agente** e explique mudanças relevantes. Trocar a aba visível muda apenas sua visualização; não transfere o controle.

### Configurações e login do navegador

Em **Ajustes → Navegador**, escolha onde abrir links da web e de desenvolvimento local. O navegador integrado mantém cookies, dados de sites, cache e histórico próprios; entrar no navegador habitual não autentica você automaticamente aqui.

No macOS, **Importar…** pode copiar cookies de um perfil do Google Chrome. Feche o Chrome e confira o perfil escolhido. Use **Gerenciar** para buscar páginas no histórico. **Apagar dados de navegação** remove cookies, dados, cache e histórico após confirmação; pode ser necessário entrar novamente nos sites.

## Visualize documentos

Para PDFs, planilhas, apresentações e documentos de texto, consulte [Documentos e arquivos](/pt/docs/mka1-code/documents). Sessões locais permitem visualizar arquivos compatíveis ao lado da conversa, navegar por páginas ou planilhas e atualizar a prévia depois da edição.

Continue com [Revisão e commits](/pt/docs/mka1-code/review-changes).