CLI › Comandos
Conversaciones
Conversa con agentes desde la terminal, continúa conversaciones, sigue lo que se está ejecutando y cancela.
Una conversación (en la CLI, session) es una secuencia de mensajes con un agente. Queda en el historial de la pantalla Tareas y se puede continuar desde la app, la CLI o la API.
doublex sessions list | create | send | get | cancel | deleteEmpezar una conversación#
doublex sessions create agt_8f3a2b1c9d0e --input "Lista los pedidos retrasados de esta semana"La respuesta aparece mientras el agente escribe. Las herramientas que usa aparecen en stderr con ›, y los avisos con !:
› Buscando en la base de conocimiento
› Creando archivo
Encontré 4 pedidos retrasados esta semana:
…
Conversación task_5d2c9a3e1f07. Continúa con: doublex sessions send task_5d2c9a3e1f07 --input "..."Para mensajes largos, lee de stdin:
doublex sessions create agt_8f3a2b1c9d0e --input - < pedido.md
git diff | doublex sessions create agt_2b7e4c6a1f3d --input -Continuar#
doublex sessions send task_5d2c9a3e1f07 --input "Envía un correo a cada cliente para avisarle del nuevo plazo"El agente recuerda todo lo que ya se dijo en la conversación. Envía solo el mensaje nuevo.
Salida en JSON (NDJSON)#
Con --json, create y send muestran cada evento de la respuesta en una línea, exactamente como lo envía la API:
doublex sessions create agt_8f3a2b1c9d0e --input "Hola" --json{"type":"task","taskId":"task_5d2c9a3e1f07"}
{"type":"text","delta":"¡Hola! "}
{"type":"text","delta":"¿En qué puedo ayudarte?"}
{"type":"done","status":"completed"}Para juntar solo el texto de la respuesta:
doublex sessions create agt_8f3a2b1c9d0e --input "Hola" --json | jq -rj 'select(.type == "text") | .delta'Listar#
doublex sessions list --agent agt_8f3a2b1c9d0e --status failed --limit 20| Opción | Para qué |
|---|---|
--agent <id> | Solo las conversaciones de un agente. |
--status processing|completed|failed | Filtra por estado. |
--limit <n> | Cuántas mostrar (predeterminado: 50, de las más nuevas a las más antiguas). |
La tabla muestra el ID, el agente, el título, el estado, el origen (chat, trigger, webhook o subagent) y la última actualización.
Ver#
doublex sessions get task_5d2c9a3e1f07Muestra el título, el estado y los últimos 10 mensajes. Con --json, trae la conversación completa (incluidas las herramientas usadas) y el campo running, que indica si el agente todavía está trabajando.
Interrumpir y cancelar#
- Ctrl+C durante la respuesta interrumpe la lectura y cancela la conversación en el servidor. El código de salida es
130. - Si solo dejas de leer (por ejemplo, al cerrar la terminal), el agente sigue en el servidor y guarda el resultado. Cancélalo así:
doublex sessions cancel task_5d2c9a3e1f07Una conversación cancelada queda como Falló, con el aviso de que se interrumpió. Lo que ya se procesó se cobra.
Borrar#
doublex sessions delete task_5d2c9a3e1f07 --yesCuando la respuesta falla#
El comando termina con código 1 cuando la respuesta tiene un evento error o termina con done en failed: créditos agotados, modelo no disponible, conector que hay que volver a conectar. El mensaje aparece en stderr con ✗.
Una conversación solo responde un mensaje a la vez. Si envías otro mientras el agente todavía trabaja, recibes el aviso de que la conversación está en curso.