vss-generate-video-report

vss-generate-video-report

Ce skill est un composant opérationnel du blueprint NVIDIA AI Blueprint for Video Search and Summarization (VSS). Son rôle est de produire des rapports d'analyse vidéo structurés en sélectionnant automatiquement l'un de trois modes de traitement selon la nature de la demande : analyse d'un clip enregistré via un VLM (Mode A), rapport sur une plage d'incidents via le backend d'analytics (Mode B), ou rapport de conformité SOP via les outils VA-MCP (Mode C).

Trois modes de génération de rapport

• Mode A — Clip vidéo : récupère une URL de clip depuis VIOS (/vss-manage-video-io-storage) ou accepte un fichier local/base64, puis interroge directement un VLM compatible OpenAI (chat/completions) pour produire un Video Analysis Report. Ce mode inclut une logique HITL (Human-in-the-Loop) optionnelle pour valider le prompt avant l'appel VLM.
• Mode B — Plage d'incidents : délègue à /vss-query-analytics pour récupérer les incidents dans une fenêtre temporelle donnée, puis rend un Incident Range Report à partir du template dédié.
• Mode C — Conformité SOP : appelle directement video_analytics__get_sop_report sur le VA-MCP (déployé par le profil SOP) et produit un SOP Compliance Report. Ce mode requiert que les outils get_sop_* soient présents sur le VA-MCP.

Intégration dans le repo parent

Ce skill s'inscrit dans l'ensemble des skills agents du blueprint VSS, aux côtés de /vss-ask-video, /vss-query-analytics, /vss-manage-video-io-storage, /vss-summarize-video et /vss-deploy-profile. Il est conçu pour être utilisé par un agent orchestrateur (via MCP ou OpenClaw) et ne doit jamais router les rapports via POST /generate du VSS agent. La résolution des endpoints (Kubernetes/Helm ou Docker Compose) est gérée via des variables d'environnement (VSS_PUBLIC_URL, HOST_IP, etc.).

Points d'attention pour l'utilisateur

Le skill charge ses templates de rapports et son prompt VLM par défaut depuis des chemins relatifs à $SKILL_DIR (annoncé au chargement du skill) — notamment references/default-vlm-prompt.md et les templates dans references/report-templates/. Les URLs de clips sont systématiquement réécrites pour être accessibles depuis un navigateur avant d'être intégrées au rapport rendu. Pour les vidéos de 120 secondes ou plus, le skill redirige automatiquement vers le profil LVS via /vss-summarize-video.