Dynamo MCP
MCP est l’abréviation de Model Context Protocol. Il s’agit d’une norme ouverte qui permet aux modèles d’IA de se connecter à des logiciels au moyen d’un protocole commun. Un serveur MCP expose les outils et les données d’un programme afin qu’un client IA puisse lire le contexte en temps réel, effectuer des actions et renvoyer des résultats structurés.
DynamoMCP est le serveur MCP intégré de Dynamo. Il connecte Autodesk Assistant à votre session Dynamo active (graphique, nœuds, fils et état de l’espace de travail), afin que l’aide de l’IA repose sur ce que vous êtes réellement en train de faire.
Pour les utilisateurs de Dynamo, cela signifie qu’Assistant peut faire plus que répondre à des questions générales. Il peut examiner le graphique ouvert, aider à résoudre les problèmes de nœuds et mettre à jour la zone de dessin en s’appuyant sur le contexte réel de la session, sans copier-coller manuel.
DynamoMCP est disponible dans Dynamo 4.2.0 et versions ultérieures.
Comment utiliser DynamoMCP
Vous utilisez DynamoMCP par l’intermédiaire d’Autodesk Assistant : il n’y a ni configuration distincte ni interface autonome. Assistant est le point d’entrée pour poser des questions, obtenir de l’aide sur votre graphique et permettre à l’IA de travailler avec le contexte Dynamo en temps réel.
L’endroit où vous ouvrez Assistant dépend de l’environnement dans lequel vous travaillez :
Dynamo Sandbox : les outils MCP de Dynamo sont disponibles dans Autodesk Assistant, au sein de Dynamo ;
Revit : les outils MCP de Dynamo sont disponibles dans Autodesk Assistant, au sein de Revit.
Dans les deux cas, vous restez dans votre session en cours et passez par le même Assistant pour accéder à DynamoMCP.
Ce que DynamoMCP peut faire
DynamoMCP fournit à Assistant un ensemble d’outils. Chaque outil effectue une tâche dans Dynamo, comme lire la zone de dessin, placer un nœud ou exécuter le graphique. Vous n’appelez jamais ces outils vous-même. Vous décrivez ce que vous voulez en langage courant, et Assistant choisit les outils dont il a besoin.
Il reste toutefois utile de connaître ces outils. Vous savez ainsi ce dont Assistant est capable, et vous formulez plus facilement des demandes qu’il peut traiter.
Lire le graphique actuel
Ces outils permettent à Assistant de voir sur quoi vous travaillez avant de répondre ou d’apporter une modification.
get_workspace_info
Répertorie le contenu de la zone de dessin : nœuds, fils, groupes, notes et détails de l’espace de travail.
get_selection
Indique les nœuds, les fils et les groupes sélectionnés.
get_node_connections
Indique à quoi un nœud est relié, port par port.
get_node_property
Indique les paramètres des nœuds, comme l’aperçu, le gel, l’aperçu épinglé et les étiquettes.
get_node_lacing
Indique le paramètre de combinaison d’un nœud.
get_installation_info
Indique votre version de Dynamo, l’hôte dans lequel vous travaillez et un lien vers les informations sur la nouvelle version.
Exemple d’invite : « Qu’y a-t-il dans ma zone de dessin en ce moment ? »
Trouver le bon nœud
Dynamo comporte des milliers de nœuds, y compris ceux des packages installés. Ces outils aident Assistant à choisir le bon nœud au lieu de le deviner.
get_nodes_info
Effectue une recherche dans la bibliothèque de nœuds, y compris les nœuds de package, et renvoie le nœud exact à placer.
get_node_help
Renvoie l’aide d’un nœud et le chemin de son graphique d’exemple, s’il en existe un.
get_type_schema
Renvoie le format de données attendu pour un type Dynamo, tel que Point, Number ou Color.
Exemple d’invite : « Quel nœud dois-je utiliser pour obtenir l’aire d’une surface ? »
Créer et modifier le graphique
Ces outils effectuent le travail dans la zone de dessin.
create_nodes
Place un ou plusieurs nœuds dans la zone de dessin, avec des valeurs de départ facultatives.
set_node_value
Définit la valeur des nœuds d’entrée tels que Number, String, Code Block et les listes déroulantes.
connect_nodes
Relie un port de sortie à un port d’entrée.
disconnect_nodes
Supprime les fils entre deux nœuds.
delete_node
Supprime un nœud de la zone de dessin.
rename_node
Renomme les nœuds d’entrée et les nœuds Watch pour que leur rôle soit clair. Les nœuds de fonction conservent leur nom d’origine.
select_nodes
Sélectionne des nœuds dans la zone de dessin pour vous montrer ceux dont parle Assistant.
set_node_property
Active ou désactive des paramètres de nœud : aperçu, gel, aperçu épinglé, étiquettes et entrée ou sortie.
set_node_lacing
Définit la combinaison sur Auto, Le plus court, Le plus long ou Produit vectoriel.
set_node_port_list_at_level
Définit le niveau de liste sur un port d’entrée.
Exemple d’invite : « Ajouter un curseur de nombre et le relier à l’entrée radius de mon cercle. »
Organiser et documenter le graphique
Un graphique fonctionnel n’est pas forcément lisible. Ces outils gèrent la disposition, le regroupement, les couleurs et les notes.
create_group
Place un groupe autour d’un ensemble de nœuds.
create_groups
Crée plusieurs groupes en une seule étape.
ungroup_by_guid
Supprime un groupe. Les nœuds qu’il contient restent dans la zone de dessin.
ungroup_by_title
Supprime des groupes d’après leur titre. Les nœuds qu’ils contiennent restent dans la zone de dessin.
get_available_group_styles
Répertorie les styles de groupe disponibles, y compris les styles personnalisés définis dans vos préférences.
assign_group_styles
Applique des styles de groupe, comme Entrées, Actions, Sorties et Révision.
get_notes
Répertorie les notes du graphique.
create_notes
Ajoute des notes expliquant certaines parties du graphique.
update_notes
Modifie le texte d’une note ou la déplace.
delete_notes
Supprime des notes.
set_note_state
Épingle une note à un nœud pour que les deux se déplacent ensemble, ou la détache.
auto_layout_workspace
Réorganise les nœuds à l’aide de la disposition automatique intégrée de Dynamo.
set_workspace_description
Écrit une description du graphique dans les propriétés du fichier.
Exemple d’invite : « Regrouper ce graphique par entrées, actions et sorties avec un code couleur, puis ajouter de courtes notes. »
Exécuter le graphique et vérifier les résultats
run_workspace
Exécute le graphique actuel. En mode automatique, le graphique est déjà réexécuté à chaque modification : cette étape est donc ignorée.
get_workspace_warnings
Répertorie les nœuds qui présentent des avertissements ou des erreurs, le texte du message et les prochaines étapes suggérées. Le graphique doit d’abord être exécuté.
get_node_output_values_shapes
Résume les valeurs de sortie d’un nœud ou de chaque nœud du graphique.
get_node_output_value
Lit la sortie complète d’un seul nœud, page par page, lorsque le résultat est trop volumineux pour être résumé.
Exemple d’invite : « Exécuter le graphique et m’expliquer pourquoi le nœud List.GetItemAtIndex affiche un avertissement. »
Utiliser des fichiers de graphique
Assistant peut aussi travailler avec des graphiques enregistrés sur le disque, et pas seulement avec celui qui est ouvert.
new_workspace
Ouvre un nouveau graphique vide. Si le graphique actuel comporte des modifications non enregistrées, vous êtes d’abord invité à les enregistrer ou à les abandonner.
save_workspace
Enregistre le graphique actuel. Si aucun emplacement n’est indiqué, il est enregistré dans votre dossier Dynamo, sous Documents.
edit_graph_from_path
Ouvre un graphique enregistré pour le modifier, sans l’exécuter.
insert_graph_from_path
Fusionne un graphique enregistré dans votre zone de dessin actuelle. C’est ainsi que les graphiques d’exemple des nœuds sont importés.
run_graph_from_path
Exécute un graphique enregistré, avec les valeurs d’entrée facultatives que vous fournissez.
run_graph_from_json
Exécute un graphique fourni au format JSON Dynamo, sans fichier sur le disque.
get_graph_info_from_path
Lit les entrées, les sorties et les métadonnées d’un graphique enregistré sans l’ouvrir.
get_graph_info_from_json
Lit les mêmes informations à partir d’un graphique fourni au format JSON Dynamo.
get_graphs_info_from_path
Analyse un dossier de graphiques et indique le contenu de chacun d’eux.
get_available_graphs_folders
Répertorie les dossiers dont Dynamo a connaissance et qui peuvent contenir des graphiques.
Exemple d’invite : « Parcourir mon dossier de graphiques Dynamo et m’indiquer quels graphiques placent des murs. »
Last updated