Referência da API › Recursos
Skills
Crie e mantenha instruções reutilizáveis para anexar a qualquer agente.
O objeto Skill#
{
"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#
| Campo | Tipo | Descrição |
|---|---|---|
name | string, 2 a 80 | Obrigatório. |
description | string, 2 a 1024 | Obrigatório. Quando o agente deve usar a skill. |
instructions | string, 2 a 30.000 | Obrigatório. As instruções, em Markdown. |
scope | personal, team, organization | Padrão personal. |
teamId | string | O 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.skillcomSKILL.md, anexos e manifestodoublex.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.