背景
用户在初次接触一个云产品(如函数计算 FC)时,通常希望以较低的成本快速了解和体验其核心功能。
传统方式下,用户需要阅读相关文档,学习产品用途和 API,并在控制台进行多次尝试。如果缺乏相关产品知识,此过程可能会中断。
解决方案:CloudControl API MCP Server
CloudControl API 集成了 300 多种云资源的产品说明。用户向 AI Agent 提供需求描述后,Agent 会结合自身背景知识及从 CloudControl MCP Server 获取的资源属性信息,帮助用户创建核心资源,并引导用户体验产品。
查看 了解 CloudControl MCP Server,在开发环境中接入 CloudControl API MCP Server。
场景示例:以函数计算(FC)为例
以 Cursor 开发环境为例,介绍如何通过与 AI Agent 的 3 轮对话完成产品体验,此过程无需查阅文档。
第一步:提出初步需求
用户仅提供产品名称,直接向 Agent 提问:
示例 Prompt:FC是什么云产品,帮我用CloudControl API创建一个FCV3资源。
$ cd /tmp && mkdir -p fc_code && echo 'def handler(environ, context):
return "Hello from CloudControl FCV3"' > fc_code/index.py && cd fc_code && zip -q -r ../fc_code.zip index.py && base64 ../fc_code.zip | tr -d '\n' | head -c 500
-h, --help display this message
-i, --input input file (default: "-" for stdin)
-o, --output output file (default: "-" for stdout)
$ cd /tmp && mkdir -p fc_code && echo 'def handler(environ, context):
return "Hello from CloudControl FCV3"' > fc_code/index.py && cd fc_code && zip -q -r ../fc_code.zip index.py && base64 -i ../fc_code.zip -o ../fc_b64.txt && wc -c ../fc_b64.txt
321 ../fc_b64.txt
FC是什么云产品,帮我用CloudControl API创建一个FCV3资源
FC / FCV3 是阿里云的 函数计算(Function Compute),产品码为 FCV3,即按请求运行的 Serverless 计算服务。
已通过 CloudControl 创建并校验了一个 FCV3 函数(Function):
项目 值
资源类型 FCV3 - Function(函数)
资源 ID cloudcontrol-test-func
地域 ap-southeast-1
运行时 python3.10
入口 index.handler
描述 Created via CloudControl API
创建请求示例:
- Path: POST /api/v1/providers/Aliyun/products/FCV3/resources/Function
- Body: FunctionName、Runtime、Handler、Description、Code.ZipFile(Python 代码包的 Base64)
创建响应(201):
- resourceId: cloudcontrol-test-func
- resourcePath: Function/cloudcontrol-test-func
- Request ID: 0BB47359-1674-155B-xxx
Get 校验结果:
- 函数 ARN: acs:fc:ap-southeast-1:xxx
- FunctionId: 29fd2fba-935f-49d7-xxx
- 内存 512MB,超时 3 秒,创建时间 2026-02-09T11:31:36Z
FCV3 还有 LayerVersion、Function/Alias、Function/Trigger 等子资源。
Agent 通过 CloudControl API MCP Server 获取产品描述,组装参数并调用 CloudControl API,为用户创建了函数计算的 Function 实例。用户无需查阅函数计算的文档即可完成资源创建。
第二步:了解资源用途
用户可继续提问以了解已创建函数的作用。向 Agent 提问:
示例 Prompt:你刚刚创建的Function,有什么作用?能看到什么效果?
def handler(environ, context):
return "Hello from CloudControl FCV3"
Agent 解释了函数的作用,并提供了两种体验方式:通过控制台测试,或通过创建 HTTP 触发器在浏览器中访问。Agent 提供了关键信息“HTTP 触发器”。
第三步:创建关联资源
用户可直接要求 Agent 创建所需资源,而无需在控制台操作或编写代码。向 Agent 提问:
示例 Prompt:可以用CloudControl API创建一个Http触发器吗?
Agent 返回创建结果:触发器名称 httpTrigger,类型 http,认证方式 anonymous(无需认证),请求方法 GET。使用的 CloudControl API 子资源路径为 /api/v1/providers/Aliyun/products/FCV3/resources/Function/{functionName}/Trigger,Body 参数包含 TriggerType、TriggerName、TriggerConfig 等字段。创建操作返回 taskId,需通过 GetTask 接口轮询获取最终结果。
Agent 从 CloudControl API 的资源列表中找到 FC Function 的 Trigger 资源,自动组装参数并完成调用,成功创建 HTTP 触发器,并返回了可在浏览器中直接访问的 URL。
用户访问该 URL 即可看到返回结果,完成产品体验。
回顾
通过与 Agent 的 3 轮对话,用户在不查阅文档、不了解 API 和参数的情况下,完成了从了解产品到体验功能的闭环。
|
轮次 |
用户提问 |
Agent 行动 |
|
1 |
FC是什么?帮我创建一个资源 |
查询产品信息,自动创建 Function 实例 |
|
2 |
创建出来有什么用?能看到效果吗? |
解释函数用途,引导体验方式 |
|
3 |
帮我创建一个 HTTP 触发器 |
自动创建 Trigger,提供可访问的 URL |
此体验过程得益于 CloudControl API 广泛的产品与资源覆盖度,Agent 通过 CloudControl API 完成了 Function 和 Trigger 的创建,并以 URL 的形式将体验交付给用户。
功能优势
-
产品覆盖广:覆盖 80 多种云产品、300 多种资源类型,可通过同一套 API 体验多种云产品,且覆盖范围仍在持续扩大。
-
适配 AI 场景:仅提供 9 个标准 ROA 风格 API,通过
ListProducts、ListResourceTypes获取云产品的资源元信息,结构统一,适合作为 MCP Server 提供给 AI Agent 使用。 -
降低使用门槛:用户通过自然语言描述需求,AI Agent 即可自动完成资源发现到资源创建的全流程,无需阅读文档或了解 API 参数。