Visão de Conversa

A visão de conversa mostra uma sessão de agente como um chat: mensagens, cartões de ferramentas e solicitações de permissão que você responde com botões. Este capítulo trata da alternância entre a visão de terminal e a visão de conversa, do envio de mensagens enquanto o agente trabalha, dos controles abaixo da caixa de mensagem, da reversão, das tarefas em segundo plano, dos limites de uso e da leitura de conversas longas.

1. O que é a visão de conversa

Toda sessão de agente pode ser executada na Visão de terminal, em que o agente mostra a própria interface de terminal. Cinco agentes também podem ser executados na Visão de conversa: Claude Code, Codex, OpenCode, Pi e OMP. Os outros tipos de agente sempre usam a visão de terminal.

Na visão de conversa, o próprio VelaTerm exibe a conversa: suas mensagens, as respostas e o raciocínio do agente, um cartão para cada chamada de ferramenta e cartões para solicitações de permissão e perguntas. Você pode mudar o modelo, o esforço de raciocínio e o modo de permissões pelos controles abaixo da caixa de mensagem, sem reiniciar a sessão.

As duas visões dão continuidade à mesma conversa. Uma sessão pode passar de uma visão para a outra, e o histórico é mantido.

2. Como escolher a visão

Visão padrão por agente. Configurações ▸ Agentes ▸ "Visão padrão" define em qual visão as novas sessões desse agente são abertas. As opções são "Visão de conversa" e "Visão de terminal"; o padrão é "Visão de conversa" para os cinco agentes. As sessões existentes mantêm a visão com que foram criadas.

Por sessão. A caixa de diálogo "Novo com argumentos…" tem a opção "Abre em", para que uma única sessão comece na outra visão.

Como trocar a visão de uma sessão existente. O cabeçalho do painel tem um botão de alternância:

• Na visão de terminal, o botão de robô ("Visão de conversa") leva a sessão para a visão de conversa.
• Na visão de conversa, o botão de terminal ("Visão de terminal") faz a sessão voltar. Uma dica curta aponta para esse botão até você fechar a dica ou usar o botão.

Se o agente estiver trabalhando, o VelaTerm pergunta antes: "Trocar de visão reinicia o agente. O turno em andamento será interrompido. A conversa é preservada." Escolha "Trocar" para continuar. Uma sessão ociosa troca de visão imediatamente.

3. Envio de mensagens

A caixa de mensagem exibe "Escreva para o agente, ou use /comandos, /habilidades e @arquivos". Enter envia; Shift+Enter adiciona uma linha. Com o cursor no início ou no fim do texto, ↑ e ↓ trazem de volta as mensagens que você já enviou nesta conversa.

Uma conversa nova mostra "Escreva no campo abaixo para iniciar a conversa." O processo do agente é iniciado quando você envia a primeira mensagem.

Enquanto o agente trabalha

Durante um turno, a caixa de mensagem exibe "Digite uma mensagem; ela será enviada quando este turno terminar". Há três formas de enviar:

A adição de instruções funciona com os cinco agentes. Quando nenhum turno está em andamento, essas combinações de teclas simplesmente enviam a mensagem.

As mensagens enfileiradas aparecem em "Mensagens pendentes". Clique em uma mensagem para editá-la, use o botão "Adicionar instrução" dela para incluí-la no turno em andamento ou remova-a com ×. As mensagens enfileiradas são enviadas em ordem, à medida que os turnos terminam.

Para parar o turno em andamento, pressione Esc ou clique no botão de parar, que substitui o botão de enviar enquanto a caixa de mensagem está vazia ("Parar · Esc"). A conversa mostra "Parando o turno atual…" e depois "Turno atual interrompido".

4. Controles abaixo da caixa de mensagem

A linha abaixo da caixa de mensagem reúne os controles que valem para a próxima mensagem. Os controles exibidos dependem do agente e do modelo:

Os menus Modelo, Esforço de raciocínio e Modo de permissões oferecem "Definir como padrão", que torna a escolha atual o padrão para as novas conversas desse agente. O esforço padrão fica vinculado ao modelo para o qual foi escolhido.

Configurações ▸ Visualização da conversa ▸ "Barra de ferramentas de mensagens" define quais controles ficam ao lado da caixa de mensagem e em que ordem. Modelo, Esforço de raciocínio, Modo de colaboração e Modo de permissões vêm ativados por padrão. Os controles desativados, ou que não cabem na linha, vão para o menu Mais, de modo que todos os controles compatíveis continuam acessíveis. Servidores MCP e Tarefas em segundo plano ficam desabilitados enquanto o processo do agente não está em execução ("O processo do agente não está em execução. Envie uma mensagem para iniciá-lo.").

