
如何對話式生成視頻分析報告VSS vss-generate-video-report 技能完整指南【免費下載鏈接】video-search-and-summarizationNVIDIA AI Blueprint for video search and summarization (VSS) is a GPU-accelerated reference architecture for building video analytics agents with real-time verified alerts, visual QA, and automated reporting. The VSS Blueprint uses vision language models (VLMs) such as NVIDIA Cosmos, LLMs such as NVIDIA Nemotron, RAG, and NVIDIA NIMs.項目地址: https://gitcode.com/GitHub_Trending/vi/video-search-and-summarizationNVIDIA VSSVideo Search and Summarization視頻搜索與摘要是一個 GPU 加速的視頻智能分析架構內置了vss-generate-video-report技能——讓你只需一句自然語言就能對話式生成視頻分析報告。無論是分析單個監(jiān)控片段、匯總一段時間內的所有告警事件還是檢查作業(yè)流程是否符合 SOP標準作業(yè)程序你都不需要手寫任何 API 調用只需像聊天一樣說幫我生成一份報告即可。本文帶你完整了解這個技能的 3 種報告模式、安裝方法和常用提示詞讓視頻分析從手動看錄像變成一句話出報告。什么是 VSS 視頻分析報告技能在 VSS 架構中Video Agent 是總調度員它接收用戶的自然語言請求規(guī)劃Plan后調用各類工具Tool Use其中就包括 Report Generation報告生成工具底層由 Cosmos 等視覺語言模型VLM提供視頻理解能力。vss-generate-video-report是 VSS Agent Skills 家族中的報告專家。它是一個自包含的技能包遵循 agentskills.io 規(guī)范可被 Claude Code、Codex、OpenClaw、NemoClaw 等 Agent 宿主加載。技能的核心文件 SKILL.md 定義了路由規(guī)則、前置檢查與輸出契約而具體的報告步驟和模板則放在references/子目錄中按需加載。 Agent Skills 與產品內的 VSS Agent 是兩套東西技能是開發(fā)者側工具裝在你的編碼 Agent 里VSS Agent 跑在部署的 VSS 工作流內部。兩者都能生成報告但入口不同。更多背景見 docs/agent-skills.mdx。3 種報告模式一句話路由到正確的后端技能會根據你的措辭自動路由到三種模式之一核心路由表見 SKILL.md#L21-L27模式場景數據來源典型說法A. 單片段分析分析一個錄制片段/傳感器視頻VLM 直接看視頻為這個視頻生成一份報告B. 事件范圍報告匯總某時間段內的告警/事件Video AnalyticsElasticsearch生成 12:31 到 12:32 的事件報告C. SOP 合規(guī)報告檢查作業(yè)流程是否合規(guī)VA-MCP 的 SOP 工具生成某傳感器的 SOP 合規(guī)報告在 VSS 產品界面的 Agent 對話中效果是這樣的——左邊上傳一段倉庫監(jiān)控視頻右邊只需問一句 Can you generate a report for this video?Agent 就會分析視頻并給出 Markdown / PDF 報告下載鏈接和視頻回放入口模式 A單片段 VLM 視頻分析報告最常用的模式。它支持兩種輸入路徑A1從 VIOS視頻存儲獲取已上傳視頻的片段 URL交給 VLM 分析A2直接提供本地視頻文件或 base64 數據不需要視頻存儲服務只需一個 VLM 端點即可。分析結果填入 video-analysis-report.md 模板固定包含兩部分Basic Information基本信息報告編號、分析日期/時間、視頻來源、片段時間范圍、片段鏈接、所用 VLM 模型、你的原始請求Analysis Results分析結果VLM 輸出的帶時間戳的逐段描述。默認的 VLM 提示詞在 default-vlm-prompt.md 中要求模型詳細描述視頻中發(fā)生的事情為每個片段/事件標注起止時間戳覆蓋場景、物體、人員、車輛和關鍵動作按時間順序輸出。報告生成步驟的完整說明見 video-analysis.md。一個典型的分析結果長這樣# Video Analysis Report ## Basic Information | Field | Value | |-------|-------| | Report Identifier | vss_report_20260920_093015 | | Video Source | warehouse_safety_0001 | | Clip Range | 12:31:05 - 12:32:40 | | VLM | nvidia/cosmos-reason2 (NIM) | ## Analysis Results 00:00 - 00:18 叉車沿主通道向右行駛速度平穩(wěn) 00:18 - 00:25 一名佩戴安全帽的工人從貨架間隙走出與叉車路徑接近 00:25 - 00:40 叉車減速并??抗と送ㄟ^ ...??長視頻規(guī)則片段時長≥120 秒時技能會拒絕走 VLM 直連路徑轉而建議使用 LVS長視頻摘要服務——因為長視頻直接喂給 VLM 既慢又貴。這條硬性規(guī)則在 video-analysis.md#L121-L127 中有詳細說明。模式 B事件范圍報告如果你部署了告警/事件分析管道如 Warehouse、Smart Cities 藍圖就可以直接問生成最近一次事件的報告或總結今天上午所有告警。技能會調用vss analytics incidents命令從 Elasticsearch 拉取VLM 已核驗的事件列表再按傳感器分組填入 incident-range-report.md 模板輸出事件總數、確認/駁回/未核驗統(tǒng)計、每條事件的時間戳/類別/判定理由/片段鏈接以及一段綜合摘要。值得強調的兩條誠實原則查不到事件時只會如實返回一行No incidents found...絕不編造事件該模式嚴格只讀永遠不會往 Elasticsearch 寫入或回填數據。模式 CSOP 合規(guī)報告面向需要核查作業(yè)流程的場景例如倉儲裝卸步驟是否按標準順序執(zhí)行。技能通過 VA-MCP 服務端的get_sop_report工具獲取聚合結果再渲染 sop-compliance-report.md 模板包含消息總量、合規(guī)狀態(tài)、各周期缺失/亂序步驟明細和觀察到的動作列表。同樣堅持只讀與數字原樣復現(xiàn)——絕不改寫或臆造上游統(tǒng)計值。如何安裝最快上手 3 步該技能是 Early Access 狀態(tài)已被 Claude Code 與 Codex 等宿主驗證可用。安裝思路很簡單讓 Agent 自己讀技能目錄、建軟鏈接。第 1 步獲取 VSS 倉庫git clone https://gitcode.com/GitHub_Trending/vi/video-search-and-summarization cd video-search-and-summarization第 2 步讓編碼 Agent 安裝技能對 Agent 說一句以 Claude Code 為例它會建立軟鏈接之后git pull即可自動保持技能最新Install only skills/operations/vss-generate-video-report/ for this host — register it under the skills own directory name, and symlink rather than copy.第 3 步用自然語言觸發(fā)報告安裝后在聊天中直接說下面任意一句話Agent 就會加載技能并自動路由想做的事直接說分析剛上傳的視頻為 warehouse_01.mp4 創(chuàng)建一份分析報告匯總某時段告警報告今天 9 點到 10 點 Camera_01 的事件查最近一次事件生成最近一次事件的報告檢查作業(yè)合規(guī)生成傳感器 X 最近 1 小時的 SOP 合規(guī)報告配合 NemoClaw 等常駐 Agent你還可以像下面這樣在對話界面里完成部署 → 管理攝像頭 → 生成報告的完整閉環(huán)常見問題與避坑指南 ?Q1請求含糊時技能會默認走哪個模式默認走模式 A單片段分析。只有當請求里同時出現(xiàn)傳感器名 時間段、但沒有事件/告警/SOP等關鍵詞時技能才會主動向你確認。完整的路由示例見 SKILL.md#L58-L67。Q2哪些請求不該用這個技能臨時性視覺問答卡車是什么顏色請用vss-ask-video語義檢索找所有叉車畫面請用vss-search-archive只要事件查詢、不需要渲染報告時用vss-query-analytics。技能的負觸發(fā)清單見 SKILL.md#L70-L80。Q3VLM 怎么選技能會自動探測標準端點Kubernetes 部署走公共 Ingress 的 RT-VLM 路由Docker 部署則探測 30082NIM Cosmos和 8018RT-VLM兩個宿主端口確認/models可用后才開始分析絕不靜默使用未知模型。Q4出錯了怎么辦技能采用快速失敗策略探測失敗、VLM 響應異常、片段鏈接無法轉為瀏覽器可訪問地址時會停下來說明具體原因和下一步恢復建議而不是用殘缺數據拼一份假報告。詳細規(guī)則見 SKILL.md#L381-L388 與 docs/agent-skills.mdx 的 Report Skill Error Handling 小節(jié)。關鍵文件速查文件作用SKILL.md技能入口模式路由、前置檢查、HITL 提示詞審批、錯誤處理references/report-types/video-analysis.md模式 A 的 4 步執(zhí)行流程片段解析 → VLM 選擇 → 調用 → 填模板references/report-types/incident-range.md模式 B事件拉取與范圍報告references/report-types/sop-compliance.md模式 CSOP 合規(guī)工具調用與報告references/report-templates/3 份報告 Markdown 模板references/default-vlm-prompt.md默認 VLM 分析提示詞可編輯evals/技能評測用例想深入了解 VSS Agent 的整體能力事件查詢、傳感器快照、多圖問答等可以繼續(xù)閱讀 docs/vss-agent/VSS-Agent-Overview.mdx關于視頻搜索與摘要的完整文檔入口在 docs/index.mdx。小結vss-generate-video-report把看視頻、找事件、寫報告這件繁瑣的活壓縮成了一句自然語言。它用 3 種模式覆蓋了從單片段分析到大規(guī)模事件匯總、再到流程合規(guī)核查的主要場景并以絕不編造數據的誠實原則保證了報告的可信度。如果你的 VSS 部署已經跑起來不妨現(xiàn)在就試一句為這個視頻生成一份報告?!久赓M下載鏈接】video-search-and-summarizationNVIDIA AI Blueprint for video search and summarization (VSS) is a GPU-accelerated reference architecture for building video analytics agents with real-time verified alerts, visual QA, and automated reporting. The VSS Blueprint uses vision language models (VLMs) such as NVIDIA Cosmos, LLMs such as NVIDIA Nemotron, RAG, and NVIDIA NIMs.項目地址: https://gitcode.com/GitHub_Trending/vi/video-search-and-summarization創(chuàng)作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考