Utiliser des plugins
Universal Agent Plugins installe des paquets standard pour les agents d’IA de votre choix. Un paquet peut contenir des Skills, une configuration de serveurs MCP ou les deux. Vous pouvez l’installer pour votre compte ou garder les dépendances d’un projet séparées.
Obtenez le CLI
Avec Node.js 22 ou une version ultérieure, lancez directement le wrapper npm :
npx universal-agent-plugins search docsPour un usage régulier, installez-le globalement :
npm install -g universal-agent-plugins
agentplugins versionHomebrew est une autre possibilité :
brew install 777genius/agentplugins/agentpluginsLe guide d’installation native donne les instructions pour macOS, Linux et Windows. Le gestionnaire natif ne nécessite pas Node.js, mais certains plugins peuvent avoir besoin de leur propre environnement d’exécution. Les exemples de ce parcours utilisent agentplugins ; npx universal-agent-plugins exécute les mêmes commandes d’installation.
Suivez le parcours d’installation
- Recherchez et examinez un paquet. Vérifiez sa provenance et ses prérequis.
- Prévisualisez les cibles et la portée prévues avec
--dry-run. - Appliquez l’installation examinée et suivez les instructions d’activation.
- Maintenez l’état installé : liste, mise à jour, réparation et suppression.
- Au besoin, restaurez des dépendances partagées depuis
uap.tomletuap.lock.
CLI est l’installateur natif actuel. Il ajoute une API de gestion locale et des extensions natives Pi en portée utilisateur et en portée projet admissible. Consultez la gestion locale et la compatibilité Pi. Les versions peuvent varier selon le canal ; vérifiez agentplugins version et utilisez l’installateur natif pour obtenir la version vérifiée.
La portée projet explicite est disponible depuis 0.1.93. La plupart des commandes utilisent par défaut la portée utilisateur. Depuis 0.1.94, install sans argument de source ni portée explicite sélectionne le projet uniquement si le dossier courant exact contient un fichier uap.toml ordinaire ; il ne recherche pas dans les parents. Une portée explicite reste prioritaire. Sélectionnez --scope project pour la maintenance d’un projet. La prise en charge des composants et l’activation dépendent du client.
Interprétez chaque résultat
Un rechargement, une demande de confiance, une activation manuelle ou une étape OAuth peuvent rester nécessaires après l’installation. Le résultat Prepared signifie que des étapes restent à effectuer dans le client. Lisez le résultat de chaque cible : l’opération complète ne prouve pas à elle seule que le plugin fonctionne à l’exécution. Consultez la compatibilité des clients pour connaître la portée et les versions des observations natives.
Si vous créez un paquet
Commencez par Créer des plugins. Le livrable commun est un dossier avec plugin.json à la racine et les composants du paquet. La personne qui installe ce paquet n’a pas besoin d’exécuter les outils de création compilés depuis le code source.
| Commande | Rôle |
|---|---|
agentplugins validate ./my-plugin | Lire et valider un paquet local pour l’installation. |
agentplugins doctor | Diagnostiquer l’état géré par l’installateur. |
agentplugins author validate ./my-plugin | Vérifier la conformité et la préparation d’un paquet dans une compilation où la création est activée. |
agentplugins author doctor ./my-plugin | Examiner les preuves du projet et de sa chaîne d’outils dans cette compilation. |
La version actuelle de l’installateur npm ou natif n’inclut pas agentplugins author.