DoubleX AgentesDocs

Referencia de la API › Recursos

Skills

Crea y mantén instrucciones reutilizables para adjuntar a cualquier agente.

El objeto Skill#

JSON
{
  "id": "skl_3e8f1a2b4c5d",
  "name": "Propuesta comercial",
  "description": "Arma propuestas comerciales con el formato de la empresa, con alcance, plazos y precio.",
  "instructions": "# Propuesta comercial\n\n1. Empieza por el problema del 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 las skills que puedes ver: { "skills": [Skill, ...] }. Para leer una skill, filtra la lista por id.

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

POST/api/skills#

CampoTipoDescripción
namestring, de 2 a 80Obligatorio.
descriptionstring, de 2 a 1024Obligatorio. Cuándo debe usar el agente la skill.
instructionsstring, de 2 a 30.000Obligatorio. Las instrucciones, en Markdown.
scopepersonal, team, organizationPredeterminado: personal.
teamIdstringEl equipo, cuando scope es team.
curl -X POST https://doublex.ai/api/skills \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Propuesta comercial",
    "description": "Arma propuestas comerciales con el formato de la empresa.",
    "instructions": "# Propuesta comercial\n\n1. Empieza por el problema del cliente…"
  }'

Respuesta 201: { "skill": Skill }.

PATCH/api/skills/{id}#

Cambia name, description e instructions (todos opcionales, con los mismos límites). Los agentes que usan la skill pasan a usar la versión nueva en el siguiente mensaje. Requiere permiso de edición; sin él, la respuesta es 404.

Respuesta: { "skill": Skill }.

DELETE/api/skills/{id}#

Borra la skill y la quita de los agentes que la usaban. Respuesta: { "ok": true }.

Paquetes de skills#

Las skills también admiten command (sin /), invocation (auto, manual, both), dependencyIds, files y actions. Las skills relacionadas son procedimientos cargados por el mismo agente; la delegación a subagentes sigue separada. El asistente general descubre las skills visibles y los agentes especializados usan las vinculadas y sus dependencias.

Los archivos nuevos usan { path, mediaType, encoding: "utf8" | "base64", content }. Las actualizaciones pueden conservar archivos propios mediante su metadata (path, mediaType, size, sha256). Límites: 100 archivos, 2 MB por archivo y 10 MB en total. Las referencias se guardan fuera del límite de instrucciones.

  • GET /api/skills/:id: metadata, instrucciones e índices de archivos y acciones.
  • GET /api/skills/:id/files?path=references/ejemplo.md: descarga autorizada.
  • GET /api/skills/:id/package: exporta .skill con SKILL.md, adjuntos y doublex.skill.json.

Las acciones tienen id, name, description, enabled y kind. Las de script añaden path y runtime (python, node, shell); las de conexión, connectorId y tool. Las acciones requieren una conexión activa, vinculada y disponible para quien ejecuta, respetando los bloqueos generales y del agente. Importar una skill no concede acceso a cuentas.

Los scripts reciben un objeto JSON por stdin y devuelven texto o JSON por stdout. Los archivos del paquete se montan en /skill, solo para lectura. La ejecución aislada no tiene red ni credenciales del servidor. Límites: entrada de 64 KB, memoria de 128 MB, medio núcleo de CPU, 32 procesos, 35 segundos y dos ejecuciones simultáneas. Python ofrece su biblioteca estándar y Node.js sus módulos nativos; no se instalan bibliotecas adicionales durante la ejecución.

En el chat, /comando pedido invoca la skill para la solicitud actual. Las herramientas listar_skills, usar_skill, ler_arquivo_skill, executar_acao_skill permiten descubrimiento y carga bajo demanda. Cada llamada verifica el acceso, se rechazan dependencias circulares y la conversación registra las skills, archivos y acciones usados. Las skills existentes siguen funcionando.