Saltar al contenido principal
Los agentes de codificación de IA, como GitHub Copilot, Claude Code, Codex y Cursor, escriben mejor código del GDK cuando trabajan a partir de las API y la documentación del GDK con el que compila, en lugar de basarse en lo que recuerda su modelo. En este artículo se describe el contexto del GDK que puede proporcionar a un agente y cómo configurar cada fuente. Esta guía se aplica al Microsoft Game Development Kit (GDK) y al Microsoft GDK con XBOX Extensions (GDKX) en un equipo de desarrollo con Windows.

Antes de empezar

  • Instale el GDK. En los ejemplos se usa el GDK de octubre de 2026 (edición 261000). Reemplace 261000 por 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 en https://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
Para ver los pasos de configuración de Claude Code, GitHub Copilot CLI, Cursor, Codex y Claude, consulte Usar esta documentación con herramientas de IA en la página principal. Los agentes que no pueden usar MCP pueden leer la documentación en otros formatos:
  • https://docs.xbox.com/llms.txt enumera todas las páginas con una breve descripción.
  • https://docs.xbox.com/llms-full.txt contiene el texto completo de la documentación en un solo archivo.
  • Agregue .md al 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 en GDKDocumentationMarkdown.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.
El archivo comprimido contiene páginas confidenciales. Use el archivo comprimido completo solo con herramientas de IA que su organización apruebe para contenido confidencial del GDKX. No agregue los archivos extraídos a un repositorio público ni a ninguna ubicación que puedan leer personas ajenas a su organización.
  1. Extraiga el archivo comprimido en una carpeta fuera de su repositorio de código fuente. En PowerShell, ejecute los siguientes comandos.
  2. 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-type no sea public, incluidos los archivos que no tienen ese campo.
  3. 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.
Vuelva a extraer el archivo comprimido para cada edición del GDK que instale, en una carpeta con el nombre de esa edición.

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:
  • GameDK es la carpeta raíz del GDK. Contiene la carpeta bin de herramientas de línea de comandos y una carpeta para cada edición instalada, como %GameDK%261000\.
  • GameDKCoreLatest y GameDKXboxLatest apuntan a la edición instalada más reciente.
Si hay más de una edición instalada en paralelo, es posible que la edición más reciente no sea la que usa su juego para compilar. Proporcione al agente la carpeta de la edición que usa su juego, como %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. Ejecute GamingDesktopVars.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:
Use 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, como AGENTS.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

Revisar el trabajo del agente

Antes de revisar un cambio, pida al agente que revise su propio trabajo. Por ejemplo, proporciónele esta indicación:
La autorrevisión no reemplaza su revisión. Revise y pruebe el código escrito por el agente como lo haría con cualquier otro código. Compruebe las afirmaciones sobre compatibilidad de plataformas, directivas y requisitos de certificación en la documentación, no en la respuesta del agente.

Consulte también

Última modificación el 19 de noviembre de 2026