Connecter mon agent

Tutoriel (en anglais) · 3:09

Beans Workbench offre deux façons d'obtenir l'aide d'une IA. Beans Assistant est le chat intégré au Workbench : rien à installer, il voit la page où vous êtes et demande avant de modifier un fichier. Votre propre agent (Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, ou tout autre client MCP) peut utiliser les mêmes outils via le serveur MCP du Workbench, dzt mcp ; c'est ce que cette page configure. Elle contient aussi la liste des autres serveurs MCP (Blender, Sketchfab, les vôtres) dont Beans Assistant peut utiliser les outils. Pour la seconde façon, il faut que l'agent soit installé ; il tourne sur son propre abonnement, aucun compte Beans n'est nécessaire.

Dans les deux cas, les secrets de vos paramètres (jeton de la passerelle, clés d'API, URL de webhooks, clé de signature) ne sont jamais envoyés à un modèle : Beans Assistant masque chaque résultat d'outil avant qu'il quitte le Workbench, et l'outil qui décrit votre installation à un agent (dayz_environment) ne donne que des dossiers.

L'écran

Premiers pas

  1. Ouvrez Connecter mon agent dans la barre latérale (le groupe Lancer).
  2. Trouvez votre agent dans la carte de gauche. S'il indique non installé, installez-le, puis Rechercher à nouveau.
  3. Cliquez sur Connecter sur sa ligne. Pour Claude Desktop, quittez-le d'abord complètement (icône de la barre système comprise).
  4. Redémarrez l'agent pour qu'il charge le serveur. Il y apparaît sous le nom dayz.
  5. Cliquez sur Tester le serveur : la carte de droite liste les outils que votre agent a désormais.
  6. Dans votre agent, demandez quelque chose qui en a besoin, par exemple l'un des exemples de demandes.

Suivre la visite guidée (dans l'app)

Tâches courantes

Utiliser Beans Assistant, le chat intégré

  1. Appuyez sur Ctrl+J, ou cliquez sur l'étincelle dans la barre latérale ou dans l'en-tête d'une page. Le panneau s'ouvre à droite ; sur l'Accueil, le chat est dans la page.
  2. Saisissez votre demande. @ mentionne un fichier, Ctrl+V colle une image, le trombone joint des fichiers. Les secrets de vos réglages (webhooks, clés, jetons) sont retirés du texte joint, et les fichiers de réglages et de session du Workbench ne sont jamais joints. Les réponses n'affichent aucune image du web : un lien d'image s'affiche comme son texte.
  3. Lisez la pastille sous la zone de message : Contexte : … nomme ce que la page envoie avec votre message. Cliquez dessus pour lire le texte exact ; cliquez sur sa croix pour cesser de l'envoyer.
  4. Choisissez le mode (voir Concepts), puis appuyez sur Entrée.

Il s'affiche sauf si vous l'avez désactivé dans les Paramètres (connexion avec Steam). Chaque compte connecté a un petit usage gratuit par mois avec le modèle par défaut, pour l'essayer ; un plan (un par compte Steam) en donne davantage, avec une limite par jour qui se réinitialise chaque jour à 00:00 UTC (Casual 12 €, environ 14 demandes GLM 5.3 Flash par jour ; Modder 29 €, environ 20 ; Creator 79 €, environ 60), et les packs ajoutent des crédits qui n'expirent pas. La barre en haut du panneau montre ce qui est utilisé ; cliquez-la pour le détail. Suivre sa visite guidée (dans l'app)

Lancer une recette

Les recettes sont des tâches guidées : importer une arme, ajouter un verrou de véhicule, configurer un marchand, publier sur le Workshop. Ouvrez le catalogue avec Recettes dans l'en-tête du panneau (même en pleine conversation), Aide > Recettes dans la barre de menus, Voir les N sur l'Accueil, ou les puces qu'une page montre quand elle est vide. Cherchez par mots ou filtrez par catégorie (Créer, Améliorer, Tester et corriger, Serveur, Publier), puis cliquez sur une carte : une nouvelle conversation démarre, pose les questions de la recette, propose un plan et avance étape par étape, chaque étape finie par une vérification. Une carte avec un cadenas et le nom d'une offre demande cette offre ; un clic le dit et ouvre la boutique. Le panneau d'aide (F1) de chaque page liste ses recettes.

La durée d'une carte est celle de l'assistant : « une première version en ~20 min » pour une recette qui crée quelque chose, « une session de ~30 min » pour une recette qui améliore un mod existant. Quand les étapes d'une recette sont faites, Et ensuite sous la liste propose les recettes qui suivent d'habitude (tester en jeu et corriger, ajouter une fonctionnalité, équilibrer, publier).

Construire un mod sur plusieurs jours

Un vrai mod demande plus d'une séance. Planifier un mod sur plusieurs jours (sur l'Accueil, ou En faire un projet après une recette) demande l'objectif, pour qui il est et sa taille, puis écrit une feuille de route : un objectif et des étapes (une première version, un test en jeu, des corrections, une fonctionnalité, des finitions, une publication), gardée dans .beans/ROADMAP.json du mod. Vous l'approuvez comme toute modification de fichier et pouvez la modifier. Chaque conversation sur ce mod commence avec la feuille de route : Beans reprend là où vous vous êtes arrêté. Continuer sur l'Accueil lance une session sur la prochaine étape : l'assistant lit le code des sessions précédentes, fait l'étape, la vérifie, la marque faite et ajoute ce qu'il a trouvé (un bug, un point à reprendre) comme nouvelles étapes. Les recettes Améliorer (ajouter une fonctionnalité, corriger ce que les testeurs ont signalé, équilibrer prix et butin) et Tester en jeu et corriger marchent de la même façon sur n'importe quel mod.

Voir son usage et ses achats, prendre un plan ou un pack

  1. Une fois connecté avec Steam, une barre d'usage s'affiche dans l'en-tête du panneau (et au-dessus du champ de saisie sur l'Accueil) : la limite de votre plan, sinon l'usage gratuit du mois, avec le nombre approximatif de demandes restantes, et vos crédits de packs. Cliquez dessus : un menu s'ouvre avec les barres d'usage, chacune avec sa réinitialisation et le nombre approximatif de demandes restantes.
  2. Compte et utilisation : les barres d'usage, votre abonnement, les réponses par jour sur les 30 derniers jours, vos achats avec leurs reçus et les prix par modèle.
  3. Plans et packs : la boutique. Chaque plan indique ce qu'il comprend (tous les modèles, toutes les recettes) et environ combien de demandes par jour ; chaque pack, environ combien de demandes il paie. Cochez la case du droit de rétractation de 14 jours, puis cliquez sur un plan ou un pack ; la page de paiement s'ouvre dans votre navigateur et le compte se met à jour une fois le paiement fait. Avec un plan, cliquez sur un autre pour en changer : il démarre dès son paiement, l'ancien prend fin et Stripe crédite son temps non utilisé.

Les recettes du catalogue (actions guidées) sont incluses dans un plan Beans ; sans plan, une recette par mois est gratuite (la pastille au-dessus du catalogue dit si elle est utilisée). Les outils restent gratuits. Auditer mon mod relit un mod dans une nouvelle conversation : sécurité, données des joueurs, performances, compatibilité, test en jeu, puis un rapport avec les corrections. Un mod que vous créez est le vôtre : sa première ligne indique qu'il a été réalisé avec Beans Workbench, et vous pouvez la retirer.

Les modèles ne coûtent pas la même chose. Le sélecteur a deux groupes : Inclus, le modèle par défaut (GLM 5.3 Flash), sur lequel comptent le mois gratuit et les abonnements ; et Premium, les modèles Claude (Haiku, Sonnet, Opus), qui répondent mieux et consomment l'abonnement plus vite. Chaque modèle affiche son tarif à côté de son nom (×1 pour le modèle par défaut, ×6 pour un modèle six fois plus cher), et après chaque réponse une ligne indique environ combien de demandes restent dans la limite qui l'a payée, ou, quand les packs ont payé, son coût et pourquoi. L'usage gratuit du mois ne vaut que pour le modèle par défaut : avec un autre modèle choisi, une demande refusée le dit. Quand plus rien ne reste, la conversation dit quand la limite revient, avec Plans et packs. Une demande ne démarre que si une limite peut la payer : son contexte et une réponse (le mois gratuit, puis la journée du plan, puis les packs). Quand ce qui reste est trop peu pour le modèle choisi (une longue conversation avec Claude Max, par exemple), la demande est refusée avant de démarrer et indique un modèle moins cher qui tient, avec un bouton qui le choisit et renvoie la demande. La réponse reste dans ce que la limite peut payer ; ce qu'une réponse dépasse encore compte sur la journée (ou le mois) suivant. 4. Gérer l'abonnement (avec un abonnement) ouvre le portail de facturation Stripe pour résilier ou changer de carte ; Se déconnecter oublie la session.

Les Paramètres proposent la même chose sous Compte et usage, avec Se connecter avec Steam quand vous êtes déconnecté.

Approuver, refuser ou annuler un changement

  1. En mode Demander avant, chaque changement est d'abord montré (un diff pour les fichiers) avec trois réponses : oui ; oui et ne plus demander pour cet outil dans cette conversation ; non, en disant quoi faire à la place.
  2. Après une réponse qui a modifié des fichiers, cliquez sur N fichiers modifiés dessous pour voir les diffs.
  3. Rétablir le fichier remet un fichier en place ; Annuler les modifications de cette réponse les remet tous.
  4. Revenir sur l'un de vos messages remet les fichiers comme ils étaient à ce message, coupe la conversation là et rend son texte à la zone de message. Quand un fichier ne peut pas être remis (verrouillé, en lecture seule), le retour s'arrête : la conversation reste telle quelle.
  5. Un fichier que vous avez modifié depuis est montré avec ce qui a changé et demande : écraser ou ignorer. Les fichiers du jeu ne sont jamais modifiés. Les fichiers supprimés par une annulation sont conservés dans un dossier .beans-reverted.

Connecter un agent à la main

  1. Cliquez sur À la main sur la ligne de l'agent. Rien n'est modifié.
  2. Pour Claude Code, lancez la commande affichée dans un terminal. Pour les autres, ajoutez les lignes affichées au fichier nommé au-dessus. Copier les copie.
  3. Redémarrez l'agent, puis Rechercher à nouveau : la ligne doit indiquer connecté.

Vérifier que le serveur fonctionne

  1. Cliquez sur Tester le serveur. Le Workbench démarre dzt mcp, fait la poignée de main MCP et demande la liste des outils.
  2. Une notification donne le nombre d'outils et la carte de droite les liste. Un échec s'affiche dans le journal de la carte de gauche.

Tester le serveur ne vérifie que le côté du Workbench. S'il réussit et que votre agent n'affiche toujours aucun outil, l'agent n'a pas été redémarré, ou sa configuration pointe vers un autre dzt (commande introuvable : cliquez sur Connecter pour le faire pointer vers ce Workbench).

Ajouter Blender ou un autre serveur MCP pour Beans Assistant

  1. Dans la carte du bas, cliquez sur Ajouter Blender (demande uv et l'add-on mcp-for-blender activé dans Blender), Ajouter Sketchfab (demande Node.js et votre propre clé d'API Sketchfab, que le formulaire réclame), ou Ajouter un serveur pour tout autre.
  2. Pour Ajouter un serveur, donnez un nom, puis soit une commande locale avec ses arguments (un par ligne) soit une URL distante. Les valeurs d'environnement et les en-têtes restent sur cet ordinateur.
  3. Cliquez sur Tester sur sa ligne : l'état devient prêt, N outils, ou erreur avec la raison. Outils liste ce qu'il offre.
  4. Laissez De confiance désactivé sauf si vous voulez que ses outils s'exécutent sans demander.

Importer du JSON prend le bloc mcpServers d'une configuration de Claude Desktop ou de Claude Code.

Exemples

Cette page n'a pas d'exemple à ouvrir. Les exemples de demandes sous la liste des outils sont des requêtes à essayer avec l'un ou l'autre des assistants.

Concepts

Pièges

Pour les agents

Voir aussi