Skip to content

GUIDE_MAILBOX.md

Latest commit

 

History

History
136 lines (91 loc) · 3.29 KB

GUIDE_MAILBOX.md

File metadata and controls

136 lines (91 loc) · 3.29 KB

Guide : Créer des Mailboxes pour le Chat AgentVerse

Pourquoi tu es bloqué en "connecting" ?

Le chat AgentVerse a besoin que tes agents soient connectés via des mailboxes.

Ce que tu as fait ✅

  • ✅ Créé une API Key (pour l'API REST)

Ce qu'il manque ❌

  • ❌ Créer des Mailboxes (pour la communication agent-to-agent)

Étapes pour créer les Mailboxes

1. Va sur la page Mailroom

Ouvre : https://agentverse.ai/mailroom

2. Crée 4 Mailboxes

Clique sur le bouton "New Mailbox" ou "Create Mailbox" 4 fois

Pour chaque mailbox, utilise ces noms :

Mailbox 1 : Coordination Hub

  • Name: supply_chain_coordinator
  • Description (optionnel): Orchestrates supply chain agents

Mailbox 2 : Inventory Monitor

  • Name: inventory_monitor_agent
  • Description (optionnel): Monitors warehouse inventory

Mailbox 3 : Route Optimizer

  • Name: route_optimizer_agent
  • Description (optionnel): Optimizes delivery routes

Mailbox 4 : Demand Predictor

  • Name: demand_predictor_agent
  • Description (optionnel): Predicts product demand

3. Copie les Mailbox Keys

Après avoir créé chaque mailbox, tu verras une Mailbox Key (format UUID).

Ça ressemble à ça :

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Par exemple :

a1b2c3d4-e5f6-7890-abcd-ef1234567890

Copie les 4 Mailbox Keys (une pour chaque mailbox)

4. Colle-les dans le fichier .env

Ouvre le fichier .env et remplis les lignes 19-22 :

# Mailbox Keys (leave empty for local mode, fill for AgentVerse mode)
COORDINATOR_MAILBOX_KEY=colle-la-cle-du-coordinator-ici
INVENTORY_MAILBOX_KEY=colle-la-cle-de-inventory-ici
ROUTE_MAILBOX_KEY=colle-la-cle-de-route-ici
DEMAND_MAILBOX_KEY=colle-la-cle-de-demand-ici

5. Relance les agents

Ferme tous les terminaux Python et relance :

start_agents.bat

Les agents se connecteront automatiquement aux mailboxes !

6. Vérifie sur AgentVerse

Retourne sur https://agentverse.ai/mailroom

Tu devrais voir tes 4 mailboxes avec un statut "Online" ou "Connected" 🟢

7. Teste le Chat

Va sur https://chat.agentverse.ai

  • Crée une nouvelle session
  • Cherche ton agent supply_chain_coordinator
  • Envoie un message, par exemple : "Check inventory for warehouse WH001"

Le chat devrait maintenant fonctionner ! ✅

Format des Mailbox Keys

API Key (ce que tu as créé) :

eyJhbGciOiJSUzI1NiJ9.eyJleHAiOjE3NjM...  (long JWT token)

→ Va dans : AGENTVERSE_API_KEY ✅ Déjà configuré

Mailbox Keys (ce qu'il faut créer) :

a1b2c3d4-e5f6-7890-abcd-ef1234567890  (format UUID)

→ Va dans : COORDINATOR_MAILBOX_KEY, INVENTORY_MAILBOX_KEY, etc.

Raccourci : Où trouver les Mailbox Keys

  1. Connecte-toi sur https://agentverse.ai
  2. Menu de gauche : "Mailroom"
  3. Clique sur "New Mailbox"
  4. Donne un nom (ex: supply_chain_coordinator)
  5. La Mailbox Key apparaît sur la page

Répète 4 fois (une pour chaque agent).

Si tu as déjà créé les mailboxes

Envoie-moi les 4 Mailbox Keys et je les configure automatiquement !

Format :

COORDINATOR: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
INVENTORY: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ROUTE: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DEMAND: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx