SuperAPI AI 工具集

alibabacloud-oss-manage-metaquery

通用与其它

查看项目

更新于 10-15 19:54

技能介绍

用途:在阿里云 OSS Bucket 中开启 MetaQuery(AI 内容感知 + 向量检索),借助多模态 AI 模型为图片、视频、音频和文档提取语义描述(约100字符)与简明摘要(≤20字符),建立可搜索的向量索引,支持文本搜图、文本搜视频等相似度检索。

主要能力:创建/查询 Bucket、上传下载文件、查询 Bucket 统计;用 Python 脚本开启 MetaQuery 并配置 ImageInsightEnable 与 VideoInsightEnable;执行语义向量检索或标量检索(如按大小、修改时间过滤);用 x-oss-process 生成图片预览或视频封面便于查看结果。

必要用法:需阿里云 CLI ≥ 3.3.3(用 aliyun version 校验),并执行 aliyun configure set --auto-plugin-install true 与 aliyun plugin update;Python 依赖 pip install oss2==2.19.1 alibabacloud-credentials==1.0.8。执行前须启用 AI-Mode:aliyun configure ai-mode enable 与 aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-oss-manage-metaquery",退出时任一路径都要 aliyun configure ai-mode disable;每条 CLI 命令须带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-oss-manage-metaquery。开启 MetaQuery 必须用 python scripts/open_metaquery.py --region <your-region> --bucket <your-bucket-name> --endpoint <your-endpoint>,禁止用 aliyun ossutil api open-meta-query,否则无法配置 WorkflowParameters,语义检索质量会严重下降。搜索示例:aliyun ossutil api do-meta-query --bucket <bucket-name> --meta-query file://meta-query.xml --meta-query-mode semantic。

适用与限制:支持图片、视频、音频、文档;仅支持 cn-hangzhou、cn-shanghai、cn-qingdao、cn-beijing、cn-zhangjiakou、cn-shenzhen、cn-guangzhou、cn-chengdu、cn-hongkong、ap-southeast-1、us-east-1 等区域,其他区域会报错 0037-00000001。分片上传需完成 CompleteMultipartUpload 后才可见。对象超 1000 个会有费用提示需确认;删除 Bucket/对象、关闭 MetaQuery、创建 Bucket、开启 MetaQuery 等危险操作须先获用户明确同意,Bucket 重名必须询问用户而非自动改名。禁止读取、回显或索要 AK/SK。RAM 权限见 references/ram-policies.md。