Passer au contenu principal
Les agents de codage IA, tels que GitHub Copilot, Claude Code, Codex et Cursor, écrivent un meilleur code GDK lorsqu’ils s’appuient sur les API et la documentation du GDK avec lequel vous générez votre jeu, plutôt que sur ce dont leur modèle se souvient. Cet article décrit le contexte GDK que vous pouvez fournir à un agent et explique comment configurer chaque source. Ces recommandations s’appliquent au Microsoft Game Development Kit (GDK) et au Microsoft GDK avec XBOX Extensions (GDKX) sur un ordinateur de développement PC Windows.

Avant de commencer

  • Installez le GDK. Les exemples utilisent le GDK d’octobre 2026 (édition 261000). Remplacez 261000 par l’édition avec laquelle votre jeu est généré.
  • Utilisez un agent capable de se connecter à un serveur Model Context Protocol (MCP), de lire des fichiers sur votre ordinateur ou d’exécuter des commandes. La plupart des agents de codage savent faire les trois.
  • Renseignez-vous sur les outils d’IA que votre organisation approuve pour le contenu confidentiel. La documentation, les en-têtes et les outils du GDKX sont confidentiels.

Choisir le contexte GDK à fournir à l’agent

Les sources en ligne décrivent le GDK actuel. Lorsque vous générez votre jeu avec un GDK antérieur, fournissez également à l’agent les en-têtes installés et la documentation hors connexion, afin qu’il n’utilise pas d’API absentes de votre GDK.

Connecter le serveur MCP de la documentation XBOX

Le serveur MCP de la documentation XBOX, à l’adresse https://docs.xbox.com/mcp, permet à un agent d’effectuer des recherches dans la documentation publiée et de la citer. Il ne nécessite ni clé API ni connexion. Par exemple, dans Visual Studio Code, ajoutez le serveur à un fichier .vscode/mcp.json de votre projet :
.vscode/mcp.json
Pour connaître les étapes de configuration pour Claude Code, GitHub Copilot CLI, Cursor, Codex et Claude, consultez Utiliser cette documentation avec des outils d’IA sur la page d’accueil. Les agents qui ne peuvent pas utiliser MCP peuvent lire la documentation dans d’autres formats :
  • https://docs.xbox.com/llms.txt répertorie toutes les pages avec une brève description.
  • https://docs.xbox.com/llms-full.txt contient le texte intégral de la documentation dans un seul fichier.
  • Ajoutez .md à la fin de l’URL d’une page pour obtenir cette page au format Markdown.

Fournir à l’agent la documentation hors connexion

Le GDKX installe la documentation du GDK sous forme de fichiers Markdown dans GDKDocumentationMarkdown.zip, dans le dossier xbox\documentation de l’édition du GDK. Comme ces fichiers correspondent au GDK que vous avez installé, ils constituent la source de documentation la plus précise pour cette version. Chaque page commence par un frontmatter YAML. La valeur permissioned-type indique la classification d’accès de la page : public, private ou secret. Le fichier site-map.md, à la racine de l’archive, répertorie les pages.
L’archive contient des pages confidentielles. N’utilisez l’archive complète qu’avec des outils d’IA que votre organisation approuve pour le contenu confidentiel du GDKX. N’ajoutez pas les fichiers extraits à un référentiel public ni à un emplacement accessible en lecture à des personnes extérieures à votre organisation.
  1. Extrayez l’archive dans un dossier situé en dehors de votre référentiel source. Dans PowerShell, exécutez les commandes suivantes.
  2. Si votre outil d’IA n’est pas approuvé pour le contenu confidentiel, ne conservez que les pages publiques. La commande suivante supprime tous les fichiers Markdown dont la valeur permissioned-type n’est pas public, y compris les fichiers qui ne comportent pas ce champ.
  3. Donnez à l’agent l’accès au dossier. Par exemple, ajoutez-le à l’espace de travail de votre éditeur ou mentionnez-le dans votre fichier d’instructions de projet.
