인사이트

인사이트는 전사 결과를 요약하여 제목·요약 내용·분류를 반환하는 기능입니다.

음성 전사 없이 텍스트를 직접 요약하려면 텍스트 인사이트 API를 사용하세요.

인사이트 기능을 사용하기 위해서는, "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에서 확인할 수 있습니다.