---
id: "terminal-sessoes-de-agente"
titulo: "Trabalhar com um agente no Terminal"
resumo: "Como criar uma sessão de agente, esperar ela ficar pronta, trocar o agente sem fechar a sessão e o que os gestos de bifurcar e copiar contexto fazem."
idioma: "pt-br"
tipo: "guia"
categoria: "telas"
aplicavelDesde: "0.0.16"
capabilities: ["terminal.agent.fork-context", "terminal.sessions.create", "terminal.input.send"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/terminal/sessoes-de-agente/"
fonte: "pt-br/ferramentas/terminal/sessoes-de-agente.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/terminal/sessoes-de-agente.md"
hashFonte: "sha256:fe49242b30c3140f799babfbdc97ce266504a73ad24e82271415c30dcedaa619"
hashDestaPagina: "sha256:fe49242b30c3140f799babfbdc97ce266504a73ad24e82271415c30dcedaa619"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
Uma CLI de agente no Terminal é uma sessão como qualquer outra — com uma diferença importante: **a interface do agente leva um tempo para assumir o painel**. Quase todo problema de "meu texto chegou errado" vem daí.

## Criar a sessão já com o agente

Prefira criar a sessão **com o agente** em vez de abrir um shell e digitar o comando: assim a sessão nasce com o processo certo, sem uma janela em que um shell está no controle.

No momento em que a criação termina, o agente **ainda está subindo**. O que isso implica:

- Escrever agora faz o texto cair no shell, e a interface do agente assume depois — a mensagem chega embaralhada.
- O painel pode parecer pronto antes de estar.
- Sessões criadas a partir de um cartão do Canvas podem demorar alguns segundos até aparecer na listagem.

## Sequência segura para mandar a primeira mensagem

1. **Criar** a sessão com o agente.
2. **Esperar** a interface do agente ficar ociosa.
3. **Ler** o que está na tela — é o que confirma que a interface assumiu.
4. **Enviar** o texto e pedir o Enter.
5. **Esperar** de novo antes de ler o resultado.
6. **Ler só o que é novo**, a partir do cursor da leitura anterior.

O contrato de leitura, envio e espera está em [Ler, enviar e esperar](/docs/pt-br/ferramentas/terminal/ler-enviar-e-esperar/).

## Trocar o agente sem fechar a sessão

Quando o agente precisa mudar — trocar de provedor, retomar uma tarefa com outro modelo —, existe uma operação que **substitui o processo mantendo a sessão**:

- O identificador da sessão continua válido.
- O cartão no Canvas, a posição, as ligações e o título sobrevivem.
- **O estado em memória do agente anterior não é preservado.**
- Automações que reusavam exatamente aquela sessão caem para uma sessão nova.

## Bifurcar sessão e copiar contexto — recurso limitado

O menu de contexto do painel oferece dois gestos para sessões de agente:

- **Bifurcar a sessão do agente** — pede uma bifurcação da sessão atual, para continuar o trabalho em outro ramo sem abandonar o que existe.
- **Copiar contexto** — copia o contexto associado ao painel.

> **Recurso limitado.** A disponibilidade e o efeito dos dois gestos dependem do tipo de sessão do agente: o menu sempre mostra os itens, mas o que eles entregam varia conforme a sessão.
>
> **Copiar contexto pode incluir dado sensível.** O conteúdo copiado é o contexto da sessão; antes de colar em outro lugar, saiba o que está indo junto.

## O que pertence a outras telas

- O **alternador entre conversa nativa e terminal** é assunto da tela Conversa, não desta página: a tela Terminal mostra terminal.
- **Aviso de entrada bloqueada em workspace remoto** pertence à superfície de ambientes remotos.
- **Sobreposição de controle por celular** pertence à superfície de dispositivos.

## Relacionados

- [Criar e navegar entre sessões](/docs/pt-br/ferramentas/terminal/criar-e-navegar-sessoes/)
- [Referência de comandos do Terminal](/docs/pt-br/ferramentas/terminal/referencia-cli/)