데이터 수집
    • PDF

    데이터 수집

    • PDF

    기사 요약

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

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

    데이터 수집 화면

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

    clovastudio-scenario_main_ko.png

    항목설명
    ① 데이터 수집 실행 영역데이터를 수집하기 위해 값을 설정하고 실행하는 영역
    • Engine / Version: 사용할 언어 모델이나 버전 선택
    • Skill: 선택한 스킬셋 및 버전에 포함된 스킬 목록. 작업 상태가 '작업 완료'인 스킬만 활용 가능
    • Setting > 호출 옵션: 유저 쿼리를 실행하여 API 호출 시 사용할 고정 값 지정
    • Setting > 답변 형식: 스킬셋에 설정된 답변 형식 정보 확인
    • User Query: 수집할 사용자 질의 입력. 스킬셋을 선택해야 해당 필드가 활성화됨
    • [불러오기] 버튼: 이전에 작업한 데이터를 불러오는 버튼
    • [실행] 버튼: 데이터 수집을 실행하는 버튼
    ② 데이터 수집 영역생성된 데이터를 검토하고 수집하는 영역
    • 쿼리 분석: 어떤 스킬을 사용할 것인지 User query 분석
    • 스킬 호출: 적절한 API를 호출하기 위한 모델의 사고 과정
    • 최종 답변: 호출 결과를 토대로 정리된 내용
    ③ 기능 버튼
    • [임시저장] 버튼: 현재까지 작업한 내용을 저장하는 버튼
    • [작업 완료] 버튼: 현재까지 작업한 내역을 완료하는 버튼. 최종 답변이 생성된 경우에만 활성화됨

    데이터 수집 실행

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

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

    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. [실행] 버튼을 클릭해 주십시오.
      • 화면 오른쪽에 데이터 수집 단계가 순차적으로 표시됩니다.
      • [중단하기] 버튼을 클릭하면 해당 단계가 중단됩니다. [재실행] 버튼을 다시 클릭할 경우, 중단된 작업이 다시 실행됩니다.
    참고

    데이터 수집을 실행한 후에는 Engine / Version, User Query를 수정할 수 없습니다. 수정이 필요한 경우, [초기화] 버튼을 클릭하여 작업을 새로 실행해 주십시오. [초기화] 버튼은 데이터 수집이 완료된 이후에 활성화됩니다.

    데이터 검토 및 수정

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

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

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

    데이터 불러오기

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

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

    1. 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio 메뉴를 차례대로 클릭해 주십시오.
    2. My Product 메뉴에서 [CLOVA Studio 바로가기] 버튼을 클릭해 주십시오.
    3. CLOVA Studio에서 스킬 트레이너 메뉴를 클릭해 주십시오.
    4. 스킬셋을 클릭해 주십시오.
    5. 화면 왼쪽의 데이터 수집 메뉴를 클릭해 주십시오.
    6. 데이터 수집 실행 영역의 [불러오기] 버튼을 클릭해 주십시오.
    7. 임시 저장된 작업 목록을 확인해 주십시오.
      • 불러오기 창 우측 상단에서 유저 쿼리를 기준으로 검색할 수 있습니다.
      • 데이터 결과를 확인하려면 [데이터] 버튼을 클릭해 주십시오.
      • 작업을 삭제하려면 삭제할 작업에 마우스 포인터를 올려놓으면 나타나는 i-clovastudio_reset.png 아이콘을 클릭해 주십시오.
      • 데이터 작업 화면에서 [작업 완료] 버튼을 클릭한 경우에만 작업 상태가 '작업 완료'로 표시됩니다.
    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 아이콘 클릭 시 필드 삭제
      • 호출 결과: API 호출 결과
    • Step 3: 호출 결과를 토대로 내용을 정리하는 단계
      • 생각: 호출 내용을 정리하기 위한 모델의 사고 과정
      • 결과 정리: 모델의 생성 결과
    참고
    • requests_post일 때 액션 입력 필드에 새로운 파라미터 생성 시 기존에 생성된 파라미터의 Key와 중복되지 않도록 설정해 주십시오. 중복된 Key가 있을 경우에는 API가 호출되지 않을 수 있습니다.

    최종 답변

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

    호출 옵션 작성

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

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

    1. 데이터 수집 실행 과정 중 화면 왼쪽에서 Setting 항목의 [호출 옵션] 버튼을 클릭해 주십시오.
      • 호출 옵션 창이 나타납니다.
    2. 호출값 입력 영역에 호출 옵션을 JSON 타입으로 입력해 주십시오.
      • 창 상단의 예시 포맷을 참고하여 작성해 주십시오.
      • 호출값 입력에 대한 자세한 내용은 상세 호출 옵션을 참조해 주십시오.
    3. 호출값 입력이 완료되면 [적용] 버튼을 클릭해 주십시오.
      • 적용 실패 시 오류 메시지가 나타납니다. 호출 값을 다시 수정해 주십시오.
    참고
    • 데이터 수집 화면에서 벗어난 후, 데이터 수집 메뉴로 다시 진입한 경우 호출 옵션이 초기화됩니다.
    • 호출 옵션을 적용하여 데이터를 수집한 후, [초기화] 버튼을 클릭하더라도 호출 옵션은 유지됩니다.
    • [불러오기] 버튼을 클릭하여 작업하던 내역을 불러올 경우, 해당 작업에 적용된 호출 옵션도 불러옵니다.

    상세 호출 옵션

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

    필드데이터 타입설명
    baseOperationobject해당 스킬셋 내에 등록된 모든 API에 대해 호출 옵션 적용
    baseOperation.headermap<string, string>모든 API의 HTTP Header에 고정으로 추가할 값
    baseOperation.querymap<string, string>모든 API의 HTTP Query Parameter에 고정으로 추가할 값
    baseOperation.requestBodymap<string, object>모든 API의 HTTP Request Body에 고정으로 추가할 값
    operationslist해당 스킬셋 내에 등록된 API 중 지정된 Operation ID에 한하여 호출 옵션 적용
    operations[].operationIdstring호출 옵션을 적용하고자 하는 Operation ID 지정
    operations[].headermap<string, string>지정된 Operation ID에 매핑되는 API의 HTTP Header에 고정으로 추가할 값
    operations[].querymap<string, string>지정된 Operation ID에 매핑되는 API의 HTTP Query Parameter에 고정으로 추가할 값
    operations[].requestBodymap<string, object>지정된 Operation ID에 매핑되는 API의 HTTP Request Body에 고정으로 추가할 값

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.