DoubleX AgentesDocs

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.

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

Empezar una conversación#

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

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

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

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

Listar#

Terminal
doublex sessions list --agent agt_8f3a2b1c9d0e --status failed --limit 20
OpciónPara qué
--agent <id>Solo las conversaciones de un agente.
--status processing|completed|failedFiltra 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#

Terminal
doublex sessions get task_5d2c9a3e1f07

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

Una conversación cancelada queda como Falló, con el aviso de que se interrumpió. Lo que ya se procesó se cobra.

Borrar#

Terminal
doublex sessions delete task_5d2c9a3e1f07 --yes

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