Crear Skill privado de Agent

Mediante esta interfaz, se puede crear un Skill privado del LoopAgent al que pertenece la Agent API Key actual.

Solo se admite LoopAgent; los Agent normales, los Flow Agent y los Workflow no son compatibles.
Solo crea el Skill privado del Agent al que pertenece la Agent API Key actual.
Solo se aceptan .skill y .zip; el paquete comprimido tiene un tamaño máximo de 20 MiB, hasta 200 archivos válidos, un máximo de 5 MiB por archivo descomprimido y un máximo de 64 MiB para el paquete completo descomprimido.
El directorio raíz del paquete o su único directorio de nivel superior debe contener SKILL.md, y su frontmatter debe incluir name.
La creación no monta automáticamente el Skill en el Agent, ni guarda ni publica automáticamente la versión del Agent.

Método de solicitud

POST

URL de la solicitud

https://api.${endpoint}/v1/agent/skill/create

Autenticación de la solicitud

Utiliza la Agent Key del LoopAgent de destino, y dicha Key debe tener habilitado el permiso de gestión de versiones. Para más detalles, consúltese las instrucciones de autenticación en Visión general de la API (API Overview).

Solicitud

Ejemplo de solicitud

curl -X POST 'https://api.${endpoint}/v1/agent/skill/create' \ -H 'Authorization: Bearer ${API Key}' \ -F 'file=@/path/to/refund-policy.skill'

                      
                      curl -X POST 'https://api.${endpoint}/v1/agent/skill/create' \
  -H 'Authorization: Bearer ${API Key}' \
  -F 'file=@/path/to/refund-policy.skill'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Bearer ${API Key}	Autenticación mediante la API Key del LoopAgent de destino, y dicha Key debe tener habilitado el permiso de gestión de versiones.
Content-Type	multipart/form-data	Carga del archivo del paquete de habilidad en forma de formulario.

Parámetros de la solicitud (Form Data)

Parámetro	Tipo	Obligatorio	Descripción
`file`	File	Sí	Paquete de habilidad `.skill` o `.zip`.
`category_id`	String	No	ID de la categoría del Skill; si no se indica, se crea sin categoría.

Respuesta

Ejemplo de respuesta

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "version": "1.0.0" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "version": "1.0.0"
  }
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
skill_id	String	ID del Skill recién creado.
name	String	Nombre del Skill.
version	String	Número de versión del Skill.

Respuesta fallida

Campo	Tipo	Descripción
code	Integer	Código de error.
message	String	Detalles del error.

Códigos de estado

Código de estado	Descripción
200	Correcto
400	Error de parámetros
401	No autorizado
403	Permisos insuficientes
429	Demasiadas solicitudes
500	Error del servidor