데이터 수집

Classic/VPC 환경에서 이용 가능합니다.

데이터 수집은 사용자의 질문에 적절한 답을 주기 위해 모델이 생각하고 판단하는 과정입니다. 데이터 수집 및 데이터 검토를 통해 모델의 사고 과정을 수정할 수 있습니다.

데이터 수집 화면

데이터 수집 화면은 다음과 같이 구성되어 있습니다.

데이터 수집 실행

데이터 수집을 통해 사용자 질의를 처리하기 위해 모델이 사고하고 판단하는 과정을 단계별로 살펴볼 수 있습니다.

데이터 수집을 실행하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio 메뉴를 차례대로 클릭해 주십시오.
2. My Product 메뉴에서 [CLOVA Studio 바로가기] 버튼을 클릭해 주십시오.
3. CLOVA Studio에서 스킬 트레이너 메뉴를 클릭해 주십시오.
4. 데이터를 수집할 스킬셋을 클릭해 주십시오.
5. 화면 왼쪽에 있는 데이터 수집 메뉴를 클릭해 주십시오.
6. 데이터 수집에 필요한 정보를 설정해 주십시오.
   • Engine / Version: 사용할 언어 모델 또는 버전 선택
   • Skill: 스킬셋 및 에 포함된 스킬 목록. 작업 상태가 '작업 완료'인 스킬만 활용 가능
   • Setting > 호출 옵션: 유저 쿼리로 API 호출 시 고정할 값 입력. 호출 옵션을 작성하는 방법은 호출 옵션 작성 참조
7. User Query 영역에 수집할 쿼리를 입력해 주십시오.
8. [실행] 버튼을 클릭해 주십시오.
   • 화면 오른쪽에 데이터 수집 단계가 순차적으로 표시됩니다.
   • [중단하기] 버튼을 클릭하면 해당 단계가 중단됩니다. [재실행] 버튼을 다시 클릭할 경우, 중단된 작업이 다시 실행됩니다.

데이터 검토 및 수정

데이터 수집을 실행한 후, 각 단계에서 모델이 제대로 판단하지 못한 부분이 있다면 직접 파라미터를 수정하여 더 정확한 답변을 생성하도록 개선할 수 있습니다.

수집한 데이터를 검토하고 수정하는 방법은 다음과 같습니다.

1. 데이터 수집 실행을 수행해 주십시오.
2. 쿼리 분석 결과 스킬 호출 결과를 확인해 주십시오.
   • 각 단계에 대한 자세한 설명은 데이터 수집 단계를 참조해 주십시오.
3. 각 단계의 [다음] 버튼을 클릭하여 다음 단계를 실행해 주십시오.
   • 새로운 데이터를 수집할 경우에는 최종 답변 단계까지 [다음] 버튼 없이 한 번에 생성됩니다.
4. 데이터를 수정하려면 각 필드를 클릭하여 수정한 후 [적용] 버튼을 클릭해 주십시오
   • 이후 단계의 데이터 생성이 재실행됩니다.
5. 최종 답변을 확인한 후 [작업 완료] 버튼을 클릭해 주십시오.
   • 해당 작업을 저장하여 나중에 다시 사용하려면 [임시저장] 버튼을 클릭해 주십시오.
   • 최종 답변이 생성되어야 [작업 완료] 버튼이 활성화됩니다.

데이터 불러오기

이전에 작업하던 데이터를 불러와서 검토하고 수정할 수 있습니다.

데이터를 불러오는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 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)
      • [필드 추가] 버튼 클릭 시 빈 필드 추가 생성
      • 아이콘 클릭 시 필드 삭제
  • 호출 결과: API 호출 결과
• Step 3: 호출 결과를 토대로 내용을 정리하는 단계
  • 생각: 호출 내용을 정리하기 위한 모델의 사고 과정
  • 결과 정리: 모델의 생성 결과

최종 답변

최종 답변을 생성하고 검토하는 단계입니다. 최종 답변이 생성된 후, [작업 완료] 버튼을 클릭해야 데이터 수집이 완료됩니다.

호출 옵션 작성

호출 옵션을 작성하면 API spec의 operation ID에 대응하여 헤더 및 본문 매개 변수의 특정값을 고정할 수 있습니다.

호출 옵션을 작성하는 방법은 다음과 같습니다.

1. 데이터 수집 실행 과정 중 화면 왼쪽에서 Setting 항목의 [호출 옵션] 버튼을 클릭해 주십시오.
   • 호출 옵션 창이 나타납니다.
2. 호출값 입력 영역에 호출 옵션을 JSON 타입으로 입력해 주십시오.
   • 창 상단의 예시 포맷을 참고하여 작성해 주십시오.
   • 호출값 입력에 대한 자세한 내용은 상세 호출 옵션을 참조해 주십시오.
3. 호출값 입력이 완료되면 [적용] 버튼을 클릭해 주십시오.
   • 적용 실패 시 오류 메시지가 나타납니다. 호출 값을 다시 수정해 주십시오.

상세 호출 옵션

호출 옵션에 작성 가능한 필드에 관한 정보입니다.
호출 옵션은 operations 필드, baseOperation 필드, 유저 쿼리 순으로 적용됩니다.