--- title: "데이터 수집" slug: "clovastudio-scenario" updated: 2026-08-20T09:03:13Z published: 2026-08-20T09:03:13Z canonical: "guide-gov.ncloud-docs.com/clovastudio-scenario" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 데이터 수집 Classic/VPC 환경에서 이용 가능합니다. 데이터 수집은 사용자의 질문에 적절한 답을 주기 위해 모델이 생각하고 판단하는 과정입니다. 데이터 수집 및 데이터 검토를 통해 모델의 사고 과정을 수정할 수 있습니다. ## 데이터 수집 화면 데이터 수집 화면은 다음과 같이 구성되어 있습니다. ![clovastudio-scenario_main_ko.png](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/clovastudio-scenario_main_ko(2).png) | 항목 | 설명 | | --- | --- | | ① 데이터 수집 실행 영역 | 데이터를 수집하기 위해 값을 설정하고 실행하는 영역 - **Model / Version**: 사용할 언어 모델이나 버전 선택 - **Skill**: 선택한 스킬셋 및 버전에 포함된 스킬 목록. 작업 상태가 '작업 완료'인 스킬만 활용 가능 - **Setting > 호출 옵션**: 유저 쿼리를 실행하여 API 호출 시 사용할 고정 값 지정 - **Setting > 답변 형식**: 스킬셋에 설정된 답변 형식 정보 확인 - **User Query**: 수집할 사용자 질의 입력. 스킬셋을 선택해야 해당 필드가 활성화됨 - **[→]** 버튼: 데이터 수집을 실행하는 버튼 | | ② 데이터 수집 영역 | 생성된 데이터를 검토하고 수집하는 영역 - **쿼리 분석**: 어떤 스킬을 사용할 것인지 User Query 분석 - **스킬 호출**: 적절한 API를 호출하기 위한 모델의 사고 과정 - **최종 답변**: 호출 결과를 토대로 정리된 내용 | | ③ 기능 버튼 | - **[불러오기]** 버튼: 이전에 작업한 데이터를 불러오는 버튼 - **[임시저장]** 버튼: 현재까지 작업한 내용을 저장하는 버튼 - **[작업 완료]** 버튼: 현재까지 작업한 내역을 완료하는 버튼. 최종 답변이 생성된 경우에만 활성화됨 | ## 데이터 수집 실행 데이터 수집을 통해 사용자 질의를 처리하기 위해 모델이 사고하고 판단하는 과정을 단계별로 살펴볼 수 있습니다. 데이터 수집을 실행하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI Services** > **CLOVA Studio** 메뉴를 차례대로 클릭해 주십시오. 2. **My Product** 메뉴에서 **[CLOVA Studio 바로가기]** 버튼을 클릭해 주십시오. 3. CLOVA Studio에서 **스킬 트레이너** 메뉴를 클릭해 주십시오. 4. 데이터를 수집할 스킬셋을 클릭해 주십시오. 5. **[데이터 수집]** 탭을 클릭해 주십시오. 6. 데이터 수집에 필요한 정보를 설정해 주십시오. - **Model / Version**: 사용할 언어 모델 또는 버전 선택 - **Skill**: 스킬셋에 포함된 스킬 목록. 작업 상태가 '작업 완료'인 스킬만 활용 가능 - **Setting** > **호출 옵션**: 유저 쿼리로 API 호출 시 고정할 값 입력. 호출 옵션을 작성하는 방법은 [호출 옵션 작성](/docs/clovastudio-scenario#%ED%98%B8%EC%B6%9C%EC%98%B5%EC%85%98%EC%9E%91%EC%84%B1) 참조 7. **User Query** 영역에 수집할 쿼리를 입력해 주십시오. 8. **[→]** 버튼을 클릭해 주십시오. - 화면 왼쪽에 데이터 수집 단계가 순차적으로 표시됩니다. - **[중단하기]** 버튼을 클릭하면 해당 단계가 중단됩니다. **[재실행하기]** 버튼을 다시 클릭할 경우, 중단된 작업이 다시 실행됩니다. 참고 데이터 수집을 실행한 후에는 **Model / Version**, **User Query**를 수정할 수 없습니다. 수정이 필요한 경우, **[초기화]** 버튼을 클릭하여 작업을 새로 실행해 주십시오. **[초기화]** 버튼은 데이터 수집이 완료된 이후에 활성화됩니다. ## 데이터 검토 및 수정 데이터 수집을 실행한 후, 각 단계에서 모델이 제대로 판단하지 못한 부분이 있다면 직접 파라미터를 수정하여 더 정확한 답변을 생성하도록 개선할 수 있습니다. 수집한 데이터를 검토하고 수정하는 방법은 다음과 같습니다. 1. [데이터 수집 실행](/docs/clovastudio-scenario#%EB%8D%B0%EC%9D%B4%ED%84%B0%EC%88%98%EC%A7%91%EC%8B%A4%ED%96%89)을 수행해 주십시오. 2. 쿼리 분석 결과 스킬 호출 결과를 확인해 주십시오. - 각 단계에 대한 자세한 설명은 [데이터 수집 단계](/docs/clovastudio-scenario#%EB%8D%B0%EC%9D%B4%ED%84%B0%EC%88%98%EC%A7%91%EB%8B%A8%EA%B3%84)를 참조해 주십시오. 3. 각 단계의 **[다음]** 버튼을 클릭하여 다음 단계를 실행해 주십시오. - 새로운 데이터를 수집할 경우에는 최종 답변 단계까지 **[다음]** 버튼 없이 한 번에 생성됩니다. 4. 데이터를 수정하려면 각 필드를 클릭하여 수정한 후 **[적용]** 버튼을 클릭해 주십시오 - 이후 단계의 데이터 생성이 재실행됩니다. 5. 최종 답변을 확인한 후 **[작업 완료]** 버튼을 클릭해 주십시오. - 해당 작업을 저장하여 나중에 다시 사용하려면 **[임시저장]** 버튼을 클릭해 주십시오. - 최종 답변이 생성되어야 **[작업 완료]** 버튼이 활성화됩니다. ## 데이터 불러오기 이전에 작업하던 데이터를 불러와서 검토하고 수정할 수 있습니다. 데이터를 불러오는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI Services** > **CLOVA Studio** 메뉴를 차례대로 클릭해 주십시오. 2. **My Product** 메뉴에서 **[CLOVA Studio 바로가기]** 버튼을 클릭해 주십시오. 3. CLOVA Studio에서 **스킬 트레이너** 메뉴를 클릭해 주십시오. 4. 스킬셋을 클릭해 주십시오. 5. **[데이터 수집]** 탭을 클릭해 주십시오. 6. 데이터 수집 실행 영역의 **[불러오기]** 버튼을 클릭해 주십시오. 7. 임시 저장된 작업 목록을 확인해 주십시오. - 불러오기 창 우측 상단에서 유저 쿼리를 기준으로 검색할 수 있습니다. - 데이터 결과를 확인하려면 목록에서 **[⋮]** > **[데이터 보기]** 버튼을 클릭해 주십시오. - 작업을 삭제하려면 목록에서 **[⋮]** > **[삭제]** 버튼을 클릭해 주십시오. - 데이터 작업 화면에서 **[작업 완료]** 버튼을 클릭한 경우에만 작업 상태가 '작업 완료'로 표시됩니다. 8. 데이터 수집 화면에서 기존 쿼리에 대한 작업을 수정하려면 **[열기]** 버튼을 클릭해 주십시오. - 데이터 수집 화면이 나타나며 기존 쿼리에 대한 작업을 이어나갈 수 있습니다. - 해당 작업에 적용된 호출 옵션도 함께 불러옵니다. ## 데이터 수집 단계 데이터 수집은 쿼리 분석, 스킬 호출, 최종 답변의 순서로 실행됩니다. 각 데이터 수집 단계에서 수행하는 작업에 대해 설명합니다. ### 쿼리 분석 유저 쿼리를 분석하여 어떤 스킬을 사용할 것인지 결정하는 단계입니다. 요청 단위로 쿼리를 분리하고 적절한 스킬을 매핑합니다. 두 개 이상의 쿼리가 분석될 경우 스킬 호출도 두 번 수행됩니다. ### 스킬 호출 스킬을 호출하고 모델의 사고를 검토하는 단계입니다. 쿼리 분석 단계에서 분리된 쿼리 개수만큼 스킬 호출이 수행됩니다. 스킬 호출은 3단계로 구성됩니다. - Step 1: 호출할 스킬에 해당하는 API를 조회하는 단계 - **호출 방안**: API를 찾기 위한 모델의 사고 과정 - **호출 스킬**: 스킬의 모델 이름 - **API 조회 내용**: 스킬의 API Spec 및 Description for model 정보 - Step 2: API 조회 결과를 확인하는 단계 - **API 조회 결과**: API를 호출하기 위한 모델의 사고 과정. API 호출에 필요한 요청 변수(파라미터) 추론 - **액션**: API 메소드. requests_get과 requests_post만 지원 - **액션 입력**: 모델이 추론한 URL 및 파라미터. 액션에 따라 입력 필드가 달라짐 - requests_get일 때 액션 입력 필드: API URL/파라미터 - requests_post일 때 액션 입력 필드: API URL/파라미터(Key, Value) - **[필드 추가]** 버튼 클릭 시 빈 필드 추가 생성 - ![i-clovastudio_reset.png](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-clovastudio_reset.png) 아이콘 클릭 시 필드 삭제 - **호출 결과**: API 호출 결과 - Step 3: 호출 결과를 토대로 내용을 정리하는 단계 - **생각**: 호출 내용을 정리하기 위한 모델의 사고 과정 - **결과 정리**: 모델의 생성 결과 참고 requests_post일 때 액션 입력 필드에 새로운 파라미터 생성 시 기존에 생성된 파라미터의 Key와 중복되지 않도록 설정해 주십시오. 중복된 Key가 있을 경우에는 API가 호출되지 않을 수 있습니다. ### 최종 답변 최종 답변을 생성하고 검토하는 단계입니다. 최종 답변이 생성된 후, **[작업 완료]** 버튼을 클릭해야 데이터 수집이 완료됩니다. ## 호출 옵션 작성 호출 옵션을 작성하면 API spec의 operation ID에 대응하여 헤더 및 본문 매개 변수의 특정값을 고정할 수 있습니다. 호출 옵션을 작성하는 방법은 다음과 같습니다. 1. [데이터 수집 실행](/docs/clovastudio-scenario#%EB%8D%B0%EC%9D%B4%ED%84%B0%EC%88%98%EC%A7%91%EC%8B%A4%ED%96%89) 과정 중 화면 오른쪽에서 **Setting** 항목의 **[호출 옵션]** 버튼을 클릭해 주십시오. - **호출 옵션** 창이 나타납니다. 2. 호출값 입력 영역에 호출 옵션을 JSON 타입으로 입력해 주십시오. - 창 상단의 예시 포맷을 참고하여 작성해 주십시오. - 호출값 입력에 대한 자세한 내용은 [상세 호출 옵션](/docs/clovastudio-scenario#%EC%83%81%EC%84%B8%ED%98%B8%EC%B6%9C%EC%98%B5%EC%85%98)을 참조해 주십시오. 3. 호출값 입력이 완료되면 **[적용]** 버튼을 클릭해 주십시오. - 적용 실패 시 오류 메시지가 나타납니다. 호출 값을 다시 수정해 주십시오. 참고 - 데이터 수집 화면에서 벗어난 후, **데이터 수집** 메뉴로 다시 진입한 경우 호출 옵션이 초기화됩니다. - 호출 옵션을 적용하여 데이터를 수집한 후, **[초기화]** 버튼을 클릭하더라도 호출 옵션은 유지됩니다. - **[불러오기]** 버튼을 클릭하여 작업하던 내역을 불러올 경우, 해당 작업에 적용된 호출 옵션도 불러옵니다. ### 상세 호출 옵션 호출 옵션에 작성 가능한 필드에 관한 정보입니다. 호출 옵션은 operations 필드, baseOperation 필드, 유저 쿼리 순으로 적용됩니다. | 필드 | 데이터 타입 | 설명 | | --- | --- | --- | | baseOperation | object | 해당 스킬셋 내에 등록된 모든 API에 대해 호출 옵션 적용 | | baseOperation.header | map | 모든 API의 HTTP Header에 고정으로 추가할 값 | | baseOperation.query | map | 모든 API의 HTTP Query Parameter에 고정으로 추가할 값 | | baseOperation.requestBody | map | 모든 API의 HTTP Request Body에 고정으로 추가할 값 | | operations | list | 해당 스킬셋 내에 등록된 API 중 지정된 Operation ID에 한하여 호출 옵션 적용 | | operations[].operationId | string | 호출 옵션을 적용하고자 하는 Operation ID 지정 | | operations[].header | map | 지정된 Operation ID에 매핑되는 API의 HTTP Header에 고정으로 추가할 값 | | operations[].query | map | 지정된 Operation ID에 매핑되는 API의 HTTP Query Parameter에 고정으로 추가할 값 | | operations[].requestBody | map | 지정된 Operation ID에 매핑되는 API의 HTTP Request Body에 고정으로 추가할 값 |