As conversas do Claude e do Codex também mostram um pequeno medidor de contexto ao lado do botão de enviar assim que o agente informa os primeiros números. A cor do medidor muda à medida que o contexto se enche ou que um limite de uso se aproxima. Passe o cursor sobre ele para ver o uso do contexto ("Contexto: … de … tokens"), o custo da sessão, quando o agente o informa, e os avisos de limite de uso.

Modos de permissão

Uma alteração em uma sessão do Codex vale a partir do próximo turno, e o menu indica isso. Mudar uma sessão do Claude em execução para "Sem perguntar" exige reiniciá-la; o VelaTerm pergunta "Reiniciar para ignorar as confirmações?" e mantém o histórico da conversa. "Sem perguntar" e "Acesso total" ignoram todas as confirmações, então use essas opções com cuidado.

5. Como responder ao agente

Quando o agente precisa de você, um cartão aparece no fim da conversa e o ponto de status da sessão fica amarelo:

• Solicitação de permissão: "<tool> quer ser executado", com "Permitir" e "Negar". Algumas solicitações também oferecem regras permanentes, como "Permitir … nesta sessão" ou "Permitir … sempre".
• Pergunta: "O agente tem uma pergunta". Escolha ou digite uma resposta e depois clique em "Próxima" ou "Enviar"; "Dispensar" deixa a pergunta sem resposta.
• Aprovação de plano: "Plano aguardando aprovação", com "Aprovar e executar" e "Rejeitar".
• Solicitação de servidor MCP: "<server> solicita informações", com "Enviar", "Recusar" e "Cancelar".

6. Imagens

Cole ou arraste imagens para a caixa de mensagem. Uma mensagem pode levar até 4 imagens de até 5 MB cada; quando uma imagem fica de fora, a caixa de mensagem informa o motivo. As miniaturas aparecem acima do texto, cada uma com um botão para removê-la. Uma imagem pode ser enviada sozinha, sem texto. Clique com o botão direito em uma imagem da conversa para escolher "Ver imagem original", "Copiar imagem" ou "Salvar imagem".

7. Comandos e preenchimento automático

Digite / para listar os comandos e @ para inserir o caminho de um arquivo. Tab ou Enter insere a sugestão destacada; Esc fecha a lista. No Claude e no Codex, a lista inclui os comandos e as habilidades do próprio agente.

O próprio VelaTerm trata estes comandos:

8. Reversão e edição

Suas mensagens têm o botão "Voltar para este ponto". O que ele pode restaurar depende do agente:

A reversão remove a mensagem escolhida e tudo o que vem depois dela. Ela só está disponível enquanto o processo do agente está em execução e ocioso, sem mensagens enfileiradas nem solicitações de permissão abertas. A restauração de arquivos mostra quantos arquivos serão alterados antes da sua confirmação. A reversão não pode ser desfeita.

Nas conversas do Claude e do Codex, suas mensagens também têm o botão "Editar". Altere o texto ou as imagens, escolha "Revisar e reenviar" e confirme com "Excluir e reenviar". A mensagem original e tudo o que vem depois dela são excluídos permanentemente, e a mensagem editada é enviada a partir desse ponto. As alterações de arquivo não são restauradas.

9. Tarefas em segundo plano (Claude)

O Claude pode executar subagentes e comandos em segundo plano. O controle Tarefas em segundo plano lista essas tarefas com o estado de cada uma ("Em execução", "Concluída", "Falhou", "Interrompida"). Use "Parar" para encerrar uma tarefa ou abra-a em uma aba própria para ver o tempo decorrido, a contagem de tokens, as chamadas de ferramenta, o prompt e o resultado. Durante um turno, "Mover o trabalho em andamento para o segundo plano" envia o trabalho atual para o segundo plano, para que você possa continuar a conversa.

Enquanto houver tarefas em segundo plano em execução, a sessão mantém o status "Em andamento".

10. Limites de uso e continuação automática

Quando uma conversa do Claude ou do Codex para porque o limite de uso de cinco horas ou o semanal foi atingido, o VelaTerm continua a tarefa assim que o limite for redefinido. Esse recurso vem ativado por padrão; para desativá-lo, desligue Configurações ▸ Comportamento ▸ "Continuar após a redefinição".

Com essa configuração ativada, a conversa mostra quando vai continuar, por exemplo "Limite de uso de 5 horas atingido. Retomada automática da tarefa: 14:30.", com um botão "Cancelar". A espera é mantida mesmo que o aplicativo seja reiniciado. Ela termina sem enviar nada quando você mesmo envia uma mensagem, reverte a conversa, cancela a espera, desativa a configuração, arquiva ou exclui a sessão ou leva a sessão para a visão de terminal. Se o horário de redefinição for desconhecido, ou se o limite for atingido de novo após a continuação, a conversa informa isso e não continua sozinha.

