CLI › Comandos
Conversas
Converse com agentes pelo terminal, continue conversas, acompanhe o que está rodando e cancele.
Uma conversa (na CLI, session) é uma sequência de mensagens com um agente. Ela fica no histórico da tela Tarefas e pode ser continuada pelo app, pela CLI ou pela API.
doublex sessions list | create | send | get | cancel | deleteComeçar uma conversa#
doublex sessions create agt_8f3a2b1c9d0e --input "Liste os pedidos atrasados desta semana"A resposta aparece enquanto o agente escreve. As ferramentas que ele usa aparecem no stderr com ›, e avisos com !:
› Buscando na base de conhecimento
› Criando arquivo
Encontrei 4 pedidos atrasados nesta semana:
…
Conversa task_5d2c9a3e1f07. Continue com: doublex sessions send task_5d2c9a3e1f07 --input "..."Para mensagens longas, leia do stdin:
doublex sessions create agt_8f3a2b1c9d0e --input - < pedido.md
git diff | doublex sessions create agt_2b7e4c6a1f3d --input -Continuar#
doublex sessions send task_5d2c9a3e1f07 --input "Mande um e-mail para cada cliente avisando o novo prazo"O agente lembra de tudo o que já foi dito na conversa. Mande só a mensagem nova.
Saída em JSON (NDJSON)#
Com --json, create e send mostram cada evento da resposta numa linha, exatamente como a API envia:
doublex sessions create agt_8f3a2b1c9d0e --input "Oi" --json{"type":"task","taskId":"task_5d2c9a3e1f07"}
{"type":"text","delta":"Olá! "}
{"type":"text","delta":"Como posso ajudar?"}
{"type":"done","status":"completed"}Para juntar só o texto da resposta:
doublex sessions create agt_8f3a2b1c9d0e --input "Oi" --json | jq -rj 'select(.type == "text") | .delta'Listar#
doublex sessions list --agent agt_8f3a2b1c9d0e --status failed --limit 20| Opção | Para quê |
|---|---|
--agent <id> | Só as conversas de um agente. |
--status processing|completed|failed | Filtra pela situação. |
--limit <n> | Quantas mostrar (padrão 50, das mais novas para as mais antigas). |
A tabela mostra o ID, o agente, o título, a situação, a origem (chat, trigger, webhook ou subagent) e a última atualização.
Ver#
doublex sessions get task_5d2c9a3e1f07Mostra o título, a situação e as últimas 10 mensagens. Com --json, traz a conversa inteira (inclusive as ferramentas usadas) e o campo running, que diz se o agente ainda está trabalhando.
Interromper e cancelar#
- Ctrl+C durante a resposta interrompe a leitura e cancela a conversa no servidor. O código de saída é
130. - Se você só parar de ler (por exemplo, fechando o terminal), o agente continua no servidor e salva o resultado. Cancele assim:
doublex sessions cancel task_5d2c9a3e1f07Uma conversa cancelada fica como Falhou, com o aviso de que foi interrompida. O que já foi processado é cobrado.
Apagar#
doublex sessions delete task_5d2c9a3e1f07 --yesQuando a resposta falha#
O comando termina com código 1 quando a resposta tem um evento error ou termina com done em failed: créditos esgotados, modelo indisponível, conector que precisa ser reconectado. A mensagem aparece no stderr com ✗.
Uma conversa só responde uma mensagem por vez. Se você mandar outra enquanto o agente ainda trabalha, recebe o aviso de que a conversa está em andamento.