Créer un Skill privé d'Agent

Cette interface permet de créer un Skill privé pour le LoopAgent auquel appartient l'Agent API Key courant.

Seul le LoopAgent est pris en charge ; les Agents ordinaires, les Flow Agents et les Workflows ne le sont pas.
Elle ne crée que le Skill privé de l'Agent auquel appartient l'Agent API Key courant.
Seuls les formats .skill et .zip sont acceptés ; l'archive ne doit pas dépasser 20 MiB, contenir au maximum 200 fichiers valides, chaque fichier ne dépassant pas 5 MiB après décompression et l'archive entière ne dépassant pas 64 MiB après décompression.
Le répertoire racine de l'archive ou son unique répertoire de premier niveau doit contenir un fichier SKILL.md, dont le frontmatter doit inclure name.
La création ne monte pas automatiquement le Skill sur l'Agent et n'enregistre ni ne publie automatiquement une version de l'Agent.

Méthode de requête

POST

Adresse d'appel

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

Vérification de l'appel

Utilisez l'Agent Key du LoopAgent cible, cette Key devant avoir le droit de gestion des versions activé. Consultez Présentation de l'API pour les instructions d'authentification.

Requête

Exemple de requête

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'

Ce bloc de code dans la fenêtre flottante

En-têtes de requête

Champ	Type	Description
Authorization	Bearer ${API Key}	Authentification avec l'API Key du LoopAgent cible, cette Key devant avoir le droit de gestion des versions activé.
Content-Type	multipart/form-data	Téléverse le fichier du package de compétences sous forme de formulaire.

Paramètres de requête (Form Data)

Paramètre	Type	Obligatoire	Description
`file`	File	Oui	Package de compétences `.skill` ou `.zip`.
`category_id`	String	Non	ID de catégorie du Skill ; si non fourni, le Skill est créé sans catégorie.

Réponse

Exemple de réponse

{ "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"
  }
}

Ce bloc de code dans la fenêtre flottante

Réponse en cas de succès

Champ	Type	Description
skill_id	String	ID du Skill nouvellement créé.
name	String	Nom du Skill.
version	String	Numéro de version du Skill.

Réponse en cas d'échec

Champ	Type	Description
code	Integer	Code d'erreur.
message	String	Détail de l'erreur.

Codes de statut

Code de statut	Description
200	Succès
400	Erreur de paramètre
401	Non autorisé
403	Droits insuffisants
429	Requêtes trop fréquentes
500	Erreur serveur