11. Leitura de conversas longas

• A parte mais recente da conversa é carregada primeiro. Role para cima ou escolha "Carregar mensagens anteriores" para ler o que veio antes.
• Chamadas de ferramenta consecutivas são agrupadas em uma linha ("N chamadas de ferramenta"); clique nela para ver cada chamada.
• Cada resposta pode ocultar suas etapas intermediárias ("Ocultar passos" / "Mostrar N passos"). O cabeçalho do painel tem "Ocultar todos os passos" / "Mostrar todos os passos".
• O botão "Buscar…" no cabeçalho do painel, ou o atalho de busca no terminal (⌘F / Ctrl+Alt+F), pesquisa a conversa.
• Depois de rolar para cima, "Voltar para a mensagem mais recente" leva de volta ao fim da conversa.
• Suas próprias mensagens têm um botão de copiar. O texto de qualquer mensagem pode ser selecionado e copiado.

As conversas arquivadas abrem somente para leitura na base de conhecimento; consulte Gerenciamento de Interface e Sessões §8.

12. Entrar e sair da conta (Claude e Codex)

O controle Conta ("Conta do Claude" ou "Conta do Codex") vem desativado na barra de ferramentas por padrão. Abra-o pelo menu Mais ou ative-o em Configurações ▸ Visualização da conversa ▸ "Barra de ferramentas de mensagens". Ele oferece "Entrar novamente" e "Sair". As mudanças de conta aguardam o fim do turno atual; o Claude também aguarda a conclusão das tarefas em segundo plano e das solicitações de permissão.

Codex. Quando uma solicitação do Codex informa que o login não é mais válido, a conversa oferece "Entrar novamente". Abra a página de autorização e insira o código mostrado na conversa. A visão é atualizada quando o login é concluído, e você pode continuar a mesma conversa. O login por código de dispositivo precisa estar ativado na sua conta ou no seu espaço de trabalho do ChatGPT, e a sua CLI do Codex precisa oferecer suporte a ele. "Cancelar" interrompe um login pendente.

Claude. "Entrar novamente" mostra um link de autorização. Faça login nessa página, cole o código completo exibido nela (incluindo a parte depois de #) em "Código de autorização" e escolha "Enviar código". O código não é enviado como mensagem do chat. Isso exige uma versão da CLI do Claude com suporte à autorização de conta.

Sair pede confirmação. Essa ação apaga as credenciais da conta no computador conectado, o que afeta outras sessões que usam as mesmas credenciais. O histórico das conversas é mantido. Depois de sair, a conversa oferece "Entrar" para continuar. Sair do Claude não altera as chaves de API configuradas.

13. Comandos de shell com !

Digite ! seguido de um comando, por exemplo ! az login --tenant <id>, para executar o comando no shell da sessão em vez de enviá-lo ao agente. Isso funciona com os cinco agentes.

• O comando é executado no diretório de trabalho do agente, com o ambiente do agente. O texto depois de ! é passado ao shell exatamente como foi digitado.
• Uma linha "Comando de shell" mostra o comando, a saída dele em tempo real e um botão "Cancelar". Quando o comando termina, a linha mostra o código de saída ou "Cancelado". Em saídas longas, apenas a parte final é mantida, e a linha informa isso.
• Depois que o comando termina, o agente recebe o comando e a saída dele e pode reagir.
• Cada conversa executa um comando de shell por vez. Os comandos de shell não podem incluir imagens e não aceitam entrada interativa. Não há limite de tempo, então um comando que aguarda um login no navegador continua em execução até terminar ou até você cancelá-lo.

14. Quando o processo do agente para

• Fechar a aba da conversa libera o processo do agente: um agente ocioso para imediatamente, e um agente que está trabalhando para depois do turno atual. A próxima mensagem que você enviar inicia o agente de novo e dá continuidade à mesma conversa.
• "Encerrar processo", no menu de contexto da sessão, encerra um agente em execução após a confirmação. O histórico da conversa é mantido.
• Se o agente encerrar por conta própria, a conversa mostra "O agente parou (código N)".
• Se o agente não estiver instalado, o painel mostra "<Agent> não está instalado" com "Instalar agora", "Documentação" e "Faço eu mesmo". "Instalar agora" leva a sessão para a visão de terminal e executa a instalação ali; consulte Sessões do Agente de IA §7.