aiconfig-update

Par launchdarkly · agent-skills

Mettez à jour, archivez et supprimez les AI Configs LaunchDarkly ainsi que leurs variations. À utiliser lorsque vous devez modifier les propriétés d'une config, changer les paramètres de modèle, mettre à jour les instructions ou les messages, archiver les configs inutilisées, ou les supprimer définitivement.

npx skills add https://github.com/launchdarkly/agent-skills --skill aiconfig-update

Mise à jour et cycle de vie de la configuration IA

Vous utilisez une skill qui vous guidera dans la mise à jour, l'archivage et la suppression de configurations IA et de leurs variations. Votre travail consiste à comprendre l'état actuel de la configuration, effectuer les modifications et vérifier le résultat.

Prérequis

Cette skill nécessite que le serveur MCP LaunchDarkly hébergé à distance soit configuré dans votre environnement.

Outils MCP requis :

  • get-ai-config-health -- évaluer la santé de la configuration avant d'effectuer des modifications (détecte les modèles manquants, les outils orphelins, les configurations vides)
  • get-ai-config -- comprendre l'état actuel avant d'effectuer des modifications
  • update-ai-config -- mettre à jour les métadonnées de la configuration (nom, description, tags, archivage)
  • update-ai-config-variation -- mettre à jour le modèle de la variation, les prompts ou les paramètres

Outils MCP optionnels :

  • delete-ai-config -- supprimer définitivement une configuration (irréversible)
  • delete-ai-config-variation -- supprimer définitivement une variation (irréversible)

Principes fondamentaux

  1. Récupérer avant de modifier : Toujours vérifier l'état actuel avant de modifier
  2. Vérifier après modification : Récupérer la configuration à nouveau pour confirmer que les mises à jour ont été appliquées
  3. Archiver avant de supprimer : L'archivage est réversible ; la suppression ne l'est pas

Flux de travail

Étape 1 : Évaluer la santé et comprendre l'état actuel

Commencez par get-ai-config-health pour obtenir une évaluation structurée de la santé. Cela détecte :

  • Les variations sans modèle (affichées sous forme de "NO MODEL" dans l'interface utilisateur)
  • Les variations sans instructions ni messages
  • Les références d'outils orphelins (outils attachés qui n'existent pas dans le projet)
  • Les configurations sans aucune variation

Le verdict de santé (healthy, warning, unhealthy) vous aide à hiérarchiser ce qu'il faut corriger.

Puis utilisez get-ai-config pour examiner les détails complets :

  • Mode actuel (agent ou completion)
  • Variations existantes et leurs modèles
  • Instructions ou messages actuels
  • Outils attachés et paramètres

Étape 2 : Effectuer la mise à jour

Mettre à jour les métadonnées de la configuration -- Utilisez update-ai-config :

  • Modifier le nom ou la description
  • Ajouter ou remplacer des tags
  • Archiver avec archived: true (réversible)

Mettre à jour une variation -- Utilisez update-ai-config-variation :

  • Changer de modèle (fournir la nouvelle modelConfigKey et modelName)
  • Modifier les instructions ou les messages
  • Ajuster les paramètres (température, max_tokens, etc.)
  • Attacher ou détacher des outils via l'objet paramètres

Archiver une configuration -- Utilisez update-ai-config avec archived: true. L'archivage est le moyen préféré de retirer une configuration :

  • Il est réversible (désarchiver avec archived: false)
  • La configuration est masquée des listes actives mais conservée
  • Après l'appel à l'archivage, traitez une réponse réussie comme une confirmation et procédez à la vérification
  • Quand un utilisateur dit « supprimer », « retirer », « décommissionner » ou « plus nécessaire », préférez l'archivage sauf s'il demande explicitement « supprimer définitivement »

Supprimer -- Utilisez delete-ai-config ou delete-ai-config-variation (irréversible, nécessite confirm: true). Toujours suggérer d'archiver d'abord. Procéder à la suppression uniquement si l'utilisateur confirme explicitement qu'il souhaite une suppression permanente et irréversible.

Étape 3 : Vérifier

Utilisez get-ai-config pour confirmer que la réponse affiche vos valeurs mises à jour.

Signaler les résultats :

  • Mise à jour appliquée avec succès
  • La configuration reflète les modifications
  • Signaler tout problème ou effectuer une restauration si nécessaire

Ce qu'il NE FAUT PAS faire

  • Ne pas mettre à jour les configurations de production sans tester d'abord dans une autre variation
  • Ne pas modifier plusieurs choses à la fois -- effectuer des modifications progressives
  • Ne pas sauter la vérification
  • Ne pas supprimer sans confirmation explicite de l'utilisateur -- toujours suggérer d'archiver d'abord
  • Ne pas réessayer une mise à jour parce que la réponse de l'API n'reprend pas exactement les valeurs que vous avez envoyées -- vérifier plutôt avec get-ai-config

Skills connexes

  • aiconfig-variations -- Créer des variations pour tester les modifications côte à côte
  • aiconfig-tools -- Mettre à jour les attachements d'outils

Skills similaires