DoubleX AgentesDocs

CLI › Comandos

Agentes

Lista, inspecciona, crea, edita y borra agentes desde la terminal.

Terminal
doublex agents list | get | create | update | delete

Listar#

Terminal
doublex agents list
doublex agents list --mine --search ventas --limit 10
OpciónPara qué
--search <texto>Filtra por nombre y descripción.
--mineSolo tus agentes y los compartidos contigo. Para los administradores, sin esta opción la lista trae todos los agentes de la organización.
--limit <n>Muestra solo los primeros n.
--jsonDevuelve { "agents": [...] } con todos los campos.

La tabla muestra el ID, el nombre, el modelo (proveedor/modelo), el alcance, el número de conversaciones y si puedes editarlo.

Ver un agente#

Terminal
doublex agents get agt_8f3a2b1c9d0e

Muestra el modelo, el esfuerzo de razonamiento, el alcance, la descripción, cuántas skills, conectores, documentos del Brain y subagentes usa, y las instrucciones completas. Con --json, también devuelve las conversaciones recientes y los disparadores del agente.

Crear#

Terminal
doublex agents create \
  --name "Analista de CRM" \
  --description "Responde preguntas sobre el embudo de ventas" \
  --instructions-file instrucoes.md \
  --emoji 📊 \
  --model anthropic/claude-sonnet-5-5 \
  --effort high

La CLI muestra el ID del agente creado. El agente se crea en el alcance Personal; para compartirlo con un equipo o con la organización, usa la pantalla del agente.

OpciónPara qué
--name <nombre>Obligatoria. Hasta 60 caracteres.
--description <texto>Hasta 300 caracteres.
--instructions <texto>Las instrucciones del agente (hasta 20.000 caracteres). Usa - para leer de stdin.
--instructions-file <archivo>Lee las instrucciones de un archivo.
--emoji <emoji>Emoji del agente.
--model <proveedor/modelo>Modelo. Usa un ID de doublex models list, o auto para DoubleX Auto, que elige el modelo en cada mensaje. Sin ella, el agente usa el modelo predeterminado de la organización.
--effort low|medium|highEsfuerzo de razonamiento. El predeterminado es medium.
--args-json <json> / --args-file <archivo>Otros campos del cuerpo de creación, en JSON (por ejemplo, color y avatar). Las opciones de arriba tienen prioridad.

Para crear a partir de una plantilla, envía la clave de la plantilla en --args-json:

Terminal
doublex agents create --args-json '{"templateKey": "briefing-diario"}'

Editar#

Terminal
doublex agents update agt_8f3a2b1c9d0e --model auto --effort low
doublex agents update agt_8f3a2b1c9d0e --instructions-file instrucoes.md

Acepta --name, --description, --instructions, --instructions-file, --model, --effort y --args-json/--args-file. Solo cambia lo que pasas.

Con --args-json cambias cualquier campo de la API de agentes, por ejemplo las skills, los conectores y los documentos del Brain que usa el agente:

Terminal
doublex agents update agt_8f3a2b1c9d0e --args-json '{
  "skillIds": ["skl_3e8f1a2b4c5d"],
  "connectorIds": ["con_7a9b1c3d5e2f"],
  "knowledgeIds": ["kno_2c4e6a8b0d1f"]
}'

Solo editas agentes en los que tienes permiso de edición (columna EDITA de la lista).

Borrar#

Terminal
doublex agents delete agt_8f3a2b1c9d0e --yes

Sin --yes, la CLI solo avisa qué se borraría. Borrar un agente también elimina las conversaciones, los disparadores y los archivos de su computadora.