Antes de empezar
- Instale el GDK. En los ejemplos se usa el GDK de octubre de 2026 (edición
261000). Reemplace261000por la edición con la que se compila su juego. - Use un agente que pueda conectarse a un servidor de Model Context Protocol (MCP), leer archivos de su equipo o ejecutar comandos. La mayoría de los agentes de codificación pueden hacer las tres cosas.
- Averigüe qué herramientas de IA aprueba su organización para contenido confidencial. La documentación, los encabezados y las herramientas del GDKX son confidenciales.
Elegir el contexto del GDK que se proporcionará al agente
Las fuentes en línea describen el GDK actual. Si compila con un GDK anterior, proporcione también al agente los encabezados instalados y la documentación sin conexión, para que no use API que su GDK no tiene.
Conectar el servidor MCP de la documentación de XBOX
El servidor MCP de la documentación de XBOX enhttps://docs.xbox.com/mcp permite que un agente busque y cite la documentación publicada. No requiere una clave de API ni iniciar sesión. Por ejemplo, en Visual Studio Code, agregue el servidor a un archivo .vscode/mcp.json de su proyecto:
.vscode/mcp.json
https://docs.xbox.com/llms.txtenumera todas las páginas con una breve descripción.https://docs.xbox.com/llms-full.txtcontiene el texto completo de la documentación en un solo archivo.- Agregue
.mdal final de la URL de cualquier página para obtener esa página en Markdown.
Proporcionar al agente la documentación sin conexión
El GDKX instala la documentación del GDK como archivos Markdown enGDKDocumentationMarkdown.zip, en la carpeta xbox\documentation de la edición del GDK. Como los archivos coinciden con el GDK que instaló, son la fuente de documentación más precisa para esa versión.
Cada página comienza con frontmatter YAML. El valor permissioned-type indica la clasificación de acceso de la página: public, private o secret. El archivo site-map.md de la raíz del archivo comprimido enumera las páginas.
-
Extraiga el archivo comprimido en una carpeta fuera de su repositorio de código fuente. En PowerShell, ejecute los siguientes comandos.
-
Si su herramienta de IA no está aprobada para contenido confidencial, conserve solo las páginas públicas. El siguiente comando elimina todos los archivos Markdown cuyo
permissioned-typeno seapublic, incluidos los archivos que no tienen ese campo. - Conceda al agente acceso a la carpeta. Por ejemplo, agréguela al área de trabajo de su editor o indíquela en el archivo de instrucciones del proyecto.
Indicar al agente los encabezados y las herramientas instalados
El instalador del GDK establece variables de entorno que indican al agente la ubicación del GDK instalado:GameDKes la carpeta raíz del GDK. Contiene la carpetabinde herramientas de línea de comandos y una carpeta para cada edición instalada, como%GameDK%261000\.GameDKCoreLatestyGameDKXboxLatestapuntan a la edición instalada más reciente.
%GameDK%261000\, en lugar de estas variables.
Para conocer las carpetas de cada edición, consulte Estructura de directorios de encabezados y bibliotecas del GDK. Indique al agente que, antes de usar una API, compruebe las declaraciones en los encabezados de la carpeta windows\include de la edición para PC, o de su carpeta xbox\include para consolas XBOX. Algunos encabezados, como los de la API de servicios de XBOX (XSAPI), libHttpClient y PlayFab, también incluyen comentarios de documentación que describen cada API.
Las herramientas de línea de comandos de %GameDK%bin muestran su uso cuando se ejecutan con /?. Un agente puede ejecutar /? en una herramienta antes de usarla, en lugar de adivinar sus opciones. Para traducir un HRESULT a una descripción, use xberror.exe:
Proporcionar al agente código de ejemplo que coincida con su versión
Use la lista de ejemplos del GDK de XBOX para encontrar ejemplos de la característica que está implementando. Consulte los archivos README del repositorio y de los ejemplos para conocer la versión del GDK, la estructura de directorios y los requisitos de plataforma. Si la rama principal no coincide con su proyecto, elija una versión de los ejemplos compatible. Clone o descargue la versión compatible y proporcione al agente las rutas locales al código fuente y al archivo README del ejemplo correspondiente. Pídale que siga los patrones de inicialización, control de errores, duración asincrónica y limpieza del ejemplo. Indique al agente que compruebe las API con los encabezados instalados en lugar de copiar la configuración del proyecto de una estructura de GDK diferente.Permitir que el agente compile desde la línea de comandos
Para compilar, un agente necesita el mismo entorno que un Gaming Command Prompt. EjecuteGamingDesktopVars.cmd con los argumentos que usa el acceso directo del menú Inicio y, a continuación, ejecute la compilación en el mismo proceso de cmd:
GamingDesktopVS2022 para Visual Studio 2022. El entorno no se conserva entre comandos independientes, por lo que el agente debe ejecutar el script y la compilación juntos.
Agregar un archivo de instrucciones del proyecto
La mayoría de los agentes de codificación leen un archivo de instrucciones del proyecto, comoAGENTS.md o .github/copilot-instructions.md, en la raíz del repositorio. Úselo para proporcionar el mismo contexto del GDK en todas las sesiones del agente. Parta del siguiente ejemplo y reemplace los valores entre corchetes angulares.
AGENTS.md
