> 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-ko/scene-editor/interactivity/smart-items.md). # 스마트 아이템 - 기본 씬에서 스마트 아이템을 사용해 상호작용성을 추가하세요. 씬 편집기 카탈로그의 일부 항목은 **스마트 아이템**. 플레이어는 이들과 상호작용할 수 있으며, 구성 가능한 속성을 가지고 있고, 다른 스마트 아이템에서 액션을 트리거할 수 있습니다. 예를 들어: 열고 닫을 수 있는 문, 위아래로 움직이는 플랫폼, 또는 다른 아이템을 활성화할 수 있는 버튼과 레버가 있습니다. {% embed url="" %} 에셋 팩 탐색기에서 이 아이템들은 번개 아이콘과 다른 색의 배경이 있어 알아볼 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f368bfdf7894d18f29875528bdd91cf8429e70b3%2Fsmart-items.jpg?alt=media) 엔티티 트리에서 스마트 아이템인 것은 옆에 번개 아이콘이 붙어 있어 알아볼 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-26c0c6fbe09714f92806651fe637acf153da0e80%2Fsmart-item-icon.png?alt=media) ## 아이템 사용하기 스마트 아이템을 사용하려면 다른 아이템처럼 씬으로 드래그하세요. 모든 아이템에는 기본 동작이 포함되어 있으니, 씬 미리보기를 실행해 사용해 보세요. 여기 몇 가지 일반적인 아이템과 기본 동작이 있습니다: * **문**: 클릭하면 문이 열리거나 닫힙니다. 이 동작은 버튼, 트리거 영역 등으로 열리도록 바꿀 수 있습니다. * **버튼**: 클릭하면 피드백으로 소리와 애니메이션이 재생됩니다. 트리거 이벤트에 더 많은 액션을 추가해 다른 스마트 아이템을 활성화할 수 있습니다. * **레버**: 클릭하면 두 상태를 전환합니다. 레버의 각 위치가 다른 스마트 아이템에 대해 서로 다른 액션을 수행하도록 할 수 있습니다. * **상자**: 문처럼 동작하며, 기본적으로 클릭하면 열리거나 닫힙니다. 안에 더 작은 아이템을 넣을 수 있습니다. * **플랫폼**: 두 위치 사이를 이동합니다. tween 액션을 사용해 이동할 위치, 속도 등을 제어하세요. * **트리거 영역**: 플레이어가 그 영역으로 들어가면 다른 스마트 아이템을 트리거할 수 있는 보이지 않는 아이템입니다. 참조 [트리거 영역에 대하여](#trigger-areas). * **아바타 수정 영역**: 아바타의 행동이나 표시 방식을 그 안에서 바꾸는 보이지 않는 영역입니다. 예를 들어 아바타를 숨기거나 패스포트 팝업을 비활성화할 수 있습니다. 참조 [수정 영역](/creator/content-creator-ko/scene-editor/interactivity/modifier-areas.md). * **카메라 수정 영역**: 내부에 있을 때 플레이어의 카메라를 1인칭 또는 3인칭으로 강제하는 보이지 않는 영역입니다. 참조 [수정 영역](/creator/content-creator-ko/scene-editor/interactivity/modifier-areas.md). * **비디오 플레이어**: 비디오나 라이브 스트림을 보여주는 화면입니다. 참조 [비디오 재생](#playing-videos). * **오디오 스트림**: 라이브 스트림의 오디오를 재생합니다. 참조 [오디오 스트림 재생하기](#playing-audio-streams) * **NFT**: NFT 이미지를 초상화로 표시합니다. 참조 [NFT 표시하기](#displaying-nfts) 모든 스마트 아이템은 사용자 지정 방식으로 동작하도록 구성할 수 있습니다. 예를 들어 플랫폼이 얼마나 멀리 움직이는지, 또는 버튼이 무엇을 활성화하는지 등을 설정할 수 있습니다. ## 아이템 구성하기 씬 편집기에서 아이템을 선택하면 오른쪽에서 모든 속성을 볼 수 있습니다. 대부분의 스마트 아이템은 동작을 [스크립트 컴포넌트](/creator/content-creator-ko/scene-editor/extend-with-code/script-component.md). 설정은 **스크립트** 패널에 표시됩니다. 매개변수마다 하나의 필드가 있으며, 각 필드에는 그 기능을 설명하는 툴팁이 있습니다. 이를 사용하기 위해 코드를 작성할 필요는 없습니다. 많은 아이템에서 찾을 수 있는 일반적인 필드는 다음과 같습니다: * **호버 텍스트**: 플레이어가 커서를 아이템 위에 올렸을 때 힌트로 UI에 표시되는 텍스트입니다. 예를 들어 문에는 "Open"이라고 표시될 수 있습니다. * **상호작용**: 어떤 버튼으로 아이템을 활성화할까요? 일반적인 키보드에서는: * **기본** 일 때 **E** * **보조** 일 때 **F** * **포인터** 일 때 **마우스 왼쪽 버튼** * **Action3** 키입니다 **1** * **Action4** 키입니다 **2** * **Action5** 키입니다 **3** * **Action6** 키입니다 **4** * **아이템에 반응하는 훅**: 특정 순간에 실행할 액션을 선택하는 파라미터입니다. 어떤 훅이 있는지는 아이템이 무엇을 하느냐에 따라 달라집니다. 버튼에는 **onClick**, 레버에는 **onActivate** 및 **onDeactivate**, 움직이는 플랫폼에는 **onReachStart** 및 **onReachEnd**, 벨에는 **onRing**. 훅을 비워 두면 그 순간에는 아무 일도 일어나지 않습니다. 각 아이템에는 고유한 설정이 있으며, 아이템마다 다를 수 있습니다. 몇몇 아이템은 이전의 **설정** 패널을 계속 사용합니다. 예를 들어 조명은 여전히 그곳에서 색상과 강도를 설정합니다. 모든 아이템에는 **고급 모드** 거의 모든 것을 설정할 수 있는 기능이 있습니다. 여기에는 어떤 소리가 재생되는지, 또는 플랫폼이 어느 방향으로 움직이는지 같은 것들이 포함됩니다. 플레이어를 텔레포트하거나, 아바타 애니메이션을 재생하거나, 아이템을 플레이어의 손에 붙이는 등 온갖 작업을 포함하는 사용자 지정 액션도 추가할 수 있습니다. 특정 상황에서만 무언가를 활성화하도록 조건부 로직도 추가할 수 있습니다. 참조 [Smart Items - 고급](/creator/content-creator-ko/scene-editor/interactivity/smart-items-advanced.md). ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-958f6f53945e119e770d84f808814c18d173c9c1%2Fadvanced-mode.png?alt=media) ## 다른 아이템의 액션 호출하기 스마트 아이템은 다른 스마트 아이템의 액션을 트리거할 수 있어, 아이템이 활성화될 때마다 해당 동작이 실행됩니다. 씬의 모든 아이템 목록에서 호출할 아이템을 선택한 다음 액션을 선택하세요. 아이템마다 제공하는 액션은 다릅니다. 예를 들어 여기 문을 열거나 닫는 버튼이 있습니다. 버튼을 누를 때마다 문이 열리거나 닫힙니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-110156bc3c8fa17336e61490402e1cb19d83ff47%2Fbutton-to-door.png?alt=media) 활성화되면 문을 열고 비활성화되면 그 문을 닫는 레버가 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6e4cb24dd1b7e3e9b438b8825c0479672bc2254c%2Flever-to-door.png?alt=media) 서로 다른 아이템의 다양한 액션을 원하는 만큼 함께 트리거할 수 있습니다. 그냥 클릭하세요 **+ 액션 할당**. 액션 옆의 세 점을 클릭한 다음 다음을 선택해 액션을 제거하세요 *액션 제거*. 아이템이 제공하는 액션은 다음과 같은 익숙한 이름을 그대로 유지합니다: **Open**, **닫기**, **여기 앉기**, **켜기**, 또는 **텔레포트** , 따라서 아이템 간 연결은 늘 하던 방식과 동일하게 작동합니다. 액션을 체인으로 연결할 수도 있습니다. 예를 들어, 레버의 **onActivate** 가 문을 열고, 그 문의 자체 훅이 다른 무언가를 트리거하면, 레버가 전체 체인을 간접적으로 작동시키는 셈입니다. 다음을 사용하면 [고급 모드](/creator/content-creator-ko/scene-editor/interactivity/smart-items-advanced.md) 이러한 종류의 액션에도 조건부 로직을 추가할 수 있습니다. ## 특별한 스마트 아이템 일부 스마트 아이템은 흔한 상황에서 매우 유용하게 만드는 고유한 특징이 있습니다: ### 트리거 영역 플레이어가 영역으로 걸어 들어오면 액션을 트리거하려면 Trigger Area 스마트 아이템을 사용하세요. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-649dfd99d06849f543399b5b89a6a31a015cb439%2Ftrigger.png?alt=media) 사용하세요 **플레이어가 영역에 प्रवेश** 및 **플레이어가 영역에서 나감** 아이템의 트리거 유형 **트리거** 구성 요소입니다. 이러한 트리거 이벤트의 액션은 플레이어가 그 영역에 들어가거나 나갈 때마다 활성화됩니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f8389cd077c495e0b8ada33ca0da01800eee7dcd%2Fon_player_enters.png?alt=media) 참고 [트리거 영역](/creator/content-creator-ko/scene-editor/interactivity/trigger-area.md) 을 참조하세요. ### 보이지 않는 벽 플레이어가 영역을 통과해 걷거나 클릭하지 못하게 막는 보이지 않는 형태들의 모음입니다. 이러한 보이지 않는 벽은 콜라이더 메쉬가 없는 3D 모델을 가져올 때나, 플레이어에게 보이지 않는 벽을 만들고 싶을 때 유용합니다. 참고 [콜라이더](/creator/content-creator-ko/sdk7/3d/colliders.md) 을 참조하세요. ### 클릭 영역 플레이어가 클릭해 다른 스마트 아이템의 액션을 트리거할 수 있는 보이지 않는 큐브입니다. 이 아이템은 다른 스마트 아이템으로 활성화하거나 비활성화할 수 있으며, 비활성화되면 클릭할 수 없습니다. 커서를 올렸을 때 플레이어에게 보이는 텍스트도 설정할 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e8ab432fd689e68f097f47e600c1789404f7ee4c%2Fclick-area.png?alt=media) ### 좌석 의자, 벤치 및 기타 좌석은 클릭하면 플레이어가 앉을 수 있게 해줍니다. * 좌석은 그것을 차지한 플레이어가 **멀어질 때만** 좌석에서 1.5미터 이상 떨어져야 비어집니다. * 벤치처럼 여러 자리가 있는 아이템에서는 클릭하면 **가장 가까운 빈 자리**. * 모든 자리가 차 있으면 호버 텍스트에 **좌석이 사용 중입니다** 라고 표시되며, 클릭해도 아무 일도 일어나지 않습니다. ### 텔레포트 그 **텔레포트** 아이템은 플레이어가 상호작용하면 다른 곳으로 보냅니다. 다음을 설정하세요 **x** 및 **y** 파라미터를 설정하세요. 플레이어를 Genesis City의 한 parcel로 보내려면 파라미터를 설정하세요. 플레이어를 [월드](/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds) 대신 보내려면 다음을 입력하세요 **월드** 파라미터에 월드 이름을 입력하세요. 예: `myname.dcl.eth` , 그리고 좌표는 비워 두세요. {% hint style="warning" %} **📔 참고**: 예전에는 별도의 **월드 텔레포트** 아이템이 있었습니다. 이제 제거되었습니다. 다음을 사용하세요 **텔레포트** 아이템을 다음의 **월드** 파라미터와 함께 대신 사용하세요. {% endhint %} ### 비디오 재생하기 다음 중 하나에서 비디오를 재생할 수 있습니다: * **로컬 파일** * **URL에서 스트리밍** * **다음에서 라이브 스트리밍** [**Decentraland Cast**](/creator/content-creator-ko/scene-editor/operate-live/live-streaming.md#dcl-cast-easy) * **다음에서 라이브 스트리밍** [**RTMP 소프트웨어**](/creator/content-creator-ko/scene-editor/operate-live/live-streaming.md#stream-advanced) **(OBS, XSplit, StreamYard 등)** {% hint style="warning" %} **📔 참고**: 비디오 재생은 성능 요구가 크므로 동시에 재생되는 비디오 수를 적게 유지하세요. 엔진은 각 플레이어의 품질 설정(낮음 1개, 중간 5개, 높음 10개)에 따라 동시에 재생할 수 있는 비디오 수를 제한하며, 그 한도를 넘는 비디오는 일시 중지합니다. 참조 [비디오 재생](/creator/content-creator-ko/scene-editor/interactivity/video-screen.md#play-videos). {% endhint %} 참고 [비디오 재생](/creator/content-creator-ko/scene-editor/interactivity/video-screen.md) 을 참조하세요. ### 오디오 스트림 재생하기 URL에서 오디오 스트림을 재생하려면 다음 스마트 아이템을 사용하세요 **오디오 스트림** 스마트 아이템. {% hint style="info" %} **📔 참고**: 모든 스트리밍 서비스가 사이트 밖에서 오디오를 재생하도록 허용하는 것은 아닙니다. 다음은 Decentraland에서 작동하는 몇 가지 예입니다: ```ts GRAFFITI = 'https://n07.radiojar.com/2qm1fc5kb.m4a?1617129761=&rj-tok=AAABeIR7VqwAilDFeUM39SDjmw&rj-ttl=5' SIGNS = 'https://edge.singsingmusic.net/MC2.mp3' DELTA = 'https://cdn.instream.audio/:9069/stream?_=171cd6c2b6e' JAZZ = 'https://live.vegascity.fm/radio/8010/the_flamingos.mp3' ``` {% endhint %} 스트림의 볼륨을 조절할 수 있습니다. 스트림의 오디오는 위치 기반이 아니므로, 씬 전체에서 일정한 음량으로 들립니다. ### NFT 표시하기 액자에 NFT를 표시하려면 다음 스마트 아이템을 사용하세요 **NFT** 스마트 아이템. 다음 필드를 제공해야 합니다: * 네트워크 {% hint style="info" %} **📔 참고**: 현재 **ethereum** 만 지원됩니다. {% endhint %} * NFT 컬렉션 컨트랙트: NFT 컬렉션의 스마트 컨트랙트입니다. * 토큰 ID: 이 특정 NFT 수집품의 토큰 ID입니다. NFT 모양 이 정보는 다음에서 얻을 수 있습니다 [OpenSea](https://opensea.io) , 다음을 확인하면 됩니다 **세부 정보** NFT 이미지 아래의 탭. OpenSea 세부정보 {% hint style="info" %} **📔 참고**: 이 정보는 opensea URL에서도 얻을 수 있습니다. 예를 들어 NFT의 URL이 다음과 같다면: > `https://opensea.io/assets/ethereum/0x32b7495895264ac9d0b12d32afd435453458b1c6/1956` 다음과 같이 필드를 채울 수 있습니다: * 네트워크: ethereum * 컨트랙트: 0x32b7495895264ac9d0b12d32afd435453458b1c6 * 토큰: 1956 {% endhint %} 배경색도 설정할 수 있으며, 이는 배경이 투명한 NFT에 특히 유용합니다. 또한 다음을 선택할 수 있습니다 **프레임 스타일** , NFT를 클래식하고 현대적인 다양한 스타일로 둘러쌀 수 있습니다. 참고 [NFT](/creator/content-creator-ko/scene-editor/build/nfts.md) 자세한 내용은 다음을 참조하세요. ### 체력 바 ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7527837b3d800afc079980b60be5474e6d055b56%2Fhealth-bar.png?alt=media) 그 **체력 바** 스마트 아이템은 여러 게임 메커니즘을 위한 훌륭한 기본 구성 요소입니다. 다양한 방식으로 사용할 수 있습니다: * 다음 아래에 배치하면 **플레이어** 아바타 위에 플레이어의 체력을 표시할 수 있습니다 ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4ba51729ed3cbcd78807385e4a315de8ea460a96%2Fnested-under-player.png?alt=media) * 다음 아래에 배치하면 **카메라** UI에 고정된 상태로 표시할 수 있습니다 ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3072a9cf441ecc75b66fba64c9ccbb367c4eb4f7%2Fnested-under-camera.png?alt=media) * 씬의 말 그대로 어떤 아이템 아래에라도 배치하여 그 아이템의 체력을 추적할 수 있습니다 ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5c9737b98956f6817efd09ad5de786331cbd9666%2Fnested-under-barrel.png?alt=media) 다른 아이템은 체력 바와 상호작용하여 체력을 더하거나 뺄 수 있습니다. * 다음과 같은 아이템은 **스파이크** 또는 **로봇 적** 체력을 낮출 수 있습니다 ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aed73698225063ac5cdd7257d9de8eb7c571e632%2Freduce-health.png?alt=media) * 다음과 같은 아이템은 **응급 처치** 또는 **힐링 패드** 체력을 회복시킬 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-2c80447061c76ae6b412ecbea4853f34d03469aa%2Frestore-health.png?alt=media) 체력이 0이 되었을 때 어떤 일이 일어날지 정의하려면 체력 바를 구성해야 합니다. 플레이어를 다음의 위치로 리스폰시킬 수 있습니다 **리스폰 패드** 스마트 아이템으로 리스폰시키거나, 점수 카운터를 초기화하거나, 적을 다시 생성하거나, UI 텍스트를 표시하거나, 게임 로직상 적절한 어떤 동작이든 할 수 있습니다. 체력이 특정 값보다 낮을 때 액션을 트리거할 수도 있습니다. 예를 들어 체력이 3 미만일 때 특별한 음악을 재생하거나 UI 힌트를 표시할 수 있습니다. 체력 바는 무엇이든 영향을 주도록 구성할 수 있습니다! 예를 들어, 다음 아래에 체력 바를 배치하세요 **나무 문** 스마트 아이템. 이 바의 체력은 플레이어가 다음을 사용해 낮출 수 있습니다 **검** 스마트 아이템뿐만 아니라 다음의 폭발로도 낮아질 수 있습니다 **통** 또는 다음의 공격으로 **로봇 적**. 이것이 작동하려면 체력 바가 값이 0일 때 부모 아이템에서 액션을 수행하도록 구성하세요. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-88d81e8b8ea6b0985853612179ccbe55fff7e1a4%2Fwall-with-health.png?alt=media) 다음과 같은 무기는 **검** 플레이어가 주울 수 있으며, 액션을 수행할 때 플레이어 근처에 있는 체력 바가 달린 다른 아이템에 피해를 주는 데 사용할 수 있습니다. ## 멀티플레이어 거의 모든 스마트 아이템은 멀티플레이어 동작을 하므로, 아이템의 상태가 바뀌면 씬의 모든 플레이어가 같은 경험을 공유합니다. 플레이어 A가 문을 열면 플레이어 B도 그 문이 열린 것을 보게 됩니다. 이후 다른 플레이어들이 아직 있는 동안 플레이어 C가 씬으로 들어오면, 그녀도 그 문이 이미 열려 있는 상태로 보게 됩니다. 그러나 씬 주변에 플레이어가 없으면 씬은 기본 상태로 복원됩니다. 따라서 모든 플레이어가 떠났다가 플레이어 A가 돌아오면, 문이 닫혀 있음을 보게 됩니다(그것이 문의 기본 상태였다면). 한 플레이어의 행동이 나중에 오는 다른 사람들의 씬을 망치지 않도록 씬을 설계하세요. 예를 들어 씬이 퍼즐 게임이라면 다음을 사용할 수 있습니다 *지연* 액션을 다음의 *도구* 스마트 아이템에 적용해, 퍼즐이 해결된 뒤 몇 초 후 씬의 모든 아이템이 초기 상태로 재설정되게 할 수 있습니다. 아이템의 멀티플레이어 동작도 비활성화할 수 있습니다. 참조 [Smart Items - 고급](/creator/content-creator-ko/scene-editor/interactivity/smart-items-advanced.md). ## 문제 해결 * *내 씬의 아이템은 클릭 가능해야 하는데 클릭할 수 없습니다*. 다른 무언가에 가려져 있지 않은지 확인하세요. 다른 아이템을 통과해서 클릭할 수는 없습니다. 일부 아이템에는 *콜라이더 메시* 단순화된 기하 구조가 있어서, 보이는 모양상 방해하지 않는 것처럼 보여도 실제로는 아이템을 가리고 있을 수 있습니다. 아이템을 옮겨서 어떤 일이 생기는지 확인해 보세요. ## 또한 참조 * [스마트 아이템 - 고급](/creator/content-creator-ko/scene-editor/interactivity/smart-items-advanced.md) * [상태와 조건](/creator/content-creator-ko/scene-editor/interactivity/states-and-conditions.md) * [어떤 항목이든 스마트 아이템으로 만들기](/creator/content-creator-ko/scene-editor/interactivity/make-any-item-smart.md) * [코드와 결합](/creator/content-creator-ko/scene-editor/extend-with-code/overview.md) --- # 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-ko/scene-editor/interactivity/smart-items.md?ask=&goal= ``` `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.