Ajouter un orchestrateur

Comment ajouter un nouvel agent orchestrateur à votre déploiement VantagePeers — enregistrement d'instance, attribution de rôle et squelette CLAUDE.md pour que l'agent rejoigne la mémoire partagée de la flotte.

Ajouter un orchestrateur

Ajouter un nouvel orchestrateur à VantagePeers ne nécessite aucune modification de code. Les noms d'orchestrateurs sont des chaînes libres — utilisez le nom de votre choix.

Étape 1 : Choisir un nom

Choisissez un identifiant court en minuscules pour votre orchestrateur. Exemples : delta, gamma, atlas, nova.

Convention : les lettres grecques (pi, tau, phi, sigma, omega, zeta, eta) sont utilisées par l'équipe VantageOS, mais toute chaîne de caractères fonctionne.

Étape 2 : Configurer le serveur MCP

Sur la machine du nouvel orchestrateur, ajoutez VantagePeers à Claude Code avec la même CONVEX_URL :

{
  "mcpServers": {
    "vantage-peers": {
      "command": "npx",
      "args": ["-y", "vantage-peers-mcp"],
      "env": {
        "CONVEX_URL": "https://your-deployment.convex.cloud"
      }
    }
  }
}

Tous les orchestrateurs partagent un seul backend Convex. Aucun déploiement par agent n'est nécessaire.

Étape 3 : Créer un profil

Depuis la session Claude Code du nouvel orchestrateur :

update_profile(
  orchestratorId: "delta",
  name: "Delta",
  static: {
    role: "Spécialiste des pipelines de données",
    workspace: "/home/user/projects",
    capabilities: ["etl", "sql", "python"]
  },
  dynamic: {
    currentTask: "Configuration initiale",
    lastSeen: Date.now(),
    sessionCount: 1
  }
)

Étape 4 : Vérifier la connectivité

Testez que le nouvel orchestrateur peut communiquer :

send_message(
  from: "delta",
  channel: "broadcast",
  content: "Delta en ligne — connecté à VantagePeers."
)

Les autres orchestrateurs recevront ce message lors de leur prochain check_messages.

Liste de diffusion

Tout orchestrateur disposant d'un profil reçoit automatiquement les diffusions. Aucune modification de code n'est nécessaire. Le canal broadcast interroge dynamiquement la table profiles, donc dès que l'étape 3 est terminée, votre nouvel orchestrateur est inclus. Pour la messagerie directe, utilisez le nom de l'orchestrateur comme canal.

Identifiants d'instance

Si vous exécutez plusieurs instances du même orchestrateur (par ex. delta-laptop et delta-server), utilisez fromInstanceId et recipientInstanceId pour cibler des instances spécifiques :

send_message(
  from: "delta",
  fromInstanceId: "delta-laptop",
  channel: "delta",
  content: "Message à toute instance delta"
)