> 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-pt/scene-editor/expandir-com-codigo/ai-assistant.md). # Assistente de IA Crie e altere a sua cena ao conversar com um assistente de IA dentro do Creator Hub. O Creator Hub pode executar um assistente de IA que vê sua cena aberta e a edita para você. Peça para ele colocar itens, conectar comportamentos, escrever scripts ou executar o preview e verificar o resultado. {% hint style="warning" %} **📔 Nota**: O assistente executa um CLI de codificação que você instala e no qual faz login, com acesso total à sua máquina, o mesmo alcance que ele tem no seu terminal. Só ative se confiar no que você pedir para ele fazer. {% endhint %} ## Onde ficam suas configurações O assistente vem ativado por padrão. Suas configurações têm uma aba própria: 1. Clique no logotipo do Creator Hub no canto superior esquerdo e selecione **Configurações**. 2. Vá para a **IA** aba. Essa aba contém o **Ativar Assistente de IA** alternância, a **Cobrar isso em uma chave de API em vez disso** opção, a **Conectar** lista de CLIs de codificação, e as **Expor o servidor MCP do assistente de IA** configurações. Quando o assistente está ativado, um **Assistente de IA** botão (o ícone de brilhos) aparece na barra superior do editor, à esquerda do **Código** botão. Clique nele para abrir o painel de chat ao lado da sua cena. ![A barra superior do editor, com o nome da cena à esquerda e o ícone de brilhos do Assistente de IA, Código, Preview e Publicar à direita.](https://2402076176-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) ![O painel do Assistente de IA quando aberto pela primeira vez: um menu suspenso Novo chat e um menu suspenso de CLI mostrando Claude no topo, uma mensagem de boas-vindas, um cartão Sobre o uso de IA, um chip de seleção nomeando a entity selecionada e o campo Pergunte ao assistente na parte inferior.](https://2402076176-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) ## Conecte um CLI de codificação O assistente não usa uma chave de API própria. Ele executa um CLI de codificação que você instala e no qual faz login, então o trabalho é cobrado na assinatura dessa própria ferramenta. Quatro são suportados. A maioria é configurada a partir de um terminal: a tela de configuração mostra o comando de instalação para o seu sistema operacional, um comando de login e um link para o guia de instalação do fornecedor, para que você possa copiar cada um por vez. | CLI | Instalar no macOS e Linux | Instalar no Windows | Entrar | | ------ | ------------------------------------------------------- | -------------------------------------------------------------------------------------------- | -------------------- | | 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` | executar `gemini` | Codex é a exceção: ele também oferece um **Fazer login com Codex** botão que realiza o login para você e abre o navegador. Claude, Cursor e Gemini são instalados e têm login realizado somente a partir de um terminal. Depois de instalar um CLI, clique em **Verificar novamente** na tela de configuração. Ele detecta a nova instalação imediatamente, sem precisar reiniciar o Creator Hub. {% hint style="warning" %} **📔 Nota**: Claude Desktop não é a mesma coisa que Claude Code. O assistente precisa de Claude Code, a ferramenta de terminal, e fazer login no aplicativo de desktop não faz login nele. Se o Creator Hub encontrar Claude Desktop sem Claude Code, ele informa isso e mostra o comando de instalação. O Gemini CLI precisa de uma chave de API paga do Gemini, ou de uma licença Gemini Code Assist Standard ou Enterprise. {% endhint %} A mesma tela de configuração aparece no próprio painel de chat na primeira vez que você o abre sem nenhum CLI conectado, e nas configurações na **IA** aba em **Conectar**. Se o login salvo de um CLI expirar, seu status muda para **É necessário fazer login** e o painel mostra os comandos de logout e login para você executar, um de cada vez. Execute-os e depois envie sua mensagem novamente. {% hint style="info" %} **💡 Dica**: Se você tiver mais de um CLI com login feito, um menu suspenso no painel de chat permite alternar entre eles. {% endhint %} ### Cobrar em uma chave de API em vez disso Se você preferir pagar por token em vez de usar uma assinatura de CLI, ative **Cobrar isso em uma chave de API em vez disso** na **IA** aba das configurações. Ele lê a chave de API do seu provedor a partir do seu ambiente: `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `CURSOR_API_KEY` ou `GEMINI_API_KEY`. Isso vem desativado por padrão. ## O que ele pode fazer O assistente trabalha na cena que você tem aberta. Ele pode: * **Editar a cena**: criar e excluir entities, alterar components, colocar [smart items](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md), anexar [scripts](/creator/content-creator-pt/scene-editor/expandir-com-codigo/script-component.md), e ler e gravar `scene.json`. * **Escrever código** nos arquivos da sua cena. * **Executar o preview** e controlá-lo: tirar capturas de tela, andar por aí, clicar em coisas, ler os logs e verificar o desempenho. * **Ler a sua seleção**, para que você possa selecionar uma entity e dizer "deixe esta mais alta". As mudanças são salvas à medida que acontecem e vão para o histórico normal de desfazer. Para reverter toda uma troca de uma vez, use **Desfazer alterações de IA** na resposta do assistente. ![O painel do Assistente de IA encaixado à direita do editor após um pedido para renomear uma entity e adicionar um Mesh Renderer: a resposta lista as ferramentas que ele executou, descreve o resultado e mostra um botão Desfazer alterações de IA abaixo dela.](https://2402076176-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) Enquanto o assistente trabalha, suas alterações aparecem ao vivo na entity tree e no canvas. ![O Scene Editor completo com o painel do Assistente de IA encaixado à direita, a entity Stage renomeada visível na entity tree e a resposta do assistente terminando com Desfazer alterações de IA.](https://2402076176-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) ## Trabalhando com o chat * **Novo chat** inicia uma conversa nova. * **Histórico de conversas** lista conversas anteriores com há quanto tempo foram executadas. As conversas são salvas por projeto, então reabrir uma cena traz de volta seus chats. * **Abrir em uma janela separada** destaca o assistente em sua própria janela, o que é útil em um segundo monitor. **Ancorar novamente no editor** e o retorna. * O painel pode ser arrastado para ficar mais largo ou mais estreito. Um **Sobre o uso de IA** cartão lembra que o assistente consome tokens da sua conta conectada. Fique de olho no uso dessa conta. ### Anexar arquivos a um prompt Às vezes é mais fácil mostrar algo ao assistente do que descrevê-lo. Você pode anexar arquivos a qualquer mensagem de três maneiras: * Clique no ícone de clipe de papel à esquerda da caixa de mensagem, rotulado **Anexar arquivos**, e escolha um ou mais arquivos. * Arraste arquivos do seu explorador de arquivos para a caixa de mensagem. Uma **Solte arquivos para anexar** dica aparece enquanto você arrasta. * Cole uma imagem diretamente da sua área de transferência, por exemplo uma captura de tela que você acabou de fazer. Cada arquivo anexado aparece como um chip acima da caixa de mensagem, com um ícone para seu tipo: imagem, modelo 3D (`.glb`, `.gltf`), áudio (`.mp3`, `.wav`, `.ogg`, `.m4a`, `.flac`), ou um arquivo genérico para qualquer outra coisa. Clique no **Remover** X em um chip para removê-lo antes de enviar. Você pode anexar até 8 arquivos a uma única mensagem e pode enviar anexos sem nenhum texto. Os arquivos que você arrasta ou escolhe do disco são entregues ao assistente pelo caminho real deles, então nada é copiado e não há limite de tamanho. O assistente pode ver imagens diretamente, e pode referenciar um modelo ou arquivo de áudio pelo caminho quando escreve código de cena. Imagens coladas não têm arquivo no disco, então o Creator Hub as salva primeiro em um arquivo temporário; esses ficam limitados a 8 MB cada. Se o seu CLI Claude estiver muito desatualizado, o painel mostra um aviso. Execute `claude update` em um terminal para corrigir isso. ### Apontar para um asset no seu prompt Anexar um arquivo envia seu conteúdo. Mencionar um asset é mais leve: isso apenas diz ao assistente a qual asset no seu projeto você se refere, então você pode dizer "use este" em vez de digitar um caminho completo. Com o assistente aberto, dê dois cliques em qualquer asset na **Local Assets** aba. Ele aparece como um chip acima da caixa de mensagem, com o texto **Asset: *****nome do arquivo***, ou **Animação integrada: *****nome*** para uma das animações integradas do avatar. * Mencione quantos assets quiser. Cada um recebe seu próprio chip e seu próprio **Remover** X. * As menções ficam ao lado do **Seleção** chip, para que você possa apontar para uma entity na sua cena e para um asset ao mesmo tempo: "coloque esta animação naquele NPC". * As menções se aplicam apenas à sua próxima mensagem. Elas são limpas depois que você a envia. {% hint style="info" %} **💡 Dica**: Selecionar a raiz da Scene conta como não selecionar nada, então ela nunca é enviada ao assistente. Selecione uma entity real quando quiser que o assistente aja sobre ela. {% endhint %} ## As skills do Decentraland são instaladas para você Quando o assistente é executado, o Creator Hub baixa as oficiais [Decentraland SDK Skills](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md) e as vincula ao seu projeto, para que o assistente siga padrões verificados do SDK7 em vez de adivinhar. Elas são vinculadas em `.claude/skills` e `.agents/skills` dentro da pasta do seu projeto, e ambas são adicionadas a um `.gitignore` para você, então elas nunca acabam no seu repositório. ## Arquivos que o assistente deixa na sua pasta da cena O assistente pode ler e editar sua cena aberta por meio de um servidor MCP local. Cada CLI é informado sobre esse servidor de maneira diferente, então, dependendo de qual você usar, você pode encontrar novos arquivos no seu projeto: | CLI | O que aparece na pasta da cena | | ------ | ------------------------------------------------------------------------ | | Cursor | `.cursor/mcp.json`, além de `.cursor/rules/creator-hub.mdc` | | Gemini | `.gemini/settings.json` | | Claude | Nada. A configuração vai para um arquivo temporário fora do seu projeto. | | Codex | Nada. A configuração é passada na linha de comando. | Se você já tiver um desses arquivos de configuração, o Creator Hub mescla a entrada dele nele em vez de sobrescrever seus próprios servidores. {% hint style="warning" %} **📔 Nota**: `.cursor/mcp.json` é o único arquivo que contém o próprio token de acesso, porque o formato de configuração do Cursor não tem como lê-lo do ambiente. O Creator Hub o adiciona ao seu `.gitignore` antes de gravá-lo, então não faça commit dele nem remova essa linha. O arquivo do Gemini referencia o token por meio de uma `$CREATOR_HUB_MCP_TOKEN` variável de ambiente, então ele não contém segredo nenhum e não é ignorado. {% endhint %} ## Use sua própria ferramenta de IA em vez disso Se você já trabalha no Claude Code, Cursor, Codex ou em outra ferramenta que fala MCP, você pode apontá-la para a cena aberta em vez de usar o painel integrado. MCP (Model Context Protocol) é uma forma padrão de uma ferramenta de IA chamar outro programa. 1. Abra o menu principal pelo logotipo do Creator Hub, selecione **Configurações**, e na **IA** aba expanda **Expor o servidor MCP do assistente de IA**. 2. Clique **Copiar configuração**. 3. Cole isso na configuração MCP da sua ferramenta. A configuração copiada fica assim, com uma porta e um token reais preenchidos: ```json { "mcpServers": { "creator-hub": { "type": "http", "url": "http://127.0.0.1:/mcp", "headers": { "Authorization": "Bearer " } } } } ``` No Claude Code, você também pode adicioná-lo a partir de um terminal na pasta da sua cena: ```bash claude mcp add --transport http --scope local creator-hub http://127.0.0.1:/mcp \\ --header "Authorization: Bearer " ``` {% hint style="warning" %} **📔 Nota**: A porta e o token são novos toda vez que o Creator Hub inicia. Se sua ferramenta de repente receber um `401` erro, copie a configuração novamente. O servidor só escuta na sua própria máquina e só age na cena que você tem aberta. {% endhint %} ## Páginas relacionadas * [Vibe Coding com IA](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md): o guia completo das SDK Skills e de como criar prompts bem. * [Combinar com código](/creator/content-creator-pt/scene-editor/expandir-com-codigo/overview.md): abra sua cena em um editor de código. * [Usando o Script Component](/creator/content-creator-pt/scene-editor/expandir-com-codigo/script-component.md): anexe comportamento a uma entity a partir de um arquivo. --- # 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-pt/scene-editor/expandir-com-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.