Rôle du skill
Ce skill donne à Claude les instructions nécessaires pour piloter le service VIOS (Video Input/Output and Storage) du blueprint NVIDIA AI Blueprint for Video Search and Summarization (VSS). Il couvre l'ensemble des opérations de gestion vidéo : ajout et suppression de capteurs/caméras, gestion de streams RTSP, upload de fichiers vidéo, récupération de snapshots, extraction de clips, consultation des timelines d'enregistrement et vérification du statut du service.
Contrairement aux autres skills VSS orientés analyse (inférence VLM, recherche sémantique, résumé narratif, rapports d'incidents), ce skill se concentre exclusivement sur la couche d'entrée/sortie et de stockage vidéo — il agit comme client REST du backend VST, en exécutant lui-même les commandes curl sans demander à l'utilisateur de les lancer.
Périmètre et limites
Le skill distingue deux surfaces d'API complémentaires : l'API VIOS principale (port 30888) pour la gestion des capteurs, du stockage et des replays, et l'API NvStreamer (port 31000) pour publier des fichiers vidéo locaux comme flux RTSP synthétiques. Une règle de routage claire sépare les deux : un upload MP4 destiné à VIOS utilise directement PUT /vst/api/v1/storage/file/{filename}, tandis que NvStreamer n'intervient que lorsqu'un flux RTSP vivant est explicitement demandé.
Ce skill ne prend pas en charge les opérations suivantes, déléguées à d'autres skills du même repository : l'inférence VLM ou le Q&A visuel (vss-ask-video), la recherche sémantique dans les archives (vss-search-archive), les résumés narratifs (vss-summarize-video), les rapports d'incidents (vss-generate-video-report), et la lecture des métriques d'alertes (vss-query-analytics).
Prérequis de déploiement
Avant toute opération, le skill vérifie que le backend VST est accessible via une probe HTTP. Si VIOS n'est pas démarré, il propose deux chemins : déploiement standalone guidé par le runbook references/deploy-vios-service.md intégré au skill, ou délégation au skill vss-deploy-profile pour un stack VSS complet. Le skill s'arrête explicitement si l'utilisateur refuse les deux options — il ne simule pas de réponses en mode dégradé.
Références embarquées
Le skill embarque quatre fichiers de référence dans son dossier references/ : le contrat d'API VIOS complet (api-reference.md), la référence NvStreamer (nvstreamer-api-reference.md), le contrat d'intégration inter-services (integrate-vios-service.md), et le runbook de déploiement VIOS (deploy-vios-service.md). Ces documents constituent la source de vérité opérationnelle que Claude consulte lors de chaque invocation, en particulier pour les cas limites connus (bug double http:// sur les endpoints /url, échec libav si VST_INSTALL_ADDITIONAL_PACKAGES est absent, dérive de volumes Docker).