인사이트

인사이트는 전사 결과를 기반으로 지정한 관점의 정보를 추출하는 기능입니다.

인사이트 기능을 사용하기 위해서는, "enterprise" 라이선스 계약이 필요합니다. 아래 바로가기를 통해 문의해주세요.

구축형(On-premise) 혹은 Enterprise 기능 문의 바로가기

설정 방법

요청 바디의 config에 아래 파라미터를 설정합니다.

Name	Type	Default	Desc
use_insight	Boolean	false	true로 설정할 경우, 전사 결과 기반 인사이트 생성을 요청합니다.
insight.prompt	String		인사이트 생성 시 참고할 관점이나 지시사항입니다. 생략할 수 있으며, use_insight가 true일 때만 적용됩니다.

키워드 부스팅을 위해 keywords를 설정한 경우, 같은 키워드가 인사이트 생성 과정의 참고 힌트로도 사용됩니다. keywords 설정 방법은 키워드 부스팅을 참고하세요.

요청 예시

{
  "use_insight": true,
  "insight": {
    "prompt": "상담 내용에서 고객의 주요 요청사항과 후속 조치가 필요한 내용을 정리해 주세요."
  }
}

POST 요청 예제: 일반 STT 샘플 코드

전체 예제: 일반 STT 샘플 코드

결과 조회

전사 요청 후에는 기존 일반 STT 결과 조회 API로 결과를 확인합니다. 인사이트 결과는 기본 전사 결과가 완료되면 같은 응답의 results.insight 필드에 포함됩니다.

GET https://openapi.vito.ai/v1/transcribe/{TRANSCRIBE_ID}

인사이트 응답 예시

응답 형식은 배열이며, 일반 STT 인사이트는 한 요청에 대해 하나의 인사이트 항목을 반환합니다.

Name	Desc	Type	Value
results.insight[].title	인사이트 제목	string
results.insight[].summary	인사이트 내용	string
results.insight[].category	인사이트 분류	string	일상, 문의, 업무, 스팸

{
  "id": "{TRANSCRIBE_ID}",
  "status": "completed",
  "results": {
    "utterances": [
      {
        "start_at": 4737,
        "duration": 2360,
        "msg": "상품 배송 일정 확인하려고 연락드렸습니다.",
        "spk": 0,
        "lang": "ko"
      },
      {
        "start_at": 8197,
        "duration": 3280,
        "msg": "확인 후 오늘 오후에 다시 안내드리겠습니다.",
        "spk": 1,
        "lang": "ko"
      }
    ],
+   "insight": [
+     {
+       "title": "배송 일정 확인 요청",
+       "summary": "고객은 상품 배송 일정을 문의했고, 상담사는 확인 후 당일 오후에 다시 안내하기로 했습니다.",
+       "category": "문의"
+     }
+   ]
  }
}

제한 사항

• 인사이트 결과는 기본 전사 결과 조회 응답의 results.insight에서 확인할 수 있습니다.