Extrayez de nouveau l’archive pour chaque édition du GDK que vous installez, dans un dossier nommé d’après cette édition.

Indiquer à l’agent les en-têtes et outils installés

Le programme d’installation du GDK définit des variables d’environnement qui indiquent à l’agent l’emplacement du GDK installé :
  • GameDK est le dossier racine du GDK. Il contient le dossier bin des outils en ligne de commande et un dossier pour chaque édition installée, par exemple %GameDK%261000\.
  • GameDKCoreLatest et GameDKXboxLatest pointent vers l’édition installée la plus récente.
Lorsque plusieurs éditions sont installées côte à côte, l’édition la plus récente n’est pas forcément celle avec laquelle votre jeu est généré. Fournissez à l’agent le dossier de l’édition utilisée par votre jeu, par exemple %GameDK%261000\, plutôt que ces variables. Pour connaître les dossiers de chaque édition, consultez Structure des répertoires d’en-têtes et de bibliothèques du GDK. Demandez à l’agent de vérifier les déclarations dans les en-têtes du dossier windows\include de l’édition pour le PC, ou de son dossier xbox\include pour les consoles XBOX, avant d’utiliser une API. Certains en-têtes, tels que ceux de l’API des services XBOX (XSAPI), de libHttpClient et de PlayFab, comportent également des commentaires de documentation qui décrivent chaque API. Les outils en ligne de commande situés dans %GameDK%bin affichent leur syntaxe d’utilisation lorsque vous les exécutez avec /?. Un agent peut exécuter la commande /? d’un outil avant de l’utiliser, au lieu de deviner ses options. Pour obtenir la description d’un HRESULT, utilisez xberror.exe :

Fournir à l’agent un exemple de code adapté à votre version

Utilisez la liste des exemples du GDK XBOX pour trouver des exemples de la fonctionnalité que vous implémentez. Consultez les fichiers README du référentiel et des exemples pour connaître la version du GDK, la disposition des répertoires et la configuration requise des plateformes. Si la branche principale ne correspond pas à votre projet, choisissez une version des exemples compatible. Clonez ou téléchargez la version compatible et fournissez à l’agent les chemins locaux vers le code source et le fichier README de l’exemple concerné. Demandez-lui de suivre les modèles d’initialisation, de gestion des erreurs, de durée de vie des opérations asynchrones et de nettoyage de l’exemple. Faites vérifier les API par l’agent dans vos en-têtes installés plutôt que de lui faire copier des paramètres de projet issus d’une autre disposition du GDK.

Laisser l’agent générer depuis la ligne de commande

Pour générer, un agent a besoin du même environnement qu’une invite de commandes Gaming Command Prompt. Exécutez GamingDesktopVars.cmd avec les arguments qu’utilise le raccourci du menu Démarrer, puis lancez la build dans le même processus cmd :
Utilisez GamingDesktopVS2022 pour Visual Studio 2022. L’environnement n’est pas conservé d’une commande distincte à l’autre ; l’agent doit donc exécuter le script et la build ensemble.

Ajouter un fichier d’instructions de projet

La plupart des agents de codage lisent un fichier d’instructions de projet, tel que AGENTS.md ou .github/copilot-instructions.md, à la racine de votre référentiel. Utilisez-le pour fournir le même contexte GDK à chaque session de l’agent. Partez de l’exemple suivant et remplacez les valeurs entre chevrons.
AGENTS.md

Vérifier le travail de l’agent

Avant de passer en revue une modification, demandez à l’agent de relire lui-même son travail. Par exemple, donnez-lui ce prompt :
L’autorelecture ne remplace pas votre propre revue. Passez en revue et testez le code écrit par l’agent comme n’importe quel autre code. Vérifiez les affirmations concernant la prise en charge des plateformes, les stratégies et les exigences de certification dans la documentation, et non dans la réponse de l’agent.

Voir aussi

Dernière modification le 19 novembre 2026