Graphiques d'agents AI Config

Vous utilisez une skill qui vous guidera dans la création et la gestion de graphiques d'agents dans LaunchDarkly. Votre rôle est de concevoir la topologie du graphique, le créer avec les bons edges et handoffs, et vérifier le routage entre les nœuds AI Config.

Prérequis

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

Outils MCP requis :

create-agent-graph -- créer un nouveau graphique avec des nœuds et des edges
get-agent-graph -- inspecter la structure et les edges d'un graphique
list-agent-graphs -- parcourir les graphiques existants dans le projet

Outils MCP optionnels :

update-agent-graph -- modifier les edges, la configuration racine ou la description
delete-agent-graph -- supprimer définitivement un graphique
get-ai-config -- inspecter les AI Configs individuels qui servent de nœuds
create-ai-config -- créer de nouveaux AI Configs à utiliser comme nœuds de graphique

Concepts fondamentaux

Que sont les graphiques d'agents ?

Un graphique d'agent est un graphe orienté où :

Les nœuds sont des AI Configs (chaque configuration est un agent avec son propre modèle, prompt et outils)
Les edges définissent le routage entre les configurations (source -> cible)
Les données de handoff sur les edges contrôlent la façon dont le contexte est transmis entre les agents
La configuration racine est le point d'entrée — le premier agent qui reçoit l'entrée utilisateur

Quand utiliser les graphiques d'agents

Scénario	Exemple
Workflows multi-étapes	Agent de triage -> Agent spécialiste -> Agent de synthèse
Routage par intention	L'agent routeur décide quel spécialiste traite la demande
Chaînes d'escalade	Support L1 -> Support L2 -> Handoff humain
Traitement en pipeline	Extraire -> Transformer -> Valider -> Stocker

Structure du graphique

[Config racine] --edge--> [Config A] --edge--> [Config C]
                    \--edge--> [Config B]

Chaque edge contient :

key -- identifiant unique pour l'edge
sourceConfig -- la clé AI Config qui route DEPUIS
targetConfig -- la clé AI Config qui route VERS
handoff (optionnel) -- données/instructions transmises lors de la transition

Principes fondamentaux

Concevoir avant de construire : Cartographiez d'abord les nœuds et edges sur papier/tableau blanc
Un agent, une fonction : Chaque nœud doit avoir une responsabilité claire et précise
La configuration racine est le routeur : Le point d'entrée doit savoir comment dispatcher
Les données de handoff comptent : Définissez quel contexte circule entre les agents
Vérifiez le chemin complet : Testez que le routage fonctionne de bout en bout

Workflow

Étape 1 : Concevoir le graphique

Avant de créer quoi que ce soit :

Identifiez les agents (AI Configs) nécessaires — chacun est un nœud du graphique
Cartographiez le routage : quel agent effectue le handoff vers quel agent ?
Définissez les données de handoff : quel contexte chaque edge transporte-t-il ?
Identifiez la configuration racine : quel agent reçoit l'entrée initiale ?
Vérifiez les graphiques existants avec list-agent-graphs pour éviter les doublons
Vérifiez les AI Configs existants avec get-ai-config pour voir quels nœuds existent déjà

Étape 2 : Assurer que les nœuds existent

Chaque nœud du graphique doit être un AI Config existant. Si les configurations n'existent pas encore :

Utilisez create-ai-config pour créer chaque configuration d'agent
Configurez les variations avec les modèles et prompts appropriés pour le rôle de chaque agent
Vérifiez que chaque configuration existe avec get-ai-config

Étape 3 : Créer le graphique

Utilisez create-agent-graph avec :

projectKey -- le projet contenant les AI Configs
key -- identifiant unique pour le graphique
name -- nom d'affichage lisible
description (optionnel) -- explique l'objectif du graphique
rootConfigKey -- la clé AI Config du point d'entrée
edges -- tableau des connexions entre les configurations

{
  "projectKey": "my-project",
  "key": "support-triage-graph",
  "name": "Customer Support Triage",
  "description": "Routes customer queries to the appropriate specialist agent",
  "rootConfigKey": "triage-agent",
  "edges": [
    {
      "key": "triage-to-billing",
      "sourceConfig": "triage-agent",
      "targetConfig": "billing-specialist",
      "handoff": {"category": "billing", "priority": "normal"}
    },
    {
      "key": "triage-to-technical",
      "sourceConfig": "triage-agent",
      "targetConfig": "technical-specialist",
      "handoff": {"category": "technical", "priority": "normal"}
    }
  ]
}

Étape 4 : Vérifier

Utilisez get-agent-graph pour confirmer que le graphique a été créé avec la structure correcte
Vérifiez que les edges connectent les bonnes configurations source et cible
Vérifiez que la clé de configuration racine correspond au point d'entrée prévu
Confirmez que les données de handoff sont présentes sur les edges qui les nécessitent

Rapportez les résultats :

Graphique créé avec N nœuds et M edges
Configuration racine définie correctement
Tous les edges vérifiés

Cas limites

Situation	Action
La configuration n'existe pas encore	Créez-la d'abord avec `create-ai-config` avant de la référencer dans un graphique
Routage circulaire	Autorisé mais avertissez l'utilisateur — assurez-vous qu'il y a une condition de terminaison dans la logique de l'agent
Graphique à nœud unique	Valide mais inhabituel — considérez si un graphique est réellement nécessaire
Mise à jour des edges	Utilisez `update-agent-graph` — fournissez la liste complète des nouveaux edges

Ce qu'il NE FAUT PAS faire

Ne créez pas un graphique avant que les nœuds AI Config existent
N'oubliez pas les données de handoff quand les agents ont besoin du contexte de leurs prédécesseurs
Ne créez pas de graphiques excessivement complexes — commencez simple et ajoutez des nœuds au besoin
Ne supprimez pas un graphique sans comprendre s'il est activement utilisé dans les workflows d'agents

aiconfig-agent-graphs