Vega Agent / Video Q&A
On this page
Endpoint: https://smartmedia.vod-qcloud.com/agui
인증: VOD ApiToken / Bearer
미디어 지식베이스에 수집된 영상을 검색하고 영상 내용에 대한 질문에 답변합니다. forwardedProps.database로 질문 대상 지식베이스를 지정합니다.
기본 정보
| 항목 | 값 |
|---|---|
| 서비스 | VOD Media AI Agent |
| 요청 경로 | POST /agui/chat |
| 시나리오 | video-qa |
| 입력 | 질문, 지식베이스 이름 |
| 준비 사항 | 지식베이스 생성 및 영상 수집 완료 |
| 출력 | 검색 / 도구 실행 이벤트와 답변 텍스트 |
호출 준비
- VOD의 지능형 미디어 기능에서 영상 지식베이스를 생성합니다.
- 질문 대상 영상을 수집하고 분석이 완료되었는지 확인합니다.
- 해당 지식베이스 이름을
forwardedProps.database로 지정합니다.
미디어 수집과 질문 요청은 별도 단계입니다. 질문에 영상 URL을 적는 것만으로 해당 영상이 지식베이스에 수집되지는 않습니다.
요청 파라미터
| 파라미터 | 필수 | 타입 | 설명 |
|---|---|---|---|
forwardedProps.scenario_name |
필수 | String | video-qa |
forwardedProps.database |
선택 | String | 지식베이스 이름. 기본값 default |
forwardedProps.model |
선택 | String | Vega Agent 모델 ID |
messages[].role |
필수 | String | 질문 입력은 user |
messages[].content |
필수 | String | 검색 또는 질의응답 요청 |
대화 ID, 실행 ID와 인증은 API Reference를 따릅니다.
요청 예시
LANGUAGE
{
"threadId": "thread-001",
"runId": "run-001",
"messages": [
{
"role": "user",
"content": "제품 시연 영상에서 배터리 사용 시간에 대한 설명을 찾아 요약하세요. 관련 영상과 해당 구간을 함께 안내하세요."
}
],
"forwardedProps": {
"model": "wand-vega-agent-1.0-pro",
"scenario_name": "video-qa",
"approval_mode": "never",
"database": "product-videos"
}
}질문 예시
| 용도 | 질문 예시 |
|---|---|
| 장면 검색 | 제품 설치 과정을 설명하는 영상을 찾아 주세요. |
| 내용 확인 | 제품 시연 영상에서 설명한 배터리 사용 시간을 정리하세요. |
| 정보 추출 | 교육 영상에 등장하는 안전 점검 절차를 순서대로 정리하세요. |
검색 범위와 확인할 내용을 구체적으로 지정하면 답변에 필요한 미디어를 선택하기 쉽습니다.
응답 처리
검색 도구의 호출 및 결과는 TOOL_CALL_* 이벤트로 전달됩니다. 답변은 TEXT_MESSAGE_CONTENT.delta를 messageId별로 연결해 표시합니다. 이벤트의 필드 구조는 응답 이벤트를 따릅니다.
대화 이어가기
이어지는 질문은 같은 threadId와 지식베이스 이름을 사용하고 새 runId를 지정합니다. 이전 대화는 /agui/history로 조회하고, 진행 중인 요청은 /agui/cancel로 취소합니다.