vss-manage-alerts

Par nvidia-ai-blueprints · video-search-and-summarization

Skill opérationnel du Blueprint VSS NVIDIA pour piloter l'ensemble du pipeline d'alertes vidéo en temps réel via l'Alert Bridge REST API.

npx skills add https://github.com/nvidia-ai-blueprints/video-search-and-summarization --skill vss-manage-alerts

Rôle du skill

Ce skill fait partie du repository officiel nvidia-ai-blueprints/video-search-and-summarization, le Blueprint NVIDIA pour l'analyse vidéo par IA. Il constitue le guide opérationnel complet pour piloter le pipeline d'alertes du profil VSS (alerts), en couvrant deux modes de déploiement distincts : le mode CV (verification) à base de Grounding DINO + VLM verifier, et le mode VLM real-time à base de rtvi-vlm.

Ce que couvre ce skill

Le SKILL.md définit sept workflows numérotés (A à G) que l'agent doit exécuter selon le mode déployé et l'intention de l'utilisateur :

  • Workflow A — Onboarding de caméras dans le pipeline CV statique
  • Workflow B — Lecture des résultats de vérification et des verdicts (confirmed, rejected, etc.) dans l'index Elasticsearch mdx-vlm-alerts-*
  • Workflow C — Requêtage des incidents en temps réel via GET /api/v1/realtime/incidents (Alert Bridge direct, sans passer par /generate)
  • Workflow D — CRUD des règles d'alerte realtime (création, liste, suppression avec confirmation obligatoire), mode VLM uniquement
  • Workflow E — Configuration et test des notifications Slack via le serveur alert-notify (port 9090), mode VLM uniquement
  • Workflow F — Vérification à la demande d'un artefact média spécifique (POST /api/v1/verification/ondemand), mode CV uniquement
  • Workflow G — Opération du mode always-on (statut, requête d'incidents, dépannage), mode VLM uniquement

Structure et utilisation

Le skill s'appuie sur des fichiers de référence situés dans le sous-dossier references/ (notamment alert-subscriptions.md, verification.md, alert-notify.md, on-demand-verification.md, always-on.md) et sur des scripts dans scripts/. Il intègre une table de routage précise : l'agent détecte d'abord le mode déployé (via variables d'environnement ou conteneurs Docker actifs), puis route vers le workflow approprié selon l'intention exprimée. Des règles strictes encadrent les actions destructives (suppression de règle avec confirmation systématique, jamais de redéploiement automatique sans accord explicite).

Périmètre et limites

Ce skill couvre exclusivement les opérations d'alerte. Les analyses vidéo non liées aux alertes (résumés, rapports, recherche sémantique) sont explicitement hors périmètre et renvoyées vers les skills vss-generate-video-report ou vss-query-analytics. Il requiert que le profil alerts VSS soit déployé et accessible, et que les caméras soient préalablement enregistrées dans VIOS.

Skills similaires