概览
Makers Agents 是开箱即用的 Agent 开发与部署平台。开发者在
agents/ 目录中编写 Agent 逻辑，平台提供会话级运行时、沙箱工具、会话管理、全链路追踪与内置模型，让你专注于业务，而不是搭建底层基础设施。平台优势
开箱即用：运行环境、沙箱、会话管理与可观测能力由平台托管，无需分别搭建基础服务。
为 Agent 设计：按会话路由，在实例存活期间复用上下文、缓存与连接；单次执行最长可配置到 60 分钟，支持多轮工具调用与长任务编排。
灵活开放：框架任选（Claude / OpenAI / LangGraph / CrewAI），语言不限（JS / Python），使用框架原生写法，不引入平台 SDK。
一体交付：Agent 与 Cloud Functions、Edge Functions 共存于同一项目，无需为业务 API 另建服务；账号、监控与域名统一管理。
核心能力
能力 | 说明 |
会话级运行时 | 承载 Agent 循环、工具调用与长任务编排，按 conversation_id 进行会话亲和路由 |
沙箱工具 | 面向 LLM 和开发者视角提供两层独立但互通的 API，浏览器、代码执行、Shell、文件操作都在隔离沙箱环境运行 |
会话管理 | 提供框架原生存储适配及通用 API，跨实例保存对话消息历史 |
可观测 | 调用链路自动采集，零侵入插桩，本地 / 云端面板统一查看链路数据 |
内置模型 | 自动注入模型 key，兼容 OpenAI 协议，限时每月享受免费模型配额 |
运行模式与职责划分
平台提供 Agent 函数、Cloud Functions 与 Edge Functions 三类执行单元。按运行模式分为会话级与请求级，由代码所在目录区分，同一项目可组合使用。
运行模式 | 执行单元 | 代码目录 | 生命周期 |
会话级（会话亲和） | Agent 函数 | agents/ | 单次执行最长 60 分钟，实例按会话保活（空闲 5 分钟回收，会话最长 6 小时，同 conversation_id 跨请求保留 |
请求级（无状态） | Edge Functions | edge-functions/ | 单次请求内完成，请求间不共享 |
请求级（无状态） | Cloud Functions | cloud-functions/ | 单次请求内完成，请求间不共享 |
会话级：请求按
conversation_id 粘性路由到同一实例。会话活跃期间，实例内的上下文、缓存、连接与沙箱映射可直接复用；单次执行最长 60 分钟，支撑多轮 Agent 循环、反复工具调用与长任务编排。伸缩以会话为单位，会话空闲超时后实例回收。请求级：每次请求独立分配执行环境，用完即回收，请求之间不保留任何内存状态，可按请求量任意水平伸缩。Edge Functions 与 Cloud Functions 属于同一运行模式，差异在算力位置与运行时。两者运行时细节见 Edge Functions 与 Cloud Functions。
如何选择
选择时应看任务是否需要会话内存复用、Agent 工具能力或较长的执行时间：
Agent 函数：需要 Agent 循环、多轮工具调用、长任务编排，或复用会话内存与沙箱。
Cloud Functions 或 Edge Functions：无需会话状态，鉴权、业务 API、数据读写、Webhook 等。
是否调用 LLM 不构成判据，Cloud Functions 同样可以调用 LLM 完成一次性的推理。
接入层：Edge Functions 与 Cloud Functions
Agent 应用通常还需要鉴权、会话列表和业务数据读写。可以在同一项目中用 Edge Functions 与 Cloud Functions 承接这些职责，让 Agent 函数专注于会话内的推理、工具调用与任务编排。
执行单元 | 建议职责 | 典型用法 |
Edge Functions | 轻量入口逻辑 | 身份校验、参数检查、按业务规则分流请求 |
Cloud Functions | 业务与数据接口 | 会话列表、消息历史、业务 API、Webhook、一次性 LLM 调用 |
例如，对话页面可通过接入层读取历史消息，通过 Agent 函数发起新一轮执行。Agent 中的
context.store 与 Cloud Functions 中的 context.agent.store 可访问同一份会话数据。会话级执行：Agent 函数
agents/ 为 Agent 工作流提供会话亲和、长时执行与内置上下文能力：会话亲和：实例存活期间，同一
conversation_id 的请求路由到同一实例，复用内存中的上下文、缓存与连接。长时执行：单次请求默认最长运行 5 分钟，可配置至 60 分钟，适合多轮工具调用、深度研究与长任务编排。
上下文注入：通过
context 获取请求、环境变量、会话管理与沙箱工具能力。context.store 同时提供存储通用 API 与框架原生适配；context.tools 按项目配置的 Agent 框架封装工具。三个时间维度
一次请求结束，不代表会话实例立即销毁；实例存活，也不代表单次请求可以无限执行，需要区分以下限制：
维度 | 含义 | 取值 | 到期后果 |
单次执行 | 一次请求的最长运行时长 | 默认 5 分钟，最长可配置为 60 分钟 | 该请求返回 504 |
空闲回收 | 实例无请求后多久被回收 | 5 分钟 | 实例与内存状态释放，下次请求创建新实例 |
会话生命周期 | 会话实例的最长存活时长 | 6 小时 | 实例强制销毁 |
项目结构与路由
顶层目录决定执行单元，目录内的文件路径决定访问路由。 三类函数可以按需放在同一项目中，以下以 TypeScript 文件为例：
project/edge-functions/api/verify.ts → /api/verifycloud-functions/conversations/list.ts → /conversations/listagents/customer-service/index.ts → /customer-servicestop.ts → /customer-service/stop_lib/ → 内部模块，不生成路由edgeone.json → 项目配置
规则 | 说明 |
目录前缀不进入 URL | agents/、cloud-functions/、edge-functions/ 决定运行模式，不出现在路径中 |
index 映射目录根路径 | agents/customer-service/index.ts → /customer-service |
其他入口文件映射同名路径 | agents/customer-service/stop.ts → /customer-service/stop，URL 不包含文件扩展名 |
_ 前缀用于内部模块 | 不生成路由，供入口文件导入复用 |
三类函数共享路由空间 | 同一项目内路径不可重复；例如 agents/chat.ts 与 cloud-functions/chat.ts 都会映射到 /chat，应避免冲突 |
内置模型
新用户限时赠送 50 万 Token 试用额度，按账号维度计算、所有项目共享。使用模板部署时自动注入以下环境变量，业务代码通过
context.env 读取即可。变量 | 说明 |
AI_GATEWAY_API_KEY | 网关鉴权 Key，兼容 OpenAI 协议 |
AI_GATEWAY_BASE_URL | 网关地址，默认 https://ai-gateway.edgeone.link/v1 |
核心概念速览
概念 | 说明 |
context | 平台在每次请求注入的统一上下文对象，承载下方所有子能力 |
context.request | 标准 Web Request 对象（含 body / headers / signal），用于读取入参与监听中断 |
context.env | 环境变量与密钥的访问入口，等价于 process.env / os.environ 的安全读取 |
context.store | 会话级对话管理，按 conversation_id 自动归属，支持五大框架原生消息对象 |
context.tools | 面向 LLM 的工具清单，按 framework 字段自动封装为目标框架可直接消费的形态 |
context.sandbox | 沙箱原子 API（ commands / files / browser / runCode），用于在隔离环境中执行命令、读写文件、操作浏览器与运行代码 |
context.tracer | OpenTelemetry 风格的手动插桩入口，与平台自动采集的 trace 同链路 |
context.agent.store | 同 context.store，暴露在 Cloud Functions 与 Edge Functions |
conversation_id | 一次会话的唯一标识，是路由、Store 归属与 Sandbox 实例归属的 key |
run_id | 一次执行的唯一标识，trace、日志与 stop 操作都围绕它组织 |
framework | edgeone.json 中的字段，决定 context.tools / context.store 的框架适配形态 |
适用场景
对话助手：知识库问答、购物下单等多轮交互，结合会话上下文与工具调用完成连续任务。
文件处理：在沙箱中解析 CSV、PDF、图片等文件，并分析、整理结果。
周期性任务：由调度系统触发 Agent，采集业务数据、汇总分析并生成结构化报告。
内容生成：通过多角色或多步骤协作，产出博客、活动策划等内容。
流程编排：深度研究、邮件处理、人工审批等带状态与分支的任务，保存进度后继续处理。
编程助手：在云端沙箱中修改代码、执行验证并预览运行结果。
免费版配额
EdgeOne Makers 目前提供免费版，下面列出的均为免费版当前生效的各项配额。商业化版本正在规划中，具体定价与配额发布后将通过控制台公告同步更新。免费版配额在商业化正式上线前执行较为宽松，用量超限也会优先保障您的业务稳定，额度不足可提交 工单 申请提额，平台将持续监控滥用行为。
Agents
项 | 免费版 |
执行次数 | 20 万/月 |
总内存时长 | 10 万 GB-s/月 |
单个请求最长运行时间 | 3600 秒 |
会话最长空闲时间 | 300 秒 |
会话最大并发（运行）数 | 40 个 |
Sandbox
项 | 免费版 |
总内存时长 | 10 万 GB-s/月 |
最大并发（运行）数 | 20 个 |
单实例最长运行时间 | 3600 秒 |
默认超时时间 | 300 秒 |
