Trabalhar com um agente no Terminal
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.
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
- Criar a sessão com o agente.
- Esperar a interface do agente ficar ociosa.
- Ler o que está na tela — é o que confirma que a interface assumiu.
- Enviar o texto e pedir o Enter.
- Esperar de novo antes de ler o resultado.
- 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.
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.