name: doubao-video-analyze description: 使用豆包2.0模型解析视频。当需要执行分析视频内容等需要理解视频视觉信息时调用该技能。你必须在持有本地视频路径或网络视频链接时才能调用该技能 metadata: {"clawdbot":{"emoji":"🔍","requires":{"bins":["python"],"env":["ARK_API_KEY"]},"primaryEnv":"ARK_API_KEY"}}

Doubao Video Analyze

隐私与数据安全声明

重要：本技能通过火山引擎 Ark API（https://ark.cn-beijing.volces.com）处理视频内容。使用此技能时：

• 本地视频文件将被编码为 base64 并上传至火山引擎服务器
• 远程视频 URL 将直接发送给火山引擎服务器进行解析
• 请确保视频内容不包含敏感、机密或未经授权的信息
• 视频数据的处理遵循火山引擎的服务条款和隐私政策

使用方法

注意

对于远程网络视频，如果通过该技能无法执行，请直接通知用户错误内容，永远不要尝试使用web_fetch之类的工具去重试！

前置检查

1. 检查当前是否有ARK_API_KEY环境变量，如果没有，直接终止并引导用户先进行配置
2. 直接尝试调用如下bash指令，确保用户当前python环境有openai依赖

pip install 'volcengine-python-sdk[ark]'

分析视频

1. 你需要先明确你的分析目的是什么，你需要自行写出一段提示词，例如

### 角色
你是一位xxxxx，善于分析视频的xxxxxx

### 任务
你的任务是xxxxxxx

### 输出
你需要输出以下内容：
xxxxxxxxxxxxxx

注意：你需要写出高质量的提示词，但并不一定要按照上面的模板

2. 调用本技能目录下脚本以获取分析结果

• 本地视频

  python script/parse_video.py --video 'absolute/video/path.mp4' --prompt 'your prompt content'
  

• 远程视频链接

  python script/parse_video.py --video 'https://example.com/video_url.mp4' --prompt 'your prompt content' --remote
  

等待该命令执行结束并获取结果作为该视频的分析结果

网络视频错误处理

如果遇到网络视频超过大小限制的问题，首先现将该网络视频下载至你的workspace的video目录下，然后再通过本地视频的方式调用