Skills
Ce que votre IA sait faire, en paquets prêts à l'emploi.
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é :
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_agentetunpin_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_agentetunfavorite_ai_agentposent 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_idest 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.
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.