CLI › Comandos
Agentes
Liste, inspecione, crie, edite e apague agentes pelo terminal.
doublex agents list | get | create | update | deleteListar#
doublex agents list
doublex agents list --mine --search vendas --limit 10| Opção | Para quê |
|---|---|
--search <texto> | Filtra pelo nome e pela descrição. |
--mine | Só 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. |
--json | Devolve { "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#
doublex agents get agt_8f3a2b1c9d0eMostra 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#
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 highA 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ção | Para 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|high | Esforç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:
doublex agents create --args-json '{"templateKey": "briefing-diario"}'Editar#
doublex agents update agt_8f3a2b1c9d0e --model auto --effort low
doublex agents update agt_8f3a2b1c9d0e --instructions-file instrucoes.mdAceita --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:
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#
doublex agents delete agt_8f3a2b1c9d0e --yesSem --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.