Aller au contenu

Skills

Ce que votre IA sait faire, en paquets prêts à l'emploi.

Ouvrir Skills
Vérifié par rapport au tableau de bord le 20 novembre 2026

L'API publique a sept méthodes pour les compétences. L'API appelle encore une compétence un agent IA, donc c'est le nom dans chaque méthode. Elles agissent sur des compétences qui existent déjà : elles en épinglent une, en marquent une comme favorite, en archivent une, lui créent une image, et enregistrent un consentement. Chacune agit pour le compte dont vous utilisez la clé API.

Créer une compétence, en planifier une à partir de vos mots, modifier ses instructions ou ses outils, cloner, installer depuis la Marketplace, publier, partager, désarchiver, supprimer et choisir un forfait se font dans le tableau de bord. Ils n'ont aucune méthode publique aujourd'hui.

Envoyez une requête à une méthode avec votre clé :

curl -s https://xuda.ai/cpi/pin_ai_agent \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","agent_id":"YOUR_SKILL_ID"}'
const res = await fetch('https://xuda.ai/cpi/pin_ai_agent', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY', agent_id: 'YOUR_SKILL_ID' }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/pin_ai_agent',
    json={'api_key': 'YOUR_API_KEY', 'agent_id': 'YOUR_SKILL_ID'},
)

Une bonne réponse a code 1. Une réponse refusée a un code négatif et dit pourquoi dans data.

Chaque méthode prend l'identifiant de la compétence comme agent_id, qui est la dernière partie de l'adresse de la compétence dans le tableau de bord. Sauf set_agent_tool_consent, chacune accepte aussi un workspace_id facultatif, pour agir dans un espace de travail autre que le vôtre. Vous devez posséder cet espace de travail.

Épingler et marquer en favori

  • pin_ai_agent et unpin_ai_agent épinglent une compétence et retirent l'épingle. Le tableau de bord est prévenu tout de suite, donc une page ouverte montre le changement.
  • favorite_ai_agent et unfavorite_ai_agent posent et retirent la marque de favori, le cœur sur la carte de la compétence. Un favori est aussi ce que liste le choix Favoris du menu Afficher.

Archiver

archive_ai_agent déplace une compétence de la liste active vers Archivé. Une compétence archivée ne compte plus dans le nombre que contient le forfait de l'espace de travail, ce qui permet de faire de la place sous une limite.

  • Seule la personne qui a créé la compétence peut l'archiver. Pour toute autre personne, la réponse est un refus qui dit que l'opération n'est pas autorisée.
  • Une compétence que vous avez partagée avec d'autres est refusée tant que ce partage est actif. Mettez d'abord fin au partage.
  • conversation_id est facultatif. Avec lui, seule cette conversation de la compétence est archivée. Sans lui, toutes les conversations de la compétence sont archivées avec elle.

Ramener une compétence, ou la supprimer définitivement, se fait dans le tableau de bord, depuis la vue Archivé.

Créer une image

generate_ai_agent_image crée une nouvelle image pour une compétence que vous possédez et l'enregistre sur la compétence. Utilisez-la quand une compétence n'a pas d'image et que sa carte se rabat sur l'image de remplacement. Elle s'exécute en arrière-plan, donc la nouvelle image apparaît au prochain chargement de la compétence. C'est la même chose que Générer une image dans le menu de la carte.

Autoriser une compétence installée à utiliser les outils de son éditeur

set_agent_tool_consent enregistre si vous autorisez une compétence installée à utiliser des outils de plugin qui s'exécutent dans l'espace de travail de son éditeur. Tout ce que ces outils créent est stocké dans le drive de l'éditeur plutôt que dans le vôtre. Elle prend agent_id et granted, true pour autoriser et false pour retirer, et en option owner_uid, le compte de l'éditeur. Elle n'enregistre jamais que votre propre décision, jamais celle de quelqu'un d'autre.

Le compte d'une compétence et son forfait

Les compétences sont comptées selon le forfait de l'espace de travail où elles se trouvent. Voir Forfaits et facturation pour ce qui compte et ce qui se passe à la limite.

Que pensez-vous de ce guide ?

Dernière mise à jour le 16 novembre 2026