菜单
Upload, list, or delete TwelveLabs assets — generic reference files (images or videos) used by entities and async-analyze. Triggers on "upload this image", "upload this video as an asset", "delete that asset", or any explicit asset-management request.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Asynchronously analyze a video — by URL, local file path (auto-uploaded), asset ID, or base64 — no prior indexing required. Use for URL inputs, videos over 1 hour, time-based metadata extraction, multimodal prompting with reference images, structured JSON output, or when the user asks to check/list/delete async analysis tasks.
Set up and search for specific people or objects in videos using entity search. Use when the user wants to find a specific person, track someone across videos, or set up face/object recognition. Triggers on phrases like "find this person", "set up entity search", "track this person in my videos", "who is in this video".
Synchronously analyze a video to understand its content. Accepts an indexed videoId, a direct video URL, a previously uploaded asset, or a local file path (auto-uploaded). Use when the user asks "what is this video about?", "summarize the video", "analyze this video", or has questions about video content.
Create, check, and retrieve video embeddings. Use when user wants to generate embeddings from a video, check embedding status, or retrieve embeddings for a video.
Search videos using an image combined with text for refined results. Use when the user wants to search with a reference image, says "find videos matching this image", "search with this picture", or wants to combine visual reference with text description.
Index video files or URLs for AI search and analysis. Use when user wants to add a video for processing, says "index this video", "add this video for analysis", or mentions a video file they want to work with.
| name | assets |
| description | Upload, list, or delete TwelveLabs assets — generic reference files (images or videos) used by entities and async-analyze. Triggers on "upload this image", "upload this video as an asset", "delete that asset", or any explicit asset-management request. |
Assets are uploaded media files (images or videos) referenced by ID in downstream tools. Image assets are used as reference images for entity search; video assets are used as input to async-analyze without prior indexing.
Use this skill when the user:
/twelvelabs:entities or /twelvelabs:async-analyzeDo not use this skill when the user just says "analyze this video" — /twelvelabs:async-analyze handles asset upload internally for local files. Asset management is for explicit reuse.
Determine from the user's message whether they want to:
Detect input type:
http:// or https://For URLs:
Tool: mcp__twelvelabs-mcp__create-asset
Parameters:
url: "<url>"
For local files:
Tool: mcp__twelvelabs-mcp__create-asset
Parameters:
file: "<absolute-path>"
Report the returned Asset ID and File Type. Suggest the next step:
/twelvelabs:entities create-entity/twelvelabs:async-analyzeConfirm with the user before deleting (the action is irreversible).
Tool: mcp__twelvelabs-mcp__delete-asset
Parameters:
assetId: "<asset-id>"
If the API returns a conflict (asset is referenced by an indexed video), offer to retry with force=true.