Workbench

Workbench est la file de révision pour les handoffs script, DATA, layout et XML remis à Genie par des clients Local MCP comme Codex, Cursor, Claude Desktop ou un autre agent IDE local.

Il rend le travail des agents externes visible et contrôlé par l’utilisateur. MCP peut préparer un prompt ou un brouillon XML, mais le staging Workbench normal ne lance pas de fournisseur, ne modifie pas FileMaker et n’applique pas de code pendant l’appel d’outil. La seule exception est le réglage beta explicite Automatically create scripts in FileMaker, qui peut lancer le flux Create Script révisé pour les stages de script pris en charge depuis des clients locaux de confiance.

Où il apparaît

Ouvrez Workbench depuis la barre d’outils avec l’icône de checklist.

Les items Workbench affichent :

titre
mode : CODE, DATA ou LAYOUT
client source
statut
script cible ou cible du handoff lorsque disponible
prompt, notes ou résumé de l’artefact
notes de révision
avertissements
boutons d’action

Le sélecteur supérieur sépare :

Pending : les items en attente de révision ou d’action
Submitted : les items déjà envoyés à Genie, avec état soumis, source, script cible et les mêmes avertissements/actions visibles lorsque pertinents

Workbench montrant les sections Pending et Submitted pour des brouillons de script

Selon l’item préparé, Workbench peut afficher :

Run : l’envoyer dans Genie
Apply : appliquer un artefact révisé au script actuel par le flux protégé
Create Script : importer un brouillon pris en charge comme nouveau script FileMaker
Preview : inspecter le XML préparé avant d’agir
Copy : copier le prompt ou l’artefact préparé
Remove : le retirer de la file

Panneau Workbench avec des items CODE préparés par Codex

Brouillon de script Workbench avec Apply, Create Script, Preview, Copy et Remove

Workbench peut aussi recevoir des brouillons XML bruts depuis des clients MCP. Dans les builds actuels, les cartes restent compactes : la cible, les notes, les avertissements et les actions restent visibles, tandis que le XML brut s’ouvre avec Preview au lieu d’etre deploye inline par defaut.

Carte Workbench avec script cible, avertissements et sans aperçu XML inline

Ce qui se passe quand vous exécutez un item

Exécuter un item fait le même type de travail que l’envoi d’un prompt depuis le composer.

Genie :

applique toute sélection de métadonnées stockée avec l’item
ajoute le prompt au chat
bascule dans le mode préparé
entre dans le pipeline normal de Genie

Pour CODE, cela signifie admission Stage A, génération Stage B, abaissement AST lorsque disponible, révision preview/copy/apply et sécurité native de Script Workspace. Pour DATA, les confirmations et garde-fous SQL habituels s’appliquent.

Comment les agents MCP doivent préparer le travail

Un agent IDE devrait appeler genie_get_capabilities avant le staging. Ce résultat explique ce qui relève de CODE, DATA, genie_query, de la planification normale ou d’instructions FileMaker manuelles.

Pour du travail script ancre aux metadonnees, l’agent devrait appeler genie_metadata avec action: "parse_selection", puis passer le metadata_selection retourne dans le meme item genie_scripts concerne.

Contrat de staging CODE

Les items CODE Workbench sont volontairement étroits.

Préparez CODE seulement pour :

un nouveau script FileMaker
une modification fondée sur le contenu exact lu dans le fichier actif ou sur un contexte attaché/sélectionné

Utilisez genie_scripts pour les nouveaux scripts et les modifications du script actif. Utilisez result_type: "new_script" pour creer et result_type: "delta_edit" pour modifier.

Pour delta_edit, lisez d’abord le contenu exact avec genie_scripts action:get_content et utilisez les lignes numérotées comme ancres. merge_ready:false ne bloque ni la validation ni le staging ; il indique seulement que la fusion sûre du script complet n’est pas disponible. Ouvrez ou sélectionnez le script cible avant Apply.

Ne préparez pas :

plusieurs scripts dans un seul prompt
des prompts create or replace
des modifications de script nommé sans contenu live exact ni contexte attaché
CREATE TABLE, ALTER TABLE, INSERT, UPDATE, DELETE, TRUNCATE ou autre SQL DATA
des prompts ASK ou de planification
des prompts QUERY en lecture seule
des occurrences de table, relations, layouts, boutons, Web Viewers, portails, objets de layout ou changements de privilèges/sécurité

Brouillons XML bruts

Le staging XML brut sert aux brouillons FileMaker XML produits par un agent qui doivent etre relus dans Genie au lieu d’etre colles directement depuis un chat externe.

Les brouillons External XML ne sont pas une sortie modele validee par Stage A/B. Traitez l’avertissement comme faisant partie du contrat : previsualisez le XML, copiez-le si vous voulez l’inspecter ailleurs, et appliquez seulement lorsque vous faites confiance a l’artefact.

Pour un brouillon de nouveau script pris en charge, Create Script prépare le format d’import FileMaker seulement lorsque vous choisissez cette action. Genie affiche la progression et confirme la création du script. Les conversions non prises en charge échouent de façon sûre et laissent Preview, Copy ou le flux Apply applicable disponibles.

Notifications Genie confirmant la préparation et la création réussie d'un script FileMaker

Routage DATA et QUERY

QUERY n’est pas un stage Workbench. Utilisez genie_query pour les SELECT en aperçu ou exécution hors Workbench.

Utilisez genie_stage_data pour les écritures SQL FileMaker prises en charge et le DDL table/rubrique que l’utilisateur confirmera dans Genie. Ne mélangez pas DATA et CODE dans le même item.

Les refus sont des guides

Les soumissions Workbench non prises en charge retournent des résultats MCP normaux ok: false. Ce ne sont généralement pas des erreurs de transport.

Ces résultats peuvent inclure recommended_actions, recommended_tool_calls, recommended_resources, stage_prompt_template ou metadata_precheck. L’agent IDE doit alors inspecter, séparer, réécrire ou présenter des instructions FileMaker manuelles localement, puis ne repréparer que le travail Genie pris en charge.