概览
Makers Agents 是开箱即用的 Agent 开发平台，开发者专注业务逻辑，部署后即可获得 Agent 运行时、沙箱工具、对话记忆、本地可调试的全链路追踪与内置模型完整能力。
平台优势
开箱即用：Agent 运行所需的工具、记忆、可观测、模型，部署后全部自动生效，无需安装和对接。
灵活开放：框架任选（Claude / OpenAI / LangGraph / CrewAI），不限制语言（JS / Python）。
无缝接入：Web 与 Agent 共用同一个项目，账号、部署、监控、域名统一管理。
核心能力
能力 | 说明 |
托管运行时 | 承载 LLM 调用、Agent 循环编排与业务逻辑，按会话路由、自动扩缩容 |
沙箱工具 | 面向 LLM 和开发者视角提供两层独立但互通的 API，浏览器、代码执行、Shell、文件操作都在独立沙箱环境运行 |
对话存储 | 适配各个 Agent 框架提供记忆管理能力，提供通用 API 管理会话、消息 |
可观测 | 调用链路自动采集，零侵入插桩，本地 / 云端面板统一查看链路数据 |
内置模型 | 自动注入模型 key，限时每月享受免费模型配额 |
运行模式
平台提供两种 Runtime，按目录区分用途，同一项目可任意组合。
目录 | Runtime 模式 | 用途 | 注入的 context |
agents/ | 会话模式（同 conversation_id 粘性路由到同实例，复用内存状态） | LLM 调用、Agent 循环、长任务编排 | request / env / store / tools / sandbox / tracer |
cloud-functions/ | 请求模式（无状态，每请求一个执行环境，弹性扩缩容） | 非 LLM 业务逻辑：数据查询、辅助 API 等 | request / env / agent.store |
agents/ 面向真正的 Agent 工作负载，因此在运行时层面做了专门设计：会话粘性：同一
conversation_id 的请求会被路由到同一实例，在对话活跃期间复用其内存里的上下文、缓存与连接。超长执行时长：单次执行默认 5 分钟、最长可配置到 1 小时，足以支撑 Agent 多轮循环、工具反复调用、深度研究等长时间任务。
cloud-functions/ 是无状态、按请求弹性扩缩容的轻量模式：每个请求用完即回收，没有常驻成本，适合数据查询、辅助 API 这类短平快逻辑。项目结构
project/agents/ ← 会话模式 Runtime（LLM / Agent 循环）customer-service/index.ts → POST /customer-servicestop.ts → POST /customer-service/stopcloud-functions/ ← 请求模式 Runtime（非 LLM 业务）conversations/list.ts → GET /conversations/list (读 store)edgeone.json ← 项目级配置
适用场景
对话助手：知识库问答、购物下单等多轮交互场景，结合记忆与工具调用完成连续任务。
文件处理：CSV 解析、PDF/图片等多模态文件处理，通过沙箱读取并分析文件内容。
定时任务：趋势热点新闻爬取汇总等周期性任务，按调度自动采集数据并生成结构化报告。
内容生成：博客图文、营销活动策划等场景，由多角色或多步骤协作产出长文与配图。
流程编排：深度研究、邮件处理等带状态与分支的流程，按节点流转状态、校验与人工审核。
编程助手：AI 网站构建器等场景，在云端沙箱中修改代码并预览运行结果
内置模型
新用户限时赠送 50w Token 试用额度，按账号维度计算、所有项目共享。使用模板部署时自动注入以下环境变量，业务代码通过
context.env 读取即可。变量 | 说明 |
AI_GATEWAY_API_KEY | 网关鉴权 Key，兼容 OpenAI 协议 |
AI_GATEWAY_BASE_URL | 网关地址，默认 https://ai-gateway.edgeone.link/v1 |
免费版配额限制
EdgeOne Makers 目前提供免费版，下面列出的均为免费版当前生效的各项配额。商业化版本正在规划中，具体定价与配额发布后将通过控制台公告同步更新。免费版配额在商业化正式上线前执行较为宽松，用量超限也会优先保障您的业务稳定，额度不足可提交 工单 申请提额，平台将持续监控滥用行为。
Agents
项 | 免费版 |
执行次数 | 20 万/月 |
总内存时长 | 10 万 GB-s/月 |
单个请求最长运行时间 | 1800 秒 |
会话最长空闲时间 | 300 秒 |
会话最大并发（运行）数 | 40 个 |
Sandbox
项 | 免费版 |
总内存时长 | 10 万 GB-s/月 |
最大并发（运行）数 | 20 个 |
单实例最长运行时间 | 3600 秒 |
默认超时时间 | 300 秒 |
核心概念速览
概念 | 说明 |
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 |
conversation_id | 一次会话的唯一标识，是路由、Store 归属与 Sandbox 实例归属的 key |
run_id | 一次执行的唯一标识，trace、日志与 stop 操作都围绕它组织 |
framework | edgeone.json 中的字段，决定 context.tools / context.store 的框架适配形态 |
