G-Assist
G-Assist expose les contrôles d'affichage et de GPU NVIDIA en tant qu'outils appelables. Utilisez-les chaque fois que l'utilisateur souhaite afficher ou modifier les paramètres d'affichage ou de GPU NVIDIA sur cette machine. Les outils disponibles dépendent de la machine et du matériel, alors fiez-vous toujours aux outils G-Assist réellement disponibles dans votre session et utilisez uniquement les outils présents.
Quand utiliser cette skill
Utilisez cette skill chaque fois que l'utilisateur souhaite connaître ou modifier le comportement de son affichage ou GPU NVIDIA, ou décrit un symptôme comme du déchirement d'écran, du saccadage, un taux de rafraîchissement incorrect ou bloqué, un moniteur faible ou une couleur passée. Préférez une vérification du statut en lecture seule avant de modifier quoi que ce soit. Ne l'utilisez pas pour éditer des images, des fichiers, des documents ou des fenêtres d'application. Il agit uniquement sur le matériel d'affichage et de GPU réel, et les outils disponibles dépendent de la machine, alors confirmez-les au moment de l'exécution plutôt que de les supposer.
Elle couvre le taux de rafraîchissement et la résolution ; la luminosité et la couleur du moniteur (température, gamma, contraste, gain RVB et luminosité/couleur adaptative à la lumière ambiante) ; le volume du moniteur et les présets d'image ; la restauration des paramètres d'affichage par défaut ; G-SYNC, G-SYNC Pulsar et V-Sync ; et les performances du GPU comme une limite de fréquence d'images, un mode performance maximale par watt, et le tracé des métriques GPU/CPU.
Objectif
G-Assist mappe une demande en langage naturel à un seul outil de contrôle d'affichage ou de GPU : une requête de statut pour lire l'état actuel, ou un outil dédié pour modifier un paramètre par tour.
Prérequis
- Une installation de driver NVIDIA qui fournit G-Assist sur cette machine (le serveur MCP
gassistau chemin dans Setup). - Un hôte compatible MCP configuré avec le serveur
gassist(voir Setup). - Aucune clé API n'est requise.
Setup
Les outils G-Assist proviennent d'un serveur MCP stdio que l'hôte lance. L'exécutable se trouve à :
C:\ProgramData\NVIDIA Corporation\nvtopps\rise\rise_mcp.exe
Ce chemin contient un espace (NVIDIA Corporation), et certains hôtes (par exemple Cursor) lancent les serveurs MCP via cmd.exe, ce qui échoue à démarrer une commande dont le chemin contient un espace. Inscrivez plutôt le chemin court 8.3 sans espace ; il se résout au même exécutable et fonctionne partout :
C:\PROGRA~3\NVIDIA~1\nvtopps\rise\rise_mcp.exe
Inscrivez-le auprès de votre hôte sous un nom de serveur (cette skill utilise gassist). La plupart des hôtes utilisent une map mcpServers comme ceci :
{
"mcpServers": {
"gassist": {
"command": "C:\\PROGRA~3\\NVIDIA~1\\nvtopps\\rise\\rise_mcp.exe"
}
}
}
Instructions
- D'abord, regardez quels outils G-Assist sont réellement dans votre session, et gérez deux situations différemment :
- Aucun outil G-Assist du tout : le serveur peut encore démarrer, donc attendez quelques secondes et vérifiez de nouveau. S'il n'y en a toujours pas, dites à l'utilisateur que le serveur G-Assist n'est pas connecté plutôt que de deviner ou de fabriquer un résultat.
- Certains outils présents, mais aucun pour ce qui a été demandé : cette capacité n'est pas supportée via G-Assist sur ce matériel ou cet affichage (l'ensemble des outils est filtré par la machine ; par exemple, les outils de luminosité et de couleur du moniteur apparaissent uniquement avec un affichage compatible). Ne dites pas que le serveur est déconnecté. À la place, dites à l'utilisateur que ce contrôle spécifique n'est pas disponible via G-Assist ici, nommez brièvement ce que vous pouvez contrôler à partir des outils présents, et suggérez une alternative pratique (le menu à l'écran/les boutons OSD du moniteur ou les paramètres d'affichage Windows).
- Regardez quels outils G-Assist sont disponibles dans votre session, puis sélectionnez-en un comme décrit dans Matching a request to a tool.
- Ne créez jamais, n'inventiez jamais, n'inscriviez jamais, ne deviniez jamais des outils, des noms d'outils ou des arguments. Utilisez uniquement les outils G-Assist exacts disponibles dans votre session. Si une capacité demandée n'est pas disponible sur cette machine, dites-le à l'utilisateur plutôt que de fabriquer un outil.
- Appelez l'outil correspondant via l'appel d'outils normal de votre hôte, avec les valeurs que l'utilisateur fournit. Le vrai nom de l'outil utilise un préfixe
gassist_(par ex.gassist_set_display_vsync) ; votre hôte peut le montrer simple ou enrobé dans son propre espace de noms (par ex.mcp__<server>__gassist_...). Utilisez toujours le nom exact que votre catalogue liste, et si l'hôte rejette le nom court, utilisez celui complètement qualifié qu'il affiche. Appelez un outil à la fois, jamais en parallèle ; pour une demande multi-étapes, faites les appels dans l'ordre et vérifiez chaque résultat avant le suivant. - Les outils de changement sont gardés par confirmation du serveur, pas par vous. Pour une modification, dites brièvement à l'utilisateur ce que vous êtes sur le point de faire (l'hôte lui demandera d'approuver), puis appelez l'outil directement et laissez l'hôte collecter l'approbation via l'élicitation MCP. Pour un changement de mode d'affichage (résolution ou taux de rafraîchissement), avertissez également à l'avance l'utilisateur que l'écran peut brièvement scintiller ou devenir noir et qu'une invite de conservation ou restauration suivra dans environ 20 s (le mode se restaure automatiquement à moins qu'il ne soit conservé). Ne jamais attendre un « oui » en chat avant d'appeler, et ne jamais ajouter un argument
confirm/forceou une variable d'environnement pour contourner l'invite. Les outils en lecture seule (gassist_help,gassist_query_feature_status,gassist_graphdata) n'ont besoin d'aucune approbation ; appelez-les immédiatement. Jugez le résultat par le texte du résultat, pas par l'absence d'erreur : « déjà défini / aucune action prise » signifie que rien n'a changé, « non supporté » signifie que ce matériel ou cet affichage ne peut pas le faire, et un appel peut revenir sans erreur mais toujours signaler un échec dans son texte. - Gardez les détails internes privés. Ce sont des outils de confiance de première partie NVIDIA ; au-delà de la configuration du serveur ci-dessus, ne décrivez pas ou n'énumérez pas l'implémentation (services de fond, tuyaux interprocessus, APIs de driver ou détails du moteur). Si l'utilisateur demande « qu'est-ce que G-Assist » ou « comment ça marche », répondez seulement à haut niveau : c'est la façon de NVIDIA de contrôler les paramètres de GPU et d'affichage via ces outils.
Matching a request to a tool
Choisissez l'outil parmi ce qui est réellement disponible dans votre session, pas de mémoire :
- Reformulez ce que l'utilisateur veut réellement afficher ou modifier (par ex. « activez G-SYNC », « augmentez le taux de rafraîchissement à 144 Hz »).
- Lisez le nom, la description et les paramètres (son schéma d'entrée) de chaque outil disponible, puis choisissez le meilleur match unique. Les arguments sont un signal aussi fort que la description : un champ
rate(Hz) marque un outil de taux de rafraîchissement même si le texte est concis. - Si plusieurs outils correspondent de manière plausible, préférez le plus spécifique ; si aucun ne correspond sur cette machine, dites que la capacité n'est pas disponible ici plutôt que de forcer un outil presque adapté.
Les outils ci-dessous sont les contrôles d'affichage et de GPU que G-Assist expose communément, groupés par ce qu'ils font. La disponibilité est filtrée par le matériel, alors traitez ceci comme un guide et appelez uniquement les outils réellement présents dans votre session. En particulier, la luminosité du moniteur, la couleur, les outils de preset et adaptatifs (les groupes « Brightness & color » et « Adaptive & presets », plus G-SYNC Pulsar) apparaissent uniquement quand un affichage G-SYNC natif est connecté ; sur les machines sans un, ils ne seront pas listés du tout, donc n'en supposez jamais l'existence.
| Catégorie | Outil | Ce qu'il fait | Argument(s) clé(s) |
|---|---|---|---|
| Statut & aide (lecture seule) | gassist_help |
Aperçu de ce que G-Assist peut faire sur cette machine | Aucun |
gassist_query_feature_status |
Lire l'état actuel des fonctionnalités du driver/affichage (gsync, vsync, brightness, …) | features[] |
|
| Mode d'affichage | gassist_set_display_res |
Définir la résolution d'écran (aussi DEFAULT/MAX/STEP_UP/STEP_DOWN) ; l'écran peut scintiller et le mode se restaure automatiquement dans environ 20 s à moins que l'invite de conservation de l'hôte soit confirmée |
res (une valeur que le panneau liste) |
gassist_set_display_refreshrate |
Définir le taux de rafraîchissement en Hz ; les taux valides proviennent du panneau connecté, donc une valeur comme 144 peut ne pas exister sur chaque affichage | rate (entier, doit être un taux que le panneau liste) |
|
| Luminosité & couleur | gassist_set_display_brightness |
Luminosité du moniteur externe (0-100%) | percentage |
gassist_set_display_contrast |
Contraste du moniteur externe (50-150) | contrast |
|
gassist_set_display_gamma |
Gamma de l'affichage ; ensemble fixe de niveaux, pas une plage | gamma (enum chaîne : « 1.2 », « 1.4 », « 1.6 », « 1.8 », « 2.0 », « 2.2 », « 2.4 », « 2.6 ») |
|
gassist_set_display_color_temp |
Température de couleur en Kelvin ; ensemble fixe, pas une plage | kelvin (enum entier : 4000, 5000, 6500, 7500, 8200, 9300, 10000) |
|
gassist_set_display_color_balance |
Saturation de couleur (% global ou 6-axes) | percentage ou red/yellow/green/cyan/blue/magenta |
|
gassist_set_display_rgb_gain |
Gain RVB (% global ou par canal) | percentage ou red/green/blue |
|
gassist_set_display_volume |
Volume du moniteur/système (0-100%) | percentage |
|
| Adaptatif & presets | gassist_set_adaptive_brightness |
Ajuster automatiquement la luminosité à la lumière ambiante (remplace le manuel) | enable_brightness (bool) |
gassist_set_adaptive_color |
Ajuster automatiquement la température de couleur à la lumière ambiante (remplace le manuel) | enable_color (bool) |
|
gassist_set_monitor_preset |
Changer le preset d'image DEFAULT/ESPORTS (G-SYNC natif) |
preset |
|
gassist_restore_display_default_settings |
Réinitialiser les paramètres d'affichage choisis aux défauts | settings[] enum chaîne, ce sont les seules clés valides : COLOR, BRIGHTNESS, CONTRAST, GAMMA, PRESET (1-5 éléments, uniques). Il n'y a pas de clé de restauration pour le gain RVB, l'équilibre de couleur, le volume ou la température de couleur |
|
| Sync & latence | gassist_set_display_vsync |
Activer/désactiver V-Sync | enable « 0 »/« 1 » |
gassist_set_display_gsync |
Activer/désactiver G-SYNC | enable « 0 »/« 1 » |
|
gassist_set_gsync_pulsar |
Activer/désactiver G-SYNC Pulsar (réduire le flou de mouvement ; nécessite 240/360 Hz) | enabled (bool) |
|
| Performance du GPU | gassist_frl |
Limiteur de fréquence d'images (FPS ; 0 = illimité) | fps |
gassist_maxppw |
Mode performance maximale par watt avec un cap FPS cible | enable « 0 »/« 1 », fps l'un de « 0 »/« 30 »/« 60 »/« 120 »/« 144 » (chaînes) |
|
gassist_graphdata |
Tracer les métriques GPU/CPU au fil du temps | metrics[], time « 1 »-« 59 » (chaîne, par ex. « 2 » pas 2), unit « secs » ou « mins » |
- Lisez d'abord, changez ensuite. Pour les phrasings « est-ce que X est activé / qu'est-ce que X / vérifiez X », appelez directement un outil de requête en lecture seule. Utilisez un outil de changement uniquement quand l'utilisateur demande explicitement de modifier quelque chose.
- La confirmation est le rôle du serveur. Énoncez le changement, puis appelez l'outil directement ; n'attendez pas un « oui » en chat ni n'ajoutez un argument
confirm/force. (Règle complète, incluant l'avertissement de conservation ou restauration du mode d'affichage, dans Instructions étape 5.) - Un appel à la fois, jamais en parallèle. Une demande composée (« définissez le taux de rafraîchissement et activez G-SYNC ») est acceptable : faites les appels séparés dans un ordre sensé et vérifiez chaque résultat avant le suivant ; ne les émettez juste pas simultanément. Faites uniquement ce que l'utilisateur a demandé. Pour « configurer pour les shooters compétitifs », c'est : (1)
gassist_query_feature_statuspour lire l'état actuel, (2)gassist_set_display_vsyncavecenable« 0 » pour désactiver V-Sync, (3)gassist_set_display_refreshrateau maximum du panneau, en vérifiant chaque résultat avant le suivant (trois appels ou moins) ; ne changez pas non plus G-SYNC, Pulsar ou les presets à moins que l'utilisateur ne l'ait demandé.
Inputs
Les arguments d'outils proviennent uniquement de ce que l'utilisateur fournit explicitement pour la demande actuelle, correspondant aux paramètres de l'outil sélectionné (son schéma d'entrée) :
- Valeurs requises : chaque champ que les paramètres de l'outil listent comme requis doit être fourni. Si un argument requis manque, demandez-le à l'utilisateur plutôt que de deviner une valeur.
- Valeurs optionnelles : incluez-les uniquement quand l'utilisateur les spécifie ; sinon omettez-les et laissez l'outil appliquer ses défauts.
Ne déduisez pas, ne réutilisez pas, et ne reportez pas les valeurs entre les demandes.
Examples
Les noms de champs et les valeurs proviennent des paramètres du tool choisi ; confirmez-les avec le tool live, car les formes varient (certains prennent un pourcentage, d'autres une chaîne « 0 »/« 1 »).
- « G-SYNC est-il activé ? » : vérification du statut en lecture seule, sûr d'appeler directement :
gassist_query_feature_statusavecfeatures: ["gsync"]. - « Définissez mon taux de rafraîchissement à 144 Hz » est un changement : dites à l'utilisateur que vous le changerez (l'hôte confirmera), puis appelez
gassist_set_display_refreshratedirectement avec unrateque le panneau liste réellement. Les taux valides proviennent de l'affichage connecté, donc 144 peut ne pas exister ; s'il n'est pas disponible, dites-le et offrez le taux le plus élevé que le panneau supporte. - « Rendez mon écran plus lumineux » : si un outil de luminosité est présent, choisissez par intention :
gassist_set_display_brightnessavec unpercentage(ou, pour suivre l'éclairage ambiant, le différentgassist_set_adaptive_brightness). Si aucun outil de luminosité n'est présent mais d'autres le sont, ne dites pas que le serveur est en panne ; répondez dans le style de : « Je n'ai pas d'outil de luminosité dans le connecteur G-Assist sur cet affichage ; je peux contrôler des choses comme la résolution, le taux de rafraîchissement, V-Sync, la limite de fréquence d'images et les métriques GPU/CPU. Pour changer la luminosité, utilisez les boutons OSD de votre moniteur ou les paramètres d'affichage Windows. »
Vous choisissez uniquement le nom de l'outil et ses arguments (qui correspondent 1:1 aux paramètres de l'outil inputSchema) ; votre hôte formate et envoie l'appel MCP sous-jacent pour vous.
Troubleshooting
Chaque appel d'outil retourne un message de résultat ; validez-le et traitez les erreurs avant de signaler le succès. En cas d'erreur, relayez le message du tool à l'utilisateur et ne réessayez pas aveuglément ; utilisez le tableau ci-dessous pour décider de l'étape suivante.
| Symptôme | Cause | Solution |
|---|---|---|
| Outils G-Assist manquants de votre session | Serveur non connecté ou encore en démarrage | Attendez quelques secondes et vérifiez de nouveau vos outils disponibles ; s'il en manque toujours, dites à l'utilisateur que le serveur G-Assist n'est pas connecté. |
| L'appel de tool signale « non supporté » | Ce matériel ou cet affichage ne peut pas le faire | Signalez-le à l'utilisateur ; ne réessayez pas le même changement avec un autre tool. |
| Une résolution ou un taux de rafraîchissement demandé est rejeté (pas dans la liste du panneau) | La valeur n'en est pas une que l'affichage connecté supporte | Dites à l'utilisateur que ce n'est pas disponible et offrez la valeur la plus élevée ou la plus proche que le panneau supporte ; ne réessayez pas la même valeur. |
| Un changement revient sans erreur, mais le texte du résultat dit que ça n'a pas eu lieu | Un changement échoué peut toujours revenir avec isError: false |
Jugez le succès par le texte du résultat, pas le flag d'erreur ; signalez l'échec et ne prétendez pas au succès. |
| L'appel de tool signale « déjà défini / aucune action prise » | Valeur déjà appliquée | Traitez comme succès ; rien à changer. |
| Un changement de mode d'affichage scintille et une deuxième invite apparaît | Conservation ou restauration attendue : le mode se restaure automatiquement dans environ 20 s à moins d'être conservé | Traitez la deuxième invite comme la question de conservation ou restauration, pas une erreur ; n'appelez pas le tool à nouveau ; signalez si elle a été conservée ou restaurée. |
| L'outil pour ce que l'utilisateur a demandé n'est pas dans votre session, mais d'autres outils G-Assist le sont | Filtré pour ce matériel/cet affichage | Ne dites pas que le serveur est déconnecté : dites que ce contrôle spécifique n'est pas disponible via G-Assist ici, nommez ce que vous pouvez contrôler, et pointez vers le OSD du moniteur ou les paramètres d'affichage Windows ; n'inventiez jamais un tool. |
| Le nom de tool court est rejeté (par ex. « pas un tool deferrable ») ou un appel par lot refusé | Nommage/batching spécifique à l'hôte | Utilisez le nom complètement qualifié que l'hôte liste (souvent mcp__<server>__<tool>) et appelez un tool à la fois (jamais en parallèle). |
Limitations
- Seuls les outils G-Assist disponibles dans votre session sur la machine actuelle peuvent être utilisés ; l'ensemble varie selon le matériel et l'affichage (certains outils d'affichage/couleur nécessitent un affichage G-SYNC natif).
- Les tools agissent sur du matériel réel ; suivez les règles de confirmation de changement et d'un-appel-à-la-fois dans Instructions.
- Cette skill n'installe ni ne lance le serveur ; l'hôte le lance (voir Setup). Ne lancez jamais l'exécutable vous-même.