vss-deploy-video-embedding
Ce skill fait partie du catalogue officiel de skills AI publiés par NVIDIA dans le repository nvidia/skills. Il fournit à un agent AI toutes les instructions nécessaires pour déployer, configurer, opérer et intégrer le microservice VSS Video Embedding (connu sous le nom legacy RT-Embed) de la suite Video Search and Summarization (VSS) 3.2 GA.
Ce que couvre ce skill
Le skill documente l'ensemble du cycle de vie du service rtvi-embed : prérequis matériels et logiciels (driver NVIDIA, NVIDIA Container Toolkit, accès NGC), mise en route via Docker Compose sous le profil bp_developer_search_2d, vérification de la disponibilité via l'endpoint /v1/ready, et arrêt propre avec ou sans suppression des volumes de cache. Il couvre également les opérations courantes : génération d'embeddings vidéo à partir d'un fichier uploadé, génération d'embeddings textuels pour la recherche vidéo, et embedding de flux RTSP en direct via Server-Sent Events (SSE).
L'intégration avec les services complémentaires est aussi traitée : Redis pour les messages d'erreur, Kafka pour la publication des embeddings produits, et OpenTelemetry pour l'observabilité. Une section troubleshooting recense les échecs fréquents (démarrage bloqué à 503, erreurs de permissions sur les volumes, rate-limiting Hugging Face lors du premier téléchargement du modèle Cosmos-Embed1-448p).
Comment utiliser ce skill
Une fois installé via le CLI npx skills add nvidia/skills --skill vss-deploy-video-embedding, l'agent l'active automatiquement lorsqu'il détecte des phrases-clés comme RT-Embed, Cosmos-Embed1, embed live stream ou generate video embeddings. Le skill renvoie alors des commandes concrètes, des exemples curl complets et des explications sur les variables d'environnement à positionner (RTVI_EMBED_PORT, VSS_DATA_DIR, NGC_API_KEY, etc.).
Des fichiers de référence complémentaires (references/deploy-vss-deploy-video-embedding.md, references/rest-api.md, references/environment.md, references/troubleshooting.md) sont indiqués dans le skill pour les cas d'usage avancés ou la liste exhaustive des variables d'environnement.