云函数
如果你想用最快的方式消费一个已经发布的 OOMOL 函数，应该先看
oo-cli 指南。如果你需要查看当前 CLI 的具体命令
体系，请直接看
命令参考。如果你要通过代码
直接调用云函数，请看 API 与 SDK 下面的文档。当前执行接口和 SDK 包名仍然
沿用 Cloud Task v3 这个名字，它本质上就是云函数当前对外暴露的接入层。
OOMOL 云函数是一个无服务器计算平台，让你可以将 OOMOL 工作流部署为生产级 API，无需管理基础设施。你只需专注于编写代码，剩下的交给 OOMOL。
概述
OOMOL 云函数可以将你的工作流区块一键转换为可扩展的云服务。你负责实现函数逻辑，OOMOL 负责部署、扩缩容和运维。
核心优势
- 快速部署：无需复杂配置，即可完成部署
- 按量计费：只为实际使用付费，无需预付服务器费用
- 零维护：无需管理服务器、环境或扩展
- 自动扩缩容：自动处理流量高峰和扩展
四种交付与消费方式
同一份能力在打包和部署完成后，可以通过几种不同方式对外分发和被消费。
其中，包发布是分发层；CLI、API 和 MCP 是主要消费层。
1. 发布为包
将你的区块分享给社区，或在更复杂的工作流中复用它们。
使用场景：
- 与其他开发者分享可复用组件
- 构建其他人可以扩展的模块化功能
- 为社区创新创造基础构建块
工作原理：
- 打包你的区块，定义清晰的输入和输出
- 发布到 OOMOL 社区包库
- 其他人可以发现并在他们的工作流中使用你的区块
2. 通过 CLI 消费
通过 oo 你可以在终端里完成认证、
搜索 package 或 connector action、查看 package 元数据、运行 cloud task、
传输文件，以及为 AI 编程宿主安装内置 skill。
使用场景：
- 在 Codex 或 Claude Code 中使用 OOMOL 函数
- 让个人用户不做应用集成也能直接运行云函数
- 在 package 路径和 connector 路径之间先做搜索和筛选
- 在投入 API 集成之前，先快速验证包和工作流能力
为什么重要：
- 通常比直接接 API 更简单
- 通常比搭 MCP Server 的接入成本更低
- 同时适合 AI 辅助开发和直接终端使用
推荐工作流见 oo-cli 指南。当前命令体系如
oo search、oo packages info、oo cloud-task run 等请查看
命令参考。
3. 通过 API 与 SDK 集成
把已经部署好的能力接入你自己的应用、后端、脚本或自动化代码。
使用场景：
- 在自己的前后端产品里集成 OOMOL 能力
- 从脚本、服务或定时任务触发任务执行
- 自己控制轮询、上传文件和结果处理流程
功能特性：
- TypeScript 和 Python SDK
- 适合调试和极简环境的 HTTP 直连方式
- 对任务创建、轮询和上传有完整控制
当前 API 形态和 SDK 命名请参考 云函数 API 概览。
4. 作为 MCP 能力提供给 AI 调用
通过模型上下文协议（MCP）发布你的函数，供 AI 代理使用。
使用场景：
- 让 AI 助手直接调用你的函数
- 创建 AI 代理可以发现和使用的工具
- 让你的代码接入 AI 驱动的工具链和工作流
工作原理：
- 你的函数通过 MCP 协议暴露
- AI 代理可以发现并调用你的函数
- 与支持 MCP 的 AI 助手无缝集成
定价
OOMOL 云函数使用简单的按使用付费定价模式：
- 无固定费用：没有月度服务器费用或预付款项
- 基于使用量的计费：先使用每月包含的额度，超出后再按托管运行时长付费
- 透明定价：Cloud Task 按运行时长计费，不满一分钟按 1 分钟计费
- 免费额度：先用每月包含的 Cloud Task 额度起步，不够时再充值或升级
访问 OOMOL 控制台 了解详细定价信息。
快速开始
前置条件
- 一个 OOMOL 账户
- 在计算机上安装 OOMOL Studio
- 准备好要部署的工作流
部署步骤
-
创建工作流
- 在 OOMOL Studio 中构建工作流
- 在本地测试确保正常工作
- 定义清晰的输入和输出参数
-
配置部署
- 在 OOMOL Studio 中打开部署面板
- 选择"云函数"作为部署目标
- 配置函数设置（超时、内存等）
-
部署
- 点击“部署到云端”
- 等待部署完成
- 获取函数的调用信息
-
测试函数
- 使用提供的调用入口或 SDK 测试函数
- 在 OOMOL 控制台监控使用情况和性能
- 与用户分享 API
部署示例
部署完成后，大多数用户应该先从 oo-cli 指南
开始。云函数当前通过 Cloud Task v3 这一接入层提供直连能力。CLI 当前的命令
面请参考
命令参考。若要查看可直接
运行的请求示例，请参考
HTTP + curl。
管理
OOMOL 控制台
访问 OOMOL 控制台 可以：
- 查看所有已部署的函数
- 监控使用情况和性能指标
- 管理 API 密钥和访问控制
- 查看账单和使用统计
- 更新函数配置
- 查看日志和调试信息
监控
- 实时指标：追踪调用次数、延迟和错误
- 使用分析：了解函数的使用方式
- 错误追踪：快速识别和修复问题
- 性能洞察：优化函数执行时间
最佳实践
函数设计
- 保持函数专注：每个函数应该只做好一件事
- 定义清晰的接口：记录输入和输出参数
- 优雅处理错误：返回有意义的错误消息
- 优化冷启动：最小化初始化时间
安全
- 使用 API 密钥：通过身份验证保护函数
- 验证输入：始终验证和清理用户输入
- 设置速率限制：通过适当的速率限制防止滥用
- 监控使用：关注异常模式或潜在攻击
性能
- 优化依赖：只包含必要的库
- 适时缓存：减少冗余计算
- 使用适当的超时：设置现实的执行时间限制
- 大规模测试：在预期负载下验证性能
与传统部署的对比
| 功能 | 传统服务器 | OOMOL 云函数 |
|---|---|---|
| 启动时间 | 数小时到数天 | 几分钟 |
| 服务器管理 | 需要 | 无需 |
| 扩展 | 手动 | 自动 |
| 成本 | 固定月费 | 按使用付费 |
| 维护 | 持续需要 | OOMOL 负责 |
| SSL/HTTPS | 手动设置 | 内置 |
| 部署 | 复杂 | 一键完成 |
使用案例
API 服务
为移动应用、Web 应用或第三方集成构建 RESTful API。
数据处理
按需处理文件、转换数据或执行批处理操作。
集成
连接不同服务并自动化它们之间的工作流。
AI 工具
创建 AI 助手可以调用的专用工具以扩展其能力。
Webhooks
响应来自 GitHub、Stripe 或 Slack 等外部服务的事件。
技术支持
如果遇到任何问题：