Ingest video with VidXP
Workflow
- Resolve the
vidxpMCP tools and callget_workspace. Do not import a video that is already registered or indexed. - Choose indexable capabilities from the workspace. Use
speechandscenefor ordinary content retrieval. Addactionwhen the request depends on actions or events spanning multiple frames. Addactoronly when anonymous recurring-face clusters are wanted; it does not identify people by name. - Call
get_runtime_readiness. If selected models are missing, submitprepare_models, usewait_jobwith its observation token for subsequent bounded waits, then fetchget_jobonce when terminal. - Use
ingest_local_mediafor one to ten paths accessible to VidXP; otherwise usecreate_media_uploadand give the returned link to the user. Keepindex_after_importenabled unless registration-only behavior was requested. - Poll the returned ingestion or upload ID with
get_media_ingestionorget_media_upload. Honor its poll interval, reuse the same identifiers, and do not resubmit unchanged work. - Stop at a terminal state and report each file's state, media ID, index job,
and searchable snapshot or generation. If indexing fails after registration,
retry with
start_indexing; do not upload the file again. - If the request also asks about the video, continue directly into the VidXP evidence workflow once it is searchable.
Long operations
- Tell the user that model preparation and indexing can take several minutes.
- Update when the stage changes or about once per minute; do not narrate every status check or invent an ETA.
- Treat files independently so one failure does not hide successful siblings.