DoubleX AgentesDocs

Referência da API › Recursos

Skills

Crie e mantenha instruções reutilizáveis para anexar a qualquer agente.

O objeto Skill#

JSON
{
  "id": "skl_3e8f1a2b4c5d",
  "name": "Proposta comercial",
  "description": "Monta propostas comerciais no padrão da empresa, com escopo, prazos e preço.",
  "instructions": "# Proposta comercial\n\n1. Comece pelo problema do cliente…",
  "scope": "team",
  "teamId": "team_9c8b7a6d5e4f",
  "ownerId": "usr_1a2b3c4d5e6f",
  "canEdit": true,
  "usedBy": [{ "id": "agt_8f3a2b1c9d0e", "name": "Analista de CRM" }],
  "createdAt": "2026-10-23T09:00:00.000Z",
  "updatedAt": "2026-10-26T17:45:00.000Z"
}

GET/api/skills#

Lista as skills que você pode ver: { "skills": [Skill, ...] }. Para ler uma skill, filtre a lista pelo id.

curl https://doublex.ai/api/skills -H "Authorization: Bearer $DOUBLEX_API_KEY"

POST/api/skills#

CampoTipoDescrição
namestring, 2 a 80Obrigatório.
descriptionstring, 2 a 1024Obrigatório. Quando o agente deve usar a skill.
instructionsstring, 2 a 30.000Obrigatório. As instruções, em Markdown.
scopepersonal, team, organizationPadrão personal.
teamIdstringO time, quando scope é team.
curl -X POST https://doublex.ai/api/skills \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Proposta comercial",
    "description": "Monta propostas comerciais no padrão da empresa.",
    "instructions": "# Proposta comercial\n\n1. Comece pelo problema do cliente…"
  }'

Resposta 201: { "skill": Skill }.

PATCH/api/skills/{id}#

Altera name, description e instructions (todos opcionais, com os mesmos limites). Os agentes que usam a skill passam a usar a versão nova na próxima mensagem. Exige permissão de edição; sem ela, a resposta é 404.

Resposta: { "skill": Skill }.

DELETE/api/skills/{id}#

Apaga a skill e a tira dos agentes que a usavam. Resposta: { "ok": true }.

Pacotes de skills#

Além de nome, descrição e instruções, uma skill pode ter command (sem /), invocation (auto, manual ou both), dependencyIds, files e actions. Skills relacionadas são procedimentos carregados pelo mesmo agente; a delegação para subagentes continua separada. No assistente geral, as skills visíveis podem ser descobertas automaticamente; agentes especializados usam as anexadas e suas dependências.

Arquivos novos usam { path, mediaType, encoding: "utf8" | "base64", content }. Para manter um arquivo numa atualização, envie sua metadata (path, mediaType, size, sha256), que só pode referenciar arquivos já pertencentes à própria skill. Limites: 100 arquivos, 2 MB por arquivo, 10 MB por pacote; referências não consomem o limite das instruções.

  • GET /api/skills/:id: lê a skill e os índices de arquivos e ações.
  • GET /api/skills/:id/files?path=references/exemplo.md: baixa um arquivo autorizado.
  • GET /api/skills/:id/package: exporta .skill com SKILL.md, anexos e manifesto doublex.skill.json.

Ações têm id, name, description, enabled e kind. Com kind: "script", informe path e runtime (python, node ou shell). Com kind: "connector", informe connectorId e tool. A ação de conexão precisa estar disponível no agente e para quem executa, respeitando também os bloqueios gerais e por agente. Importar uma skill não concede acesso a contas.

Scripts recebem um objeto JSON na entrada padrão e devolvem texto ou JSON pela saída padrão. O pacote fica disponível em /skill, somente para leitura. A execução isolada não tem rede nem credenciais do servidor; aceita até 64 KB de entrada, limita memória a 128 MB, CPU a meio núcleo, processos a 32 e tempo a 35 segundos. Python oferece a biblioteca padrão e Node.js, seus módulos nativos; bibliotecas adicionais não são instaladas durante a execução. Há no máximo duas execuções simultâneas no servidor.

No chat, /comando pedido chama a skill para o pedido atual. As ferramentas listar_skills, usar_skill, ler_arquivo_skill e executar_acao_skill permitem descoberta e leitura sob demanda. Cada chamada revalida acesso; dependências em círculo são rejeitadas. A conversa registra as skills, arquivos e ações usados. Skills antigas continuam funcionando.