Alibabacloud Oss Manage Metaquery — 阿里云 OSS 管理 Metaquery
v0.0.2Alicloud OSS AI Content Awareness Skill。用于启用和查询OSS语义搜索的AI驱动内容理解。触发器： "OSS AI Content Awareness", "OSS semantic search", "OSS vector search", "search by text", "text-to-image search", "text-to-video search", "OSS MetaQuery", "OSS data index", "OSS AI内容感知", "OSS语义检索", "OSS向量检索", "以文搜图", "以文搜视频", "OSS数据索引"
by 运行时依赖
安装命令
点击复制技能文档
OSS 向量搜索和 AI 内容感知 利用多模态 AI 模型从 OSS Bucket 中存储的图像、视频、音频和文档中提取语义描述和简洁摘要。构建可搜索的向量索引，以启用高级检索功能，例如文本到图像和文本到视频搜索。
前提条件 Aliyun CLI (>= 3.3.3) 预检查：Aliyun CLI >= 3.3.3 必须 本技能使用 Aliyun CLI 进行所有 OSS 操作，除了打开 MetaQuery。如果已经安装了 Aliyun CLI，则不需要单独安装 ossutil。运行以下命令以验证版本：aliyun version 如果未安装或版本低于 3.3.3，请运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 安装/更新，或者参考 references/cli-installation-guide.md 获取安装说明。然后 [必须] 运行 aliyun configure set --auto-plugin-install true 以启用自动插件安装。[必须] 运行 aliyun plugin update 以确保本地机器上的任何现有插件始终保持最新。更新 aliyun ossutil 插件
故障排除： --user-agent 未知标志错误 如果在运行命令时遇到 Error: unknown flag: --user-agent，则 ossutil 插件版本过旧。运行以下命令更新到最新版本：aliyun ossutil update 更新后，重新运行原始命令。
# Python SDK 依赖 pip install oss2==2.19.1 alibabacloud-credentials==1.0.8
注意： 所需：Aliyun CLI，Python 依赖 oss2 和 alibabacloud-credentials 不需要：ossutil 唯一需要 Python 的操作：打开 MetaQuery (AI 内容感知 + 语义搜索)
安全规则： 绝不读取、回显或打印 AK/SK 值（例如，echo $ALIBABA_CLOUD_ACCESS_KEY_ID 是禁止的） 绝不要求用户在对话或命令行中直接输入 AK/SK
在核心工作流开始之前（在任何 CLI 调用之前）： [必须] 启用 AI 模式 — AI 模式是代理技能执行所必需的。运行以下命令，然后再调用任何 CLI： aliyun configure ai-mode enable aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-oss-manage-metaquery" [必须] 禁用 AI 模式在每个退出点 — 在任何原因下交付最终响应之前，始终先禁用 AI 模式。这适用于所有退出路径：工作流成功、工作流失败、错误/异常、用户取消、会话结束或没有进一步 CLI 命令将被执行的任何其他场景。AI 模式仅用于代理技能调用场景，绝不能在技能停止运行后仍保持启用状态。 aliyun configure ai-mode disable [必须] CLI User-Agent — 每个 aliyun CLI 命令调用必须包含： --user-agent AlibabaCloud-Agent-Skills/alibabacloud-oss-manage-metaquery
架构 用户请求 -> OSS Bucket -> AI 内容感知引擎 -> 语义特征提取 -> 向量索引 -> 语义搜索 | 图像/视频/音频/文档 -> 详细描述 (~100 个字符) + 简洁摘要 (<=20 个字符)
核心组件： OSS Bucket + 数据索引 + 向量搜索 + AI 内容感知
使用限制 支持区域 区域类别 区域列表 华东 cn-hangzhou, cn-shanghai 华北 cn-qingdao, cn-beijing, cn-zhangjiakou 华南 cn-shenzhen, cn-guangzhou 西南 cn-chengdu 其他 cn-hongkong, ap-southeast-1 (新加坡), us-east-1 (弗吉尼亚) 注意：如果用户的 Bucket 位于上述列表中未列出的区域，则无法启用向量模式 MetaQuery 和内容感知，并将返回 EC 代码 0037-00000001 错误。引导用户在支持的区域创建一个新 Bucket。
文件类型支持： 图像、视频、音频、文档 分段上传：仅显示通过 CompleteMultipartUpload 组装的对象
性能参考 OSS 内部带宽和 QPS 区域 内部带宽 默认 QPS cn-beijing, cn-hangzhou, cn-shanghai, cn-shenzhen 10Gbps 1250 其他区域 1Gbps 1250 此带宽和 QPS 仅供向量搜索使用，不占用 Bucket 的 QoS 配额。
现有文件索引构建时间 文件类型 1000 万文件 1 亿文件 10 亿文件 结构化数据和图像 2-3 小时 1 天 ~10 天 视频、文档、音频 2-3 天 7-9 天
增量更新和搜索延迟 增量更新：当 QPS < 1250 时，延迟通常为分钟到小时 搜索响应：亚秒，默认超时 30 秒
危险操作确认 在执行以下任何危险操作之前，您必须先与用户确认并获得明确的同意，然后再继续： 删除 Bucket：aliyun ossutil rm oss:// -b --user-agent AlibabaCloud-Agent-Skills/alibabacloud-oss-manage-metaquery 删除对象：aliyun ossutil rm oss:/// --user-agent AlibabaCloud-Agent-Skills/alibabacloud-oss-manage-metaquery 批量删除：...