> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-es/scene-editor/extender-con-codigo/ai-assistant.md). # Asistente de IA Crea y cambia tu escena chateando con un asistente de IA dentro de Creator Hub. Creator Hub puede ejecutar un asistente de IA que ve tu escena abierta y la edita por ti. P铆dele que coloque elementos, conecte el comportamiento, escriba scripts o ejecute la vista previa y compruebe el resultado. {% hint style="warning" %} **馃摂 Nota**: El asistente ejecuta una CLI de programaci贸n que instalas e inicias sesi贸n, con acceso total a tu m谩quina, el mismo alcance que tiene en tu terminal. Act铆valo solo si conf铆as en lo que le pides que haga. {% endhint %} ## D贸nde est谩n sus ajustes El asistente est谩 activado por defecto. Sus ajustes tienen su propia pesta帽a: 1. Haz clic en el logotipo de Creator Hub en la esquina superior izquierda y selecciona **Configuraci贸n**. 2. Ve a la **IA** pesta帽a. Esa pesta帽a contiene el **Activar asistente de IA** interruptor, la **C谩rgalo a una clave de API en su lugar** opci贸n, la **Conectar** lista de CLIs de programaci贸n, y la **Exponer servidor MCP del asistente de IA** configuraci贸n. Cuando el asistente est谩 activado, un **Asistente de IA** bot贸n (el icono de destellos) aparece en la barra superior del editor, a la izquierda del **C贸digo** bot贸n. Haz clic en 茅l para abrir el panel de chat junto a tu escena. ![La barra superior del editor, con el nombre de la escena a la izquierda y el icono de destellos de Asistente de IA, y los botones C贸digo, Vista previa y Publicar a la derecha.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7db0716b3d034ba09084bf784488209d7d77caad%2Feditor-top-bar.png?alt=media\&token=e00db1c0-c8c4-42c2-bd13-d5c2ab00f63e) ![El panel de Asistente de IA al abrirse por primera vez: un desplegable Nuevo chat y un desplegable de CLI que muestra Claude en la parte superior, un mensaje de bienvenida, una tarjeta Acerca del uso de IA, un chip de selecci贸n que nombra la entidad seleccionada y el campo Preguntar al asistente en la parte inferior.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-078c9e0dec3b2886d4216fad423c9fddd492bf0c%2Fai-assistant-panel.png?alt=media\&token=b4720826-136f-4743-9a1f-db5663cbd47f) ## Conectar una CLI de programaci贸n El asistente no usa una clave de API propia. Ejecuta una CLI de programaci贸n que instalas e inicias sesi贸n, por lo que el trabajo se factura a la suscripci贸n de esa herramienta. Se admiten cuatro. La mayor铆a se configuran desde una terminal: la pantalla de configuraci贸n te muestra el comando de instalaci贸n para tu propio sistema operativo, un comando de inicio de sesi贸n y un enlace a la gu铆a de instalaci贸n del proveedor, para que puedas copiar cada uno por turnos. | CLI | Instalar en macOS y Linux | Instalar en Windows | Iniciar sesi贸n | | ------ | ------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------- | | Claude | `curl -fsSL https://claude.ai/install.sh \| bash` | `winget install Anthropic.ClaudeCode` | `claude auth login` | | Codex | `curl -fsSL https://chatgpt.com/codex/install.sh \| sh` | `powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 \| iex"` | `codex login` | | Cursor | `curl https://cursor.com/install -fsS \| bash` | `powershell -ExecutionPolicy ByPass -c "irm 'https://cursor.com/install?win32=true' \| iex"` | `cursor-agent login` | | Gemini | `npm install -g @google/gemini-cli` | `npm install -g @google/gemini-cli` | ejecuta `gemini` | Codex es la excepci贸n: tambi茅n ofrece un bot贸n **Iniciar sesi贸n con Codex** que ejecuta el inicio de sesi贸n por ti y abre tu navegador. Claude, Cursor y Gemini se instalan e inician sesi贸n solo desde una terminal. Despu茅s de instalar una CLI, haz clic en **Volver a comprobar** en la pantalla de configuraci贸n. Detecta la nueva instalaci贸n al instante, sin necesidad de reiniciar Creator Hub. {% hint style="warning" %} **馃摂 Nota**: Claude Desktop no es lo mismo que Claude Code. El asistente necesita Claude Code, la herramienta de terminal, e iniciar sesi贸n en la app de escritorio no te inicia sesi贸n en ella. Si Creator Hub encuentra Claude Desktop sin Claude Code, te lo indica y te muestra el comando de instalaci贸n. Gemini CLI necesita una clave de API de Gemini de pago o una licencia Gemini Code Assist Standard o Enterprise. {% endhint %} La misma pantalla de configuraci贸n aparece en el propio panel de chat la primera vez que lo abres sin ninguna CLI conectada, y en los ajustes de la **IA** pesta帽a, debajo de **Conectar**. Si expira el inicio de sesi贸n guardado de una CLI, su estado cambia a **Se necesita iniciar sesi贸n** y el panel te muestra los comandos de cierre de sesi贸n e inicio de sesi贸n que debes ejecutar, uno a la vez. Ejec煤talos y luego env铆a tu mensaje de nuevo. {% hint style="info" %} **馃挕 Consejo**: Si tienes m谩s de una CLI iniciada, un desplegable en el panel de chat te permite cambiar entre ellas. {% endhint %} ### C谩rgalo a una clave de API en su lugar Si prefieres pagar por token en lugar de usar una suscripci贸n de CLI, activa **C谩rgalo a una clave de API en su lugar** en la **IA** pesta帽a de los ajustes. Lee la clave de API de tu proveedor desde tu entorno: `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `CURSOR_API_KEY` o `GEMINI_API_KEY`. Est谩 desactivado por defecto. ## Qu茅 puede hacer El asistente trabaja sobre la escena que tienes abierta. Puede: * **Editar la escena**: crear y eliminar entidades, cambiar componentes, colocar [smart items](/creator/content-creator-es/scene-editor/interactividad/smart-items.md), adjuntar [scripts](/creator/content-creator-es/scene-editor/extender-con-codigo/script-component.md), y leer y escribir `scene.json`. * **Escribir c贸digo** en los archivos de tu escena. * **Ejecutar la vista previa** y controlarla: tomar capturas de pantalla, moverte por ella, hacer clic en cosas, leer los logs y comprobar el rendimiento. * **Leer tu selecci贸n**, para que puedas seleccionar una entidad y decir 芦haz esta m谩s alta禄. Los cambios se guardan a medida que ocurren y pasan al historial normal de deshacer. Para deshacer todo un intercambio de una vez, usa **Deshacer cambios de IA** en la respuesta del asistente. ![El panel de Asistente de IA acoplado a la derecha del editor despu茅s de una petici贸n para cambiar el nombre de una entidad y a帽adir un Mesh Renderer: la respuesta enumera las herramientas que ejecut贸, describe el resultado y muestra debajo un bot贸n Deshacer cambios de IA.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-06054ee50124b89ef317fcecd4f797d7c71896a2%2Fai-assistant-reply.png?alt=media\&token=a107e7b4-4862-4630-9591-1bca87e32b17) Mientras trabaja el asistente, sus cambios aparecen en tiempo real en el 谩rbol de entidades y en el lienzo. ![El Scene Editor completo con el panel de Asistente de IA acoplado a la derecha, la entidad Stage renombrada visible en el 谩rbol de entidades y la respuesta del asistente terminando con Deshacer cambios de IA.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5867011b5b777986587d4cce33d0554e24101b69%2Fai-assistant-docked.png?alt=media\&token=2caa43b5-acc6-4e1b-a90e-85ccddd5bc0f) ## Trabajar con el chat * **Nuevo chat** inicia una conversaci贸n nueva. * **Historial de chats** enumera conversaciones anteriores con el tiempo transcurrido desde que se ejecutaron. Las conversaciones se guardan por proyecto, as铆 que al volver a abrir una escena reaparecen sus chats. * **Abrir en una ventana separada** saca al asistente a su propia ventana, lo cual resulta 煤til en un segundo monitor. **Volver a acoplar en el editor** lo devuelve. * El panel se puede arrastrar para hacerlo m谩s ancho o m谩s estrecho. Una **Acerca del uso de IA** tarjeta te recuerda que el asistente consume tokens de tu cuenta conectada. Vigila el uso de esa cuenta. ### Adjuntar archivos a un mensaje A veces es m谩s f谩cil mostrarle algo al asistente que describ铆rselo. Puedes adjuntar archivos a cualquier mensaje de tres formas: * Haz clic en el icono de clip a la izquierda del cuadro de mensaje, etiquetado **Adjuntar archivos**, y elige uno o m谩s archivos. * Arrastra archivos desde tu explorador de archivos hasta el cuadro de mensaje. Un **Suelta archivos para adjuntar** sugerencia aparece mientras arrastras. * Pega una imagen directamente desde tu portapapeles, por ejemplo una captura de pantalla que acabas de tomar. Cada archivo adjunto aparece como un chip encima del cuadro de mensaje, con un icono para su tipo: imagen, modelo 3D (`.glb`, `.gltf`), audio (`.mp3`, `.wav`, `.ogg`, `.m4a`, `.flac`), o un archivo gen茅rico para cualquier otra cosa. Haz clic en la **Eliminar** cruz de un chip para quitarlo antes de enviarlo. Puedes adjuntar hasta 8 archivos a un solo mensaje, y puedes enviar adjuntos sin ning煤n texto. Los archivos que arrastras o eliges desde el disco se entregan al asistente mediante su ruta real, as铆 que no se copia nada y no hay l铆mite de tama帽o. El asistente puede ver im谩genes directamente y puede referenciar un modelo o archivo de audio por su ruta cuando escribe c贸digo de escena. Las im谩genes pegadas no tienen archivo en el disco, as铆 que Creator Hub las guarda primero en un archivo temporal; esas tienen un l铆mite de 8 MB cada una. Si tu CLI de Claude es demasiado antigua, el panel muestra una advertencia. Ejecuta `claude update` en una terminal para solucionarlo. ### Se帽ala un asset en tu mensaje Adjuntar un archivo env铆a su contenido. Mencionar un asset es m谩s ligero: solo le indica al asistente a qu茅 asset de tu proyecto te refieres, as铆 que puedes decir 芦usa este禄 en lugar de escribir una ruta. Con el asistente abierto, haz doble clic en cualquier asset de la **Local Assets** pesta帽a. Aparece como un chip encima del cuadro de mensaje, con el texto **Asset: *****nombre de archivo***, o **Animaci贸n integrada: *****nombre*** para una de las animaciones integradas del avatar. * Menciona tantos assets como quieras. Cada uno obtiene su propio chip y su propia **Eliminar** cruz. * Las menciones se sit煤an junto al **Selecci贸n** chip, para que puedas se帽alar una entidad de tu escena y un asset al mismo tiempo: 芦pon esta animaci贸n en ese NPC禄. * Las menciones solo se aplican a tu siguiente mensaje. Se borran en cuanto lo env铆as. {% hint style="info" %} **馃挕 Consejo**: Seleccionar la ra铆z de la Scene cuenta como no seleccionar nada, as铆 que nunca se env铆a al asistente. Selecciona una entidad real cuando quieras que el asistente act煤e sobre ella. {% endhint %} ## Las skills de Decentraland se instalan por ti Cuando se ejecuta el asistente, Creator Hub descarga las oficiales [Decentraland SDK Skills](/creator/content-creator-es/scenes-sdk7/primeros-pasos/vibe-coding.md) y las vincula a tu proyecto, para que el asistente siga patrones verificados de SDK7 en lugar de adivinar. Se vinculan en `.claude/skills` y `.agents/skills` dentro de la carpeta de tu proyecto, y ambas se a帽aden a un `.gitignore` por ti, as铆 que nunca acaban en tu repo. ## Archivos que el asistente deja en la carpeta de tu escena El asistente puede leer y editar tu escena abierta a trav茅s de un servidor MCP local. A cada CLI se le indica ese servidor de forma distinta, as铆 que, seg煤n cu谩l uses, puede que encuentres nuevos archivos en tu proyecto: | CLI | Qu茅 aparece en la carpeta de la escena | | ------ | ---------------------------------------------------------------------- | | Cursor | `.cursor/mcp.json`, adem谩s de `.cursor/rules/creator-hub.mdc` | | Gemini | `.gemini/settings.json` | | Claude | Nada. La configuraci贸n va en un archivo temporal fuera de tu proyecto. | | Codex | Nada. La configuraci贸n se pasa en la l铆nea de comandos. | Si ya tienes uno de esos archivos de configuraci贸n, Creator Hub fusiona su entrada en 茅l en lugar de sobrescribir tus propios servidores. {% hint style="warning" %} **馃摂 Nota**: `.cursor/mcp.json` es el 煤nico archivo que contiene el propio token de acceso, porque el formato de configuraci贸n de Cursor no tiene forma de leerlo desde el entorno. Creator Hub lo a帽ade a tu `.gitignore` antes de escribirlo, as铆 que no lo subas al repositorio ni elimines esa l铆nea. El archivo de Gemini referencia el token a trav茅s de una `$CREATOR_HUB_MCP_TOKEN` variable de entorno, as铆 que no contiene ning煤n secreto y no se ignora. {% endhint %} ## Usa tu propia herramienta de IA en su lugar Si ya trabajas en Claude Code, Cursor, Codex u otra herramienta que hable MCP, puedes apuntarla a la escena abierta en lugar de usar el panel integrado. MCP (Model Context Protocol) es una forma est谩ndar de que una herramienta de IA llame a otro programa. 1. Abre el men煤 principal desde el logotipo de Creator Hub y selecciona **Configuraci贸n**, y en la **IA** pesta帽a despliega **Exponer servidor MCP del asistente de IA**. 2. Haz clic en **Copiar configuraci贸n**. 3. P茅galo en la configuraci贸n MCP de tu herramienta. La configuraci贸n copiada se ve as铆, con un puerto y un token reales ya completados: ```json { "mcpServers": { "creator-hub": { "type": "http", "url": "http://127.0.0.1:/mcp", "headers": { "Authorization": "Bearer " } } } } ``` Para Claude Code, tambi茅n puedes a帽adirlo desde una terminal en la carpeta de tu escena: ```bash claude mcp add --transport http --scope local creator-hub http://127.0.0.1:/mcp \ --header "Authorization: Bearer " ``` {% hint style="warning" %} **馃摂 Nota**: El puerto y el token son nuevos cada vez que Creator Hub se inicia. Si tu herramienta de repente recibe un `401` error, copia la configuraci贸n de nuevo. El servidor solo escucha en tu propia m谩quina y solo act煤a sobre la escena que tienes abierta. {% endhint %} ## P谩ginas relacionadas * [Vibe Coding con IA](/creator/content-creator-es/scenes-sdk7/primeros-pasos/vibe-coding.md): la gu铆a completa de las SDK Skills y de c贸mo hacer buenos prompts. * [Combinar con c贸digo](/creator/content-creator-es/scene-editor/extender-con-codigo/overview.md): abre tu escena en un editor de c贸digo. * [Uso del Script Component](/creator/content-creator-es/scene-editor/extender-con-codigo/script-component.md): adjunta comportamiento a una entidad desde un archivo. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.decentraland.org/creator/content-creator-es/scene-editor/extender-con-codigo/ai-assistant.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.