> 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/tutorials-and-examples/scene-management-feedback/playtest-feedback.md).

# 씬 피드백

플레이 중 또는 피드백 버튼, 키오스크, 영역을 통해 플레이어 평점과 댓글을 수집하고, CSV 결과를 씬 스토리지에 저장합니다.

<figure><img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-69f5277fafd637eb48de789770caff45f1000a6c%2Fscene-feedback-invitation.webp?alt=media" alt="Coin Hunt participation invitation with Skip and Give feedback buttons" width="400"><figcaption><p>데모에서는 플레이어가 참여 여부를 선택할 수 있습니다.</p></figcaption></figure>

플레이어가 게임하는 모습을 직접 볼 수 없더라도, 무엇을 헷갈려 하고 답답해하며 즐거워하는지 알아보세요. 이 재사용 가능한 모듈에는 코인 찾기 장면이 포함되어 있어, 플레이 중에 피드백을 수집하는 방법과 플레이어가 피드백을 제공하기로 선택하는 시점을 보여 줍니다.

* [공유 테스트 빌드 플레이(Zone)](https://decentraland.zone/jump/?dclenv=zone\&realm=sdk7testscenes.dcl.eth\&position=0,-1)
* [설치 및 사용 안내](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/README.md)

## 프로젝트 정보

**관리자:** Decentraland

[소스 보기](https://github.com/decentraland/sdk7-test-scenes/tree/main/scenes/0,-1-scene-feedback)

**라이선스:** 이 카탈로그에서는 확인되지 않았습니다. 재사용하기 전에 적용되는 조건을 업스트림 저장소와 관리자에게 확인하세요.

## AI 에이전트로 추가하기

1. 다음이 설치되어 있고 [Decentraland SDK Skills](https://github.com/decentraland/sdk-skills#updating-skills) 최신 버전인지 확인하세요.
2. AI 에이전트에게 다음과 같이 말하세요. "이 장면에서 플레이어 피드백을 수집하고 싶어요."

에이전트는 Scene Feedback 스킬을 사용해 다음 두 단계에서 도움을 줄 수 있습니다.

* **플레이 테스트 전:** 게임에 맞게 질문, 평점 척도, 시기를 조정한 다음 계획을 검토하고 모듈을 통합하세요.
* **플레이 테스트 후:** CSV 파일을 사용해 스킬을 다시 실행하면 반복해서 나타나는 문제와 선호 사항을 파악하고, 근거를 검토한 뒤 다음에 조사할 내용을 결정할 수 있습니다. 그룹별 답변과 평점 요약이 포함된 [사람이 읽기 쉬운 HTML 보고서](#example-ai-generated-feedback-report) 도 요청할 수 있습니다.

직접 통합하고 싶으신가요? [설치 가이드](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/README.md#add-it-to-your-scene).

## 모듈이 씬에 통합되는 방식

플레이어를 언제 초대할지, 어떤 질문을 할지, 게임에서 질문을 언제 표시할지는 직접 선택합니다. The [Zone의 코인 헌트 데모](https://decentraland.zone/jump/?dclenv=zone\&realm=sdk7testscenes.dcl.eth\&position=0,-1) 가능한 설정 예시를 보여 줍니다:

1. **첫 번째 코인을 모으세요.** 초대 메시지에서 플레이어에게 피드백을 제공할지 묻습니다. "안녕하세요, 코인 헌트 팀입니다!" 수락하면 질문이 하나 이어집니다. "코인을 찾기가 얼마나 쉬웠거나 어려웠나요?" 플레이어는 평점을 선택하고 의견을 추가할 수 있습니다.
2. **첫 번째 라운드(코인 5개)를 완료하세요.** 참여에 동의한 플레이어에게는 두 가지 질문이 차례로 표시됩니다. 다음 목표가 얼마나 명확한지, 계속 플레이할 의향이 있는지 묻습니다.
3. **언제든지 피드백을 남기세요.** 방문자는 누구나 **피드백 남기기** 버튼, 클릭 가능한 키오스크 또는 표시된 영역을 사용해 환영 메시지와 질문 세트를 열 수 있습니다. 게임 관련 질문을 거절한 뒤에도 이용할 수 있습니다.

플레이어의 참여 방식을 선택하세요:

* **참여를 선택한 플레이어:** 화면에 표시되는 메시지로 플레이어를 초대하거나, 버튼, 키오스크 또는 표시된 구역을 통해 피드백 양식을 열 수 있도록 합니다.
* **선정된 테스터:** 게임 로직을 사용해 지갑 목록이나 다른 규칙에 따라 테스터를 선택한 다음, 다음 항목을 사용해 등록합니다 `feedback.enroll`. 자세한 내용은 [선정된 테스터 예시](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/EXAMPLES.md#4-selected-testers-without-an-intro).
* **또는 누구나 참여하도록 하세요:** 사전 초대나 테스터 목록 없이 플레이 중인 방문자에게 질문을 표시합니다. 플레이어는 참여를 거부할 수 있습니다. 자세한 내용은 [참여 설정](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/README.md#asking-participants-during-play-dynamic-approach).

<figure><img src="https://raw.githubusercontent.com/decentraland/sdk7-test-scenes/main/scenes/0%2C-1-scene-feedback/assets/images/feedback-panel.png" alt="Example feedback form with five rating choices and an optional comment field" width="400"><figcaption><p>라벨이 지정된 평점과 선택 입력란을 포함하는 질문입니다.</p></figcaption></figure>

## 주요 기능

* **유연한 질문.** 미리 준비된 질문과 평점 척도를 선택해 게임에 맞게 수정하거나 직접 만들어 보세요. 라벨이 지정된 평점, 선택 입력란 또는 텍스트만 입력하는 답변을 사용할 수 있습니다.
* **참여 보상.** 게임에 어울리는 보상으로 참여를 유도하세요. 데모에서는 한 양식의 모든 질문에 답하면 방문 1회당 한 번, 본인에게만 보이는 방문 한정 Playtest Contributor 네임플레이트와 코인 점수 +5, 그리고 다음 5개 아이템 획득 시 점수 두 배를 받습니다. 어떤 평점을 선택해도 인정되며, 댓글은 선택 사항입니다.
* **장면 Storage에 저장되는 CSV 결과.** Multiplayer Server는 각 응답을 해당 질문 및 게임플레이 시점과 함께 저장합니다. 파일을 다운로드해 스프레드시트에서 검토하세요.

## 장면에 맞게 수정하기

사용 [통합 레시피](https://github.com/decentraland/sdk7-test-scenes/blob/main/scenes/0,-1-scene-feedback/EXAMPLES.md) 질문을 자체 게임 이벤트에 연결하여 지금 참가자를 초대하고 이후 게임 플레이가 끝난 뒤 질문할 수 있습니다. 플레이 테스트 계획과 플레이어 모집에 관한 내용은 [플레이 테스트](https://docs.decentraland.org/creator/scenes-sdk7/designing-the-experience/playtests).

## AI가 생성한 피드백 보고서 예시

**이 보고서는 Scene Feedback 모듈이 아니라 AI 에이전트가 생성합니다.** 내보낸 CSV 파일을 에이전트에 제공하고 Scene Feedback SDK 스킬을 사용해 파일을 분석하고 HTML 보고서를 생성하세요.

이 예시에서는 가상의 장면에 대한 합성 응답을 사용합니다. 에이전트는 자체 플레이 테스트 질문과 데이터에 맞춰 분석과 보고서를 조정할 수 있습니다.

<figure><img src="https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9b424161af41d71ba3d5280c1f523c0793992083%2Fscene-feedback-example-report.webp?alt=media" alt="Synthetic racing-scene report showing a main finding, response counts and a rating distribution" width="600"><figcaption><p>가상의 장면에 대한 합성 응답을 사용한 예시 보고서입니다.</p></figcaption></figure>

{% file src="/files/c23f046fd8fb709abba50c62d5e7e6e22a655799" %}
예시 보고서를 다운로드하고 ZIP 파일의 압축을 푼 다음 HTML 파일을 브라우저에서 여세요.
{% endfile %}


---

# 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-ko/tutorials-and-examples/scene-management-feedback/playtest-feedback.md?ask=<question>&goal=<user_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.
