DoubleX AgentesDocs

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.

Terminal
doublex sessions list | create | send | get | cancel | delete

Começar uma conversa#

Terminal
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:

Terminal
doublex sessions create agt_8f3a2b1c9d0e --input - < pedido.md
git diff | doublex sessions create agt_2b7e4c6a1f3d --input -

Continuar#

Terminal
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:

Terminal
doublex sessions create agt_8f3a2b1c9d0e --input "Oi" --json
NDJSON
{"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:

Terminal
doublex sessions create agt_8f3a2b1c9d0e --input "Oi" --json | jq -rj 'select(.type == "text") | .delta'

Listar#

Terminal
doublex sessions list --agent agt_8f3a2b1c9d0e --status failed --limit 20
OpçãoPara quê
--agent <id>Só as conversas de um agente.
--status processing|completed|failedFiltra 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#

Terminal
doublex sessions get task_5d2c9a3e1f07

Mostra 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:
Terminal
doublex sessions cancel task_5d2c9a3e1f07

Uma conversa cancelada fica como Falhou, com o aviso de que foi interrompida. O que já foi processado é cobrado.

Apagar#

Terminal
doublex sessions delete task_5d2c9a3e1f07 --yes

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