Avant de commencer
- Installez le GDK. Les exemples utilisent le GDK d’octobre 2026 (édition
261000). Remplacez261000par l’édition avec laquelle votre jeu est compilé. - Utilisez un agent capable de se connecter à un serveur MCP (Model Context Protocol), de lire des fichiers sur votre ordinateur ou d’exécuter des commandes. La plupart des agents de codage peuvent 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 compilez avec un GDK antérieur, fournissez aussi à l’agent les en-têtes installés et la documentation hors ligne, afin qu’il n’utilise pas d’API que votre GDK ne contient pas.
Connecter le serveur MCP de la documentation XBOX
Le serveur MCP de la documentation XBOX, à l’adressehttps://docs.xbox.com/mcp, permet à un agent de rechercher et de citer la documentation publiée. Il ne nécessite ni clé API ni connexion. Par exemple, dans Visual Studio Code, ajoutez le serveur à un fichier .vscode/mcp.json dans votre projet :
.vscode/mcp.json
https://docs.xbox.com/llms.txtrépertorie toutes les pages avec une courte description.https://docs.xbox.com/llms-full.txtcontient le texte intégral de la documentation dans un seul fichier.- Ajoutez
.mdà la fin de l’URL de n’importe quelle page pour obtenir cette page en Markdown.
Fournir à l’agent la documentation hors ligne
Le GDKX installe la documentation du GDK sous forme de fichiers Markdown dansGDKDocumentationMarkdown.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 exacte pour cette version.
Chaque page commence par un bloc 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.
-
Extrayez l’archive dans un dossier situé à l’extérieur de votre dépôt de code source. Dans PowerShell, exécutez les commandes suivantes.
-
Si votre outil d’IA n’est pas approuvé pour le contenu confidentiel, conservez uniquement les pages publiques. La commande suivante supprime tous les fichiers Markdown dont la valeur
permissioned-typen’est paspublic, y compris les fichiers qui n’ont pas ce champ. - 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.
Diriger l’agent vers les en-têtes et les outils installés
Le programme d’installation du GDK définit des variables d’environnement qui indiquent à l’agent l’emplacement du GDK installé :GameDKest le dossier racine du GDK. Il contient le dossierbindes outils en ligne de commande et un dossier pour chaque édition installée, comme%GameDK%261000\.GameDKCoreLatestetGameDKXboxLatestpointent vers l’édition installée la plus récente.
%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 PC, ou de son dossier xbox\include pour les consoles XBOX, avant d’utiliser une API. Certains en-têtes, comme ceux de l’API des services XBOX (XSAPI), de libHttpClient et de PlayFab, comprennent aussi des commentaires de documentation qui décrivent chaque API.
Les outils en ligne de commande de %GameDK%bin affichent leur mode d’emploi lorsque vous les exécutez avec /?. Un agent peut exécuter /? sur un outil avant de l’utiliser, au lieu de deviner ses options. Pour traduire un HRESULT en description, utilisez xberror.exe :
Fournir à l’agent un exemple de code adapté à votre version
Utilisez la liste des exemples XBOX GDK pour trouver des exemples de la fonctionnalité que vous mettez en œuvre. Consultez les fichiers README du dépôt 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 du code source et du fichier README de l’exemple pertinent. Demandez-lui de suivre les modèles de l’exemple pour l’initialisation, la gestion des erreurs, la durée de vie des opérations asynchrones et le nettoyage. Demandez à l’agent de vérifier les API dans vos en-têtes installés plutôt que de copier les paramètres de projet d’une autre disposition du GDK.Laisser l’agent compiler à partir de la ligne de commande
Pour compiler, un agent a besoin du même environnement qu’une invite de commandes Gaming. ExécutezGamingDesktopVars.cmd avec les arguments qu’utilise le raccourci du menu Démarrer, puis exécutez la compilation dans le même processus cmd :
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 compilation ensemble.
Ajouter un fichier d’instructions de projet
La plupart des agents de codage lisent un fichier d’instructions de projet, commeAGENTS.md ou .github/copilot-instructions.md, à la racine de votre dépôt. 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
