技能注册表
智能体基础设施公共技能

Cloud Storage

AI 代理的通用云存储 — 在 AWS S3、Google Cloud Storage、Cloudflare R2 和 MinIO 之间上传、下载、共享、搜索和管理文件。

此技能教授的内容

针对特定工作类型的可复用操作手册。

MCP 服务器告诉代理可用的操作。技能为这些操作添加判断:如何识别任务,遵循哪个顺序,避免什么,以及如何判断结果已完成。

协调云存储操作 — 列出存储桶,上传/下载文件,生成预签名 URL,复制/移动对象,跨存储搜索,监控使用情况。适用于上传文件、下载对象、通过预签名 URL 共享文件、组织存储、搜索文件或检查存储使用情况时使用。

架构

Cloud Storage 如何指导 ADK-Rust 代理。

技能保持可读和可移植,因为它包含说明而非服务凭证或业务数据。ADK-Rust 将其提供给代理,代理从审核过的工具边界中选择,连接的 MCP 服务器执行经过身份验证的操作。

01

用户请求

代理接收以普通语言表达的目标。

02

Cloud Storage 技能

匹配意图,提供决策指南,并缩小工具边界。

03

ADK-Rust 代理

规划工作流,并通过运行时流式传输每个关键步骤。

04

mcp-storage

对拥有该能力的系统执行经过身份验证的操作。

05

已验证结果

技能的完成规则决定返回给用户的证据。

可移植的说明: SKILL.md · 能力边界: mcp-storage · 允许的工具: 12

决策指南

代理如何将请求转化为正确操作。

这些路由直接来自技能说明。它们帮助模型识别意图并选择专注的工具或工作流,而不是在整个能力范围内即兴发挥。

01

"upload", "store", "put file"?

upload_object

02

"download", "get file", "fetch"?

download_object

03

"share", "link", "URL"?

generate_presigned_url (限时有效!)

04

"find", "search", "where is"?

search_objects / list_objects

05

"copy", "duplicate"?

copy_object

06

"move", "rename"?

move_object

07

"delete", "remove"?

delete_object (请先确认!)

08

"buckets", "list storage"?

list_buckets

经过验证的工作流

可重复的序列以实现有用结果。

工作流将多个工具调用组合成用户实际识别的任务。技能解释顺序和预期结果,而 ADK-Rust 通过共享运行时实时传输代理的进度。

011 次调用

上传

按内容类型存储文件

021 次调用

共享

限时预签名 URL

031-2 次调用

搜索

按前缀/模式查找文件

041-2 次调用

组织

复制、移动、重命名

051 次调用

监控

按存储桶监控使用情况

06Setup 次调用

提供商

设置

工具边界

技能可能使用 12 个已记录工具。

此允许列表由技能声明。它使代理专注于完成此任务所需的操作,而 mcp-storage 保留身份验证、验证和连接系统的责任。

list_buckets
list_objects
get_object_info
download_object
generate_presigned_url
upload_object
copy_object
move_object
delete_object
create_bucket
search_objects
get_storage_usage

工作规则

代理应做什么。

  • 共享时使用预签名 URL(绝不公开对象)
  • 上传时设置合适的 content_type
  • 删除前确认(不可逆)
  • 定期检查存储使用情况

操作边界

代理应避免什么。

  • 未经明确用户确认绝不删除
  • 绝不将存储桶设为公开访问
  • 上传时必须指定 content_type
  • 生成预签名 URL 超过 24 小时有效期需有合理理由

安装并连接

将技能添加到其预期能力旁边。

安装仓库,使您的 ADK-Rust 技能加载器能发现它,连接 mcp-storage,并确认声明的工具可用后,再让代理使用工作流。

安装技能
git clone https://github.com/zavora-ai/skill-cloud-storage.git \
  ~/.skills/skills/cloud-storage
ADK-Rust 加载形态
let skills = SkillLoader::from_dir("~/.skills/skills").await?;
let skill = skills.load("cloud-storage").await?;

let agent = LlmAgentBuilder::new("agent")
    .instruction(skill.instructions())
    .tools(skill.allowed_tools(toolset)?)
    .build()?;

仓库的兼容性声明:需要连接 mcp-storage 服务器(支持 AWS S3、Google Cloud Storage、Cloudflare R2、MinIO 或任何兼容 S3 的提供商)。

源记录

此技能条目的仓库元数据。

查看公共仓库 ↗
许可证
Apache-2.0
允许的工具
12
参考文献
3
修订
e4263b2e9b8a
已更新
2026年5月31日