Vega Agent / Video Q&A
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。
请求示例
json
{
"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 取消进行中的请求。