vss-search-archive

Search recorded video archives for events, objects, actions, and people using natural-language queries.

49|14|Updated Aug 27, 2025
One-click install
npx skills add https://github.com/NVIDIA/sop-monitoring-blueprints --skill vss-search-archive-nvidia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vss-search-archive
Source: https://github.com/NVIDIA/sop-monitoring-blueprints/tree/main/agentic/vss-sop-skills/vss-sop-build/references/vss/vss-search-archive
Command: npx skills add https://github.com/NVIDIA/sop-monitoring-blueprints --skill vss-search-archive-nvidia

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users locate events, objects, actions, and people in recorded video archives without manually reviewing hours of footage.

Core Features & Use Cases

  • Natural-Language Search: Find visual content using queries such as forklifts, people in red jackets, or activity near an entrance.
  • Semantic Video Retrieval: Search archived footage with Cosmos Embed1 embeddings indexed in Elasticsearch.
  • Use Case: Ask for all instances of people running in a parking lot or vehicles recorded between specific times, then retrieve matching archive results through the VSS Agent.

Quick Start

Ask the VSS Agent to find the requested objects, people, or actions in the recorded video archive using a natural-language query.

Frequently Asked Questions about vss-search-archive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search recorded video archives for specific events or objects?

You can search recorded video archives using natural-language queries to find events, objects, actions, and people without manually reviewing footage. The Skill matches your text queries against visual content to retrieve relevant historical footage.

Can I use natural language to find people in red jackets or forklifts in video footage?

Yes, natural-language search allows you to locate visual content like people in red jackets or forklifts in video footage. You simply describe the objects, actions, or people you are looking for to retrieve matching archive results.

Do I need Elasticsearch and Cosmos Embed1 vectors to search video archives?

Yes, searching video archives requires Cosmos Embed1 vectors indexed in Elasticsearch. You also need active embedding ingestion through rtvi-embed and a reachable VSS Agent endpoint to process and retrieve the semantic visual content.

What's the best way to retrieve historical footage recorded between specific times?

To retrieve historical footage recorded between specific times, use a natural-language query with the VSS Agent. Semantic video retrieval searches time- or location-oriented events across ingested video streams indexed with Cosmos Embed1 embeddings.

Why does video archive search require a VSS search profile and active embedding ingestion?

Video archive search requires a VSS search profile and active embedding ingestion through rtvi-embed to generate and store Cosmos Embed1 vectors in Elasticsearch. This setup enables the semantic matching of natural-language queries to visual content.

Are there limitations when searching for visual entities in ingested video streams?

Searching for visual entities in ingested video streams is limited to footage that has already been processed and indexed. You must have active embedding ingestion and an operational VSS Agent endpoint to retrieve historical footage successfully.