Créer, importer et gérer les compétences
Créez une compétence personnalisée, importez une compétence compatible et modifiez-la ou supprimez-la en toute sécurité plus tard.
Les compétences personnalisées vous permettent de regrouper vos propres instructions pour une utilisation répétée. L’importation est utile lorsqu’une compétence compatible existe déjà et que vous souhaitez l’examiner avant de l’ajouter à Runner.
Ce que couvre ce guide
Vous saurez comment créer ou importer une compétence, comprendre chaque contrôle d’éditeur et distinguer la pause réversible de la suppression permanente.
Disponibilité et conditions préalables
- Ouvrez un projet avec accès à Agent → Compétences.
- Les compétences nécessitent un accès au plan.
- L’importation nécessite une URL source compatible que Runner peut lire.
- N’importez pas les instructions en lesquelles vous n’avez pas confiance. Examinez le nom, la description, le contenu, les paramètres et les fichiers inclus avant d’enregistrer.
Chemins d’accès
- Créer : Barre latérale Agent → Filtre Compétences → Créer une compétence dans la section Découvrir.
- Import : Barre latérale Agent → Filtre Compétences → Importer dans Découvrir.
- Modifier ou supprimer : Barre latérale Agent → Filtre Compétences → une ligne dans Ajoutée → Plus d’actions.
Contrôles de l’éditeur de compétences
| Entrée ou bouton | Pourquoi c’est utile | Ce qui se passe ensuite |
|---|---|---|
| Nom | Donne à la compétence son identité dans les listes et les commandes. | Runner valide qu’un nom est présent avant d’enregistrer. |
| Description | Explique quand la compétence doit être utilisée. | La description apparaît dans les listes de compétences et les sélecteurs. |
| Contenu | Stocke les instructions réutilisables. | Écrivez Modifier et utilisez Aperçu pour vérifier les instructions formatées. |
| Configuration avancée | Révèle les paramètres facultatifs d’invocation et d’organisation. | Développez-le uniquement lorsque vous devez modifier ces paramètres. |
| Passer à Markdown / Passer au formulaire | Modifie la façon dont vous modifiez la compétence. | Ouvre l’éditeur Markdown ou basé sur des champs ; changer de vue ne sauvegarde pas la compétence. |
| Catégorie | Regroupe les compétences connexes. | Cette étiquette facultative affecte la façon dont les compétences sont organisées. |
| Libellé du raccourci | Donne à la compétence une étiquette de commande plus claire. | L’étiquette facultative apparaît avec les contrôles orientés commande. |
| Activé | Choisissez si la compétence nouvelle ou modifiée commence à être active. | Cela commence pour une nouvelle compétence. Désactivez-le avant de créer la compétence si elle doit démarrer en pause. |
| Désactiver l’invocation automatique de l’IA | Empêche Runner de choisir la compétence automatiquement. | La compétence reste disponible pour une utilisation manuelle. |
| Invocable par l’utilisateur | Permet l’utilisation manuelle de la commande slash. | La désactiver supprime l’invocation manuelle tout en conservant les autres utilisations autorisées. |
| Indice d’argument | Affiche l’entrée attendue après une commande. | L’indice peut afficher des exemples tels qu’une URL ou un numéro de problème. |
| Zone de fichiers | Ajoutez du texte de support ou des ressources nécessaires à la compétence. | Runner valide les limites de fichiers individuels et totaux avant d’enregistrer. |
| Annuler | Partez sans appliquer la modification actuelle. | La boîte de dialogue se ferme ; les modifications non enregistrées sont abandonnées. |
| Créer / Enregistrer | Conservez une compétence valide. | Runner ferme l’éditeur après succès et actualise la liste des compétences. |
Créer une compétence personnalisée
- Ouvrez la barre latérale Agent et sélectionnez le filtre Compétences.
- Dans Découvrir, sélectionnez Créer une compétence.
- Entrez un Nom minuscule et avec trait d’union, tel que
homepage-copy-review, un Description concis et la compétence Contenu. Ces champs sont obligatoires. - Sélectionnez Aperçu dans Contenu pour vérifier les instructions. Développez Configuration avancée pour les paramètres facultatifs uniquement lorsque vous en avez besoin.
- Examinez Activé et tous les paramètres d’appel avancés que vous avez modifiés. Ces contrôles déterminent comment Runner peut utiliser la compétence.
- Sélectionnez Créer.
- Confirmez que la compétence apparaît sous Ajoutée ou En pause, selon le paramètre Activé.
Les captures et vidéos de cette page montrent l’interface en anglais.
Les annotations en anglais indiquent les commandes. Sélectionnez l’image pour l’agrandir.
Cet exemple présente un aperçu des instructions avant Créer. Le brouillon n’a pas été enregistré.
Vidéo : réviser un brouillon de compétences
L’enregistrement fait basculer l’exemple entre Markdown et Form Preview, puis s’annule. Pour conserver votre propre compétence, sélectionnez Créer et confirmez qu’elle apparaît dans la liste.
Importer une compétence
- Ouvrez Agent, sélectionnez le filtre Compétences et recherchez Importer dans Découvrir.
- Collez l’URL source compatible.
- Sélectionnez Importer.
- Pour une compétence découverte, Runner ouvre l’éditeur avec les champs importés remplis. Pour une source contenant plusieurs compétences, Runner ouvre un sélecteur.
- Examinez chaque champ importé et tout avertissement de fichier exclu ou de taille.
- Apportez les modifications nécessaires, puis sélectionnez Créer.
- Confirmez que la compétence apparaît sur la page de l’agent avant de fermer votre flux de travail.
L’importation ne rend pas le contenu non examiné digne de confiance. Traitez les instructions importées comme tout autre contenu qui peut influencer le travail de Runner.
Modifier, mettre en pause ou supprimer
- Sélectionnez une ligne de compétence personnalisée ou ouvrez Plus d’actions → Modifier.
- Modifiez les champs dont vous avez besoin et sélectionnez Enregistrer. Rouvrez la compétence pour confirmer les instructions mises à jour.
- Pour arrêter de l’utiliser sans la perdre, sélectionnez Ajoutée pour la déplacer vers En pause.
- Pour la supprimer, ouvrez Plus d’actions → Supprimer.
- Examinez la boîte de dialogue de confirmation nommée et sélectionnez Supprimer uniquement lorsque vous avez l’intention de supprimer la compétence.
La suppression est destructrice. Ce n’est pas la même chose que de mettre en pause, et la page ne la présente pas comme une action annulable. Les compétences système n’offrent pas de suppression.
États et limites
- Le nom, la description ou le contenu manquant bloque l’enregistrement et affiche un message de validation.
- Un nom de compétence importée en double peut être rejeté ou marqué comme déjà présent.
- Les fichiers qui dépassent les limites acceptées peuvent être ignorés ; un avertissement de taille totale peut bloquer l’enregistrement jusqu’à ce que le contenu soit réduit.
- Pendant que l’enregistrement, l’importation ou la suppression s’exécute, attendez le message de succès ou d’erreur avant de prendre une autre action.
- Les compétences système en lecture seule peuvent afficher les détails mais n’exposent pas les contrôles d’édition de compétence personnalisée.
Dépannage
- Si Importer reste indisponible, attendez que la vérification de compétence existante se termine et confirmez que le champ URL n’est pas vide.
- Si l’importation ouvre un sélecteur par lot, sélectionnez uniquement les compétences que vous reconnaissez et dont vous avez besoin.
- Si l’enregistrement est bloqué, vérifiez les champs obligatoires et tout avertissement de fichier en haut de l’éditeur.
- Si une compétence a disparu après avoir sélectionné Ajoutée, vérifiez En pause avant de la recréer.
- Si la suppression échoue, la compétence reste ; fermez l’erreur et réessayez après avoir vérifié vos autorisations.