# 인사이트

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

음성 전사 없이 텍스트를 직접 요약하려면 [텍스트 인사이트 API](/docs/text-insight.md)를 사용하세요.

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

[구축형(On-premise) 혹은 Enterprise 기능 문의 바로가기](/docs/pricing.md#plans)

## 설정 방법[​](#configuration "설정 방법에 대한 직접 링크")

[요청 바디](/docs/stt-file.md#request-body)의 `config`에 아래 파라미터를 설정합니다.

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

키워드 부스팅을 위해 `keywords`를 설정한 경우, 같은 키워드가 인사이트 생성 과정의 참고 힌트로도 사용됩니다. `keywords` 설정 방법은 [키워드 부스팅](/docs/stt-file/keywords.md)을 참고하세요.

### 요청 예시[​](#request-example "요청 예시에 대한 직접 링크")

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

```

POST 요청 예제: [일반 STT 샘플 코드](/docs/stt-file.md#sample-code-2)

전체 예제: [일반 STT 샘플 코드](/docs/stt-file.md#unified-example)

## 결과 조회[​](#result-retrieval "결과 조회에 대한 직접 링크")

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

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

```

## 인사이트 응답 예시[​](#insight-response-example "인사이트 응답 예시에 대한 직접 링크")

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

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

```diff-json
{
  "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": "문의"
+     }
+   ]
  }
}

```

## 제한 사항[​](#limitations "제한 사항에 대한 직접 링크")

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