DoubleX AgentesDocs

CLI › Comandos

Agentes

Liste, inspecione, crie, edite e apague agentes pelo terminal.

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

Listar#

Terminal
doublex agents list
doublex agents list --mine --search vendas --limit 10
OpçãoPara quê
--search <texto>Filtra pelo nome e pela descrição.
--mineSó os seus agentes e os compartilhados com você. Para administradores, sem essa opção a lista traz todos os agentes da organização.
--limit <n>Mostra só os n primeiros.
--jsonDevolve { "agents": [...] } com todos os campos.

A tabela mostra o ID, o nome, o modelo (provedor/modelo), o escopo, o número de conversas e se você pode editar.

Ver um agente#

Terminal
doublex agents get agt_8f3a2b1c9d0e

Mostra o modelo, o esforço de raciocínio, o escopo, a descrição, quantas skills, conectores, documentos do Brain e subagentes ele usa, e as instruções completas. Com --json, devolve também as conversas recentes e os gatilhos do agente.

Criar#

Terminal
doublex agents create \
  --name "Analista de CRM" \
  --description "Responde perguntas sobre o funil de vendas" \
  --instructions-file instrucoes.md \
  --emoji 📊 \
  --model anthropic/claude-sonnet-5-5 \
  --effort high

A CLI mostra o ID do agente criado. O agente nasce no escopo Pessoal; para compartilhar com um time ou com a organização, use a tela do agente.

OpçãoPara quê
--name <nome>Obrigatória. Até 60 caracteres.
--description <texto>Até 300 caracteres.
--instructions <texto>As instruções do agente (até 20.000 caracteres). Use - para ler do stdin.
--instructions-file <arquivo>Lê as instruções de um arquivo.
--emoji <emoji>Emoji do agente.
--model <provedor/modelo>Modelo. Use um ID de doublex models list, ou auto para o DoubleX Auto, que escolhe o modelo a cada mensagem. Sem ela, o agente usa o modelo padrão da organização.
--effort low|medium|highEsforço de raciocínio. O padrão é medium.
--args-json <json> / --args-file <arquivo>Outros campos do corpo de criação, em JSON (por exemplo, color e avatar). As opções acima têm prioridade.

Para criar a partir de um template pronto, mande a chave do template em --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

Aceita --name, --description, --instructions, --instructions-file, --model, --effort e --args-json/--args-file. Só o que você passa é alterado.

Com --args-json você altera qualquer campo da API de agentes, por exemplo as skills, os conectores e os documentos do Brain que o agente usa:

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

Você só edita agentes em que tem permissão de edição (coluna EDITA da lista).

Apagar#

Terminal
doublex agents delete agt_8f3a2b1c9d0e --yes

Sem --yes, a CLI só avisa o que seria apagado. Apagar um agente remove também as conversas, os gatilhos e os arquivos do computador dele.