> 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/scenes-sdk7.md).

# Scenes (SDK7)

- [Primeiros passos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos.md)
- [Início Rápido do SDK](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/sdk-101.md): Crie sua primeira scene do Decentraland com o Creator Hub, o SDK e vibe coding assistido por IA usando o SDK Skills oficial.
- [Workflow de Desenvolvimento](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/dev-workflow.md): Workflow recomendado para criar uma scene do Decentraland com o Creator Hub, da ideação aos testes e à publicação.
- [Faça Preview da Sua Scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md): O que você pode ver no preview de uma scene
- [Usando a CLI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/using-the-cli.md): Use a CLI do Decentraland para executar e implantar scenes. O Creator Hub é a ferramenta recomendada para a maioria dos creators; a CLI é adequada para workflows avançados e automatizados.
- [Essenciais de codificação](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/coding-scenes.md): Este conjunto ajudará você a entender como as coisas funcionam no client e no SDK do Decentraland.
- [Vibe Coding com IA](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md): Construa scenes do Decentraland com assistentes de IA usando o Creator Hub e o official Decentraland SDK Skills (npx skills add decentraland/sdk-skills).
- [Recursos úteis](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/useful-resources.md): Ferramentas, add-ons, bibliotecas de assets e projetos de exemplo que aceleram seu workflow de criação no Decentraland.
- [Desenhando a experiência](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/desenhando-a-experiencia.md)
- [Projetar Jogos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/desenhando-a-experiencia/design-games.md): O que você precisa ter em mente ao projetar um jogo para o Decentraland.
- [Diretrizes de MVP](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/desenhando-a-experiencia/mvp-guidelines.md): Diretrizes recomendadas para produzir sua primeira scene ou experiência MVP usando o SDK
- [Guia de UX e UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/desenhando-a-experiencia/ux-ui-guide.md): Dicas e práticas para construir scenes onde os players vão querer ficar e voltar!
- [Arquitetura](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura.md)
- [Entities e Components](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/entities-components.md): Aprenda o essencial sobre entities e components em uma scene do Decentraland
- [Systems](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/systems.md): Aprenda como systems são usados para atualizar o estado da scene
- [Components Personalizados](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/custom-components.md): Crie um component personalizado para lidar com dados específicos relacionados a uma entity
- [Composites](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/composites.md): Faça spawn de uma árvore de entities e components em runtime a partir de um arquivo composite
- [Consultando Components](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/querying-components.md): Aprenda como obter listas de entities que têm components em comum, para facilitar a verificação ou atualização delas.
- [Inscrever-se em Alterações](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/subscribe-to-changes.md): Detecte alterações em um Component e execute funções a cada alteração
- [Programação Orientada a Dados](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/data-oriented-programming.md): A Programação Orientada a Dados é uma abordagem poderosa de programação que aproveita ao máximo o desempenho.
- [Tipos de projetos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos.md)
- [Visão Geral](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/kinds-of-project.md): Os tipos de projetos disponíveis que você pode criar no Decentraland.
- [Arquivos da Scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-files.md): Arquivos padrão criados em uma nova scene.
- [Metadados da Scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/scene-metadata.md): Aprenda como configurar uma scene e ajustar seus metadados.
- [Smart Wearables](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/smart-wearables.md): Crie wearables com capacidades interativas
- [Workspaces](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/workspaces.md): Execute vários projetos DCL ao mesmo tempo
- [Portable Experiences](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/tipos-de-projetos/portable-experiences.md): Portable experiences
- [Fundamentos de conteúdo 3D](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d.md)
- [Animações de Modelos 3D](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/3d-model-animations.md): Como animar modelos 3D na sua scene
- [Camera](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/camera.md): Aprenda como controlar a camera do player
- [Colliders](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/colliders.md): Aprenda sobre os diferentes components que dão às entities sua forma 3D e colisão.
- [Tipos de Cor](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/color-types.md): Como definir valores de cor
- [Posicionamento de Entities](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/entity-positioning.md): Como definir a posição, rotação e escala de uma entity em uma scene
- [Lights](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/lights.md): Aprenda como usar lights na sua scene
- [Materials](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/materials.md): Aprenda como adicionar materials e textures a entities com formas primitivas.
- [Mover Entities](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/move-entities.md): Como mover, girar e dimensionar uma entity gradualmente ao longo do tempo, com mudanças incrementais.
- [Sistema de Partículas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/particle-system.md): Adicione efeitos de particles como fogo, chuva, faíscas e auras mágicas à sua scene
- [Components de Forma](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/shape-components.md): Aprenda sobre os diferentes components que dão às entities sua forma 3D e colisão.
- [Sounds](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/sounds.md): Aprenda como adicionar sounds à sua scene.
- [Tipos Especiais](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/special-types.md): Aprenda quais tipos especiais existem, incluindo Vector, Quaternions e mais.
- [Texto](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/text.md): Como adicionar texto à sua scene
- [Trigger Areas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/trigger-areas.md): Aprenda como usar trigger areas na sua scene
- [Media](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/media.md): Adicione conteúdo de media às suas scenes
- [Análise de Audio](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/media/audio-analysis.md): Leia dados de amplitude e frequência em tempo real do audio reproduzido na sua scene para acionar visuais reativos.
- [Streaming de Audio](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/media/audio-streaming.md): Reproduza streams de áudio ao vivo na sua scene.
- [Exibir um NFT Certificado](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/media/display-a-certified-nft.md): Aprenda como exibir um NFT certificado que você possui na sua scene
- [Reprodução de Video](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/media/video-playing.md): Transmita video para uma scene
- [Debugging](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/debugging.md): Faça debug e resolva problemas nas suas scenes
- [Depurar no Preview](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/debugging/debug-in-preview.md): Como você pode depurar sua scene enquanto a executa localmente em preview
- [Depurar em Produção](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/debugging/debug-in-prod.md): Como você pode depurar sua scene que está sendo executada dentro do Decentraland
- [Reportar um Bug](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/debugging/report-bug.md): Como você pode reportar um bug para que ele seja revisado e corrigido
- [Resolução de problemas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/debugging/troubleshooting.md): Correções para problemas comuns
- [otimização](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao.md): Otimize suas scenes para desempenho
- [Otimização de Desempenho](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md): Otimize sua scene para carregar rápido e rodar suavemente para todos os players.
- [Pré-carregar Recursos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/pre-load-resources.md): Pré-carregar Resources permite que assets sejam baixados no início da scene para estarem prontos quando o player interagir com eles pela primeira vez.
- [Limitações da Scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/otimizacao/scene-limitations.md): Quantas coisas posso colocar na minha scene?
- [Publicação](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao.md): Publique suas scenes no Decentraland
- [Tornar Descobrível](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/make-discoverable.md): Ajude players a descobrir sua scene
- [Opções de Publicação](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md): Como obter permissões de Decentraland World ou LAND para publicar sua scene
- [Publicação](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md): Como publicar meu projeto?
- [Interatividade](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade.md): Crie experiências interativas
- [Avatars](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatars.md)
- [Mover o Player](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatars/move-player.md): Teleporte o player, ou caminhe com ele até uma nova posição dentro da sua scene
- [Animações de Avatar](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatars/avatar-animations.md): Faça o avatar do player reproduzir animações padrão ou personalizadas, e detecte quando um emote termina
- [Locomotion Settings and Restrictions](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatars/locomotion.md): Altere a velocidade e a altura do salto do player, ou restrinja como ele pode se mover
- [Áreas de Modificação de Avatar](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatars/modifier-areas.md): Oculte avatars, oculte nametags, ou desative passports para players dentro de uma região da sua scene
- [Nametags de Avatar](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatars/avatar-nametags.md): Mostre uma label personalizada acima do nametag de um avatar, para exibir um rank, um role ou uma team.
- [Avatares NPC](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatars/npc-avatars.md): Exiba e controle um avatar NPC
- [Button Events](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/button-events.md): Lide com cliques em buttons e Pointer Events
- [Eventos de Click](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/button-events/click-events.md): Aprenda como lidar com cliques do usuário na sua scene.
- [Registrar Callback](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/button-events/register-callback.md): Aprenda como lidar com cliques do usuário na sua scene.
- [Eventos Baseados em System](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/button-events/system-based-events.md): Aprenda como lidar com cliques do usuário na sua scene.
- [Eventos Avançados de Button](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/button-events/advanced-button-events.md): Aprenda como lidar com cliques do usuário na sua scene.
- [Eventos de Proximidade](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/button-events/proximity-events.md): Detecte quando um player entra ou sai da proximidade de uma entity.
- [Funções Descontinuadas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/deprecated-functions.md): Funções legadas
- [Event Listeners](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/event-listeners.md): Eventos que a scene pode rastrear, relacionados às ações do player e às mudanças da scene.
- [Links Externos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/external-links.md): Link para outras scenes ou sites externos
- [Movimento do Mouse](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/mouse-movement.md): Reaja ao movimento do mouse do player em tempo real, para conduzir gestos de drag, girar objects ou controlar cameras personalizadas.
- [Physics do Player](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/player-physics.md): Aplique forças e impulses ao avatar do player
- [Raycasting](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/raycasting.md): Use raycasting para traçar uma linha no espaço e consultar colisões com entities na scene.
- [Dados de Runtime](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/runtime-data.md): Obtenha dados do contexto em que sua scene está sendo executada e da própria scene.
- [Controle da Skybox](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/skybox-control.md): Altere o horário da skybox
- [Controlos no Ecrã](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/touch-screen-controls.md): Configure os controles nativos de toque na tela para sua scene.
- [Dados do User](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/user-data.md): Obtenha dados dos players à medida que interagem com sua scene.
- [UI 2D](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d.md): Crie interfaces de usuário 2D para suas scenes
- [UI na Tela](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/onscreen-ui.md): Aprenda como criar uma UI para players na sua scene. Isso é útil, por exemplo, para exibir informações relacionadas ao jogo.
- [Posicionamento da UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/ui-positioning.md): Defina a posição, escala, padding e outras propriedades de UI entities.
- [Fundo da UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/ui_background.md): Defina um fundo e borda de uma UI entity.
- [Eventos de Button da UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/ui_button_events.md): Lide com eventos de button em UI entities.
- [Vinculação de Input da UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/ui_input_binding.md): Vincule ações de input aos seus próprios elementos de UI para que elas acionem a entrada do player.
- [Tipos Especiais da UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/ui_special_types.md): Tipos especiais de entity para a UI, incluindo dropdowns e caixas de input.
- [Texto da UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/ui_text.md): Escreva texto em UI entities.
- [UI Dinâmica](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/ui-2d/dynamic-ui.md): Aprenda como tornar UIs dinâmicas, respondendo a mudanças nos dados.
- [Networking](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/networking.md): Crie experiências multiplayer e em rede
- [Multiplayer Server](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/networking/authoritative-servers.md): Construa scenes multiplayer do Decentraland com um multiplayer server headless.
- [Conexões de Rede](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/networking/network-connections.md): Como comunicar sua scene com servers e APIs externos.
- [Multiplayer sem Server](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/networking/serverless-multiplayer.md): Sincronize o estado da scene entre players.
- [Servers de Terceiros](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/networking/third-party-servers.md): Construa scenes multiplayer do Decentraland com um server de terceiros.
- [Blockchain](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/blockchain.md): Integre funcionalidades de blockchain às suas scenes
- [Criar uma dApp](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/blockchain/create-a-dapp.md): Referência para criar sua própria Decentralized App
- [Implantando Seu Server de Transactions](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/blockchain/deploying-your-own-transactions-server.md): Forneça aos users transactions sem custo
- [Operações Blockchain da Scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/blockchain/scene-blockchain-operations.md): Aprenda o que o SDK oferece para realizar operações com a blockchain Ethereum
- [Segunda Camada](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/blockchain/second-layer.md): Use a sidechain do Polygon na sua scene para habilitar transactions blockchain muito mais rápidas e baratas.
- [Libraries](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/libraries.md): Bibliotecas reutilizáveis para scenes do Decentraland SDK7
- [Gerenciar Dependências](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/libraries/manage-dependencies.md): Como adicionar libraries a uma scene
- [Catálogo de Libraries](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/libraries/libraries.md): Navegue pelas libraries SDK7 disponíveis do Decentraland
- [Criar uma Library](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/libraries/create-libraries.md): Crie suas próprias libraries do Decentraland para compartilhar com outras pessoas
- [Padrões de programação](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/padroes-de-programacao.md): Padrões comuns de programação e boas práticas
- [Funções Async](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/padroes-de-programacao/async-functions.md): Aprenda quando e como executar funções assíncronas no código da sua scene.
- [Game Objects](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/padroes-de-programacao/game-objects.md): Use o padrão de game object para tornar seu código mais legível e mais fácil de escalar.
- [Dados Mutáveis](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/padroes-de-programacao/mutable-data.md): Aprenda como lidar com dados de leitura e dados mutáveis de components
- [Referência da API](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/referencia-da-api.md)
- [Testes e Feedback](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/referencia-da-api/alpha-testing-guidelines.md): Diretrizes sobre como experimentar o SDK7 e fornecer feedback
- [Notas de versão](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/referencia-da-api/releases.md): O que mudou no SDK e no Creator Hub ao longo do último ano, filtrado para as mudanças que afetam os criadores.
- [Referência da API](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/referencia-da-api/v7-alpha.md): Referência completa da API para o Decentraland SDK7, gerada a partir da toolchain js-sdk-.
- [Acordo de Suporte de Versão](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/referencia-da-api/version-support-agreement.md): acordo de suporte de versão
- [Outros](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/outros.md): Recursos adicionais do SDK
- [Scene Analytics](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/outros/scene-analytics.md): Acompanhe visitas de players, engajamento e retenção nas suas scenes publicadas
- [Migrar Scenes Legadas do SDK6](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/outros/migrate-legacy-sdk6-scenes.md): Migre uma scene legada do SDK6 para SDK7 usando um assistente de IA.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.