使用 Makers Agents 快速搭建 Agent 应用
Makers Agents 是面向开发者的一站式 Agent 开发与托管平台。你可以使用 JS 或 Python，结合 Claude Agent SDK、OpenAI Agents SDK 等主流框架编写业务逻辑；平台则自动提供 Agent 运行时、模型调用、沙箱工具、会话管理和全链路追踪能力，Web 前端、Agent 与业务接口还可在同一项目中开发和管理。本文将从适用场景、项目结构、模板快速开始到本地调试与部署，带你完成一个 Makers Agent 应用的开发闭环。
Makers Agents 适合做什么
构建行业 SaaS
Makers Agents 适合将行业知识、业务数据和操作流程封装为可持续交付的 AI 能力。Agent 不仅能够回答问题，还可以调用工具和业务接口完成查询、分析、生成与流程执行，帮助开发者构建面向具体行业的 SaaS Agent 产品。
以下是几个典型方向：
电商：构建 AI 导购、智能客服和商家运营助手，Agent 可以理解购买需求、推荐商品、查询订单与物流，也可以辅助商家生成商品文案和分析评价。
营销与内容：将品牌规范、内容素材和审核标准沉淀为 Agent 工作流，用于选题策划、文案生成、多渠道改写、素材分析与内容审核。
企业服务：面向客服、销售和运营场景构建知识助手与流程助手，连接客户、工单、合同或预约系统，完成资料检索、信息汇总、线索跟进和任务流转。
医疗与健康服务：构建患者服务、预约导诊和健康管理助手，连接医疗知识库、预约、档案与随访系统，完成就医指引、资料整理和健康知识问答。
构建 Vibe Coding 平台
Vibe Coding 平台让终端用户通过自然语言创建、修改并发布应用。平台负责理解需求、生成代码、运行验证和持续迭代，最终交付可长期访问的应用。Vercel v0、Lovable 等产品都属于这一形态。
EdgeOne Makers 将生产、部署、合规检测、访问及多租户隔离等核心能力整合于一体，帮助平台方无需自建和维护底层基础设施，即可打通「对话生成 → 实时预览 → 应用上线 → 多租户隔离」的完整 Vibe Coding 链路。详细方案可以参考 Vibe Coding 平台构建。
平台优势
开箱即用：Agent 运行所需的工具、记忆、可观测、模型，部署后全部自动生效，无需安装和对接。
灵活开放：框架任选（Claude / OpenAI / LangGraph / CrewAI），不限制语言（JS / Python）。
无缝接入：Web 与 Agent 共用同一个项目，账号、部署、监控、域名统一管理。
理解 Makers Agent 的运行方式
Makers Agents 采用“两种运行时协同 + 平台能力统一注入”的开发模式。Web 前端、Agent 和业务接口可以放在同一个项目中，共用部署、域名与可观测体系；平台根据代码所在目录，为不同工作负载选择合适的运行时。详细了解可以参考 Agents 概览。
my-agent/├── agents/│ └── customer-service/│ ├── index.ts # POST /customer-service│ └── stop.ts # POST /customer-service/stop├── cloud-functions/│ └── conversations/│ └── list.ts # GET /conversations/list├── app/ 或 src/ # 前端应用├── edgeone.json # 构建配置与 Agent 框架声明└── .env.example # 仅声明变量名，不存放真实密钥
快速开始
选择模板
Makers 提供两类模板：
模板类型 | 适合场景 |
框架基础模板 | 提供最小可运行的基于各个 Agent 框架的入门模板，适合从零扩展业务逻辑 |
业务场景模板 | 已包含基础功能和业务常见交互，适合修改品牌与融合业务流程后快速上线 |
通过 CLI 创建项目
npm install -g edgeoneedgeone makers create --template openai-agents-starter-node
使用 Skill 创建或迁移现有 Agent 项目
Makers 提供了 Agent 开发和迁移 Skill，详细安装流程可以参考 Skills，在 Cursor、CodeBuddy 等开发工具中加载相应 Skill 后，AI 可以按照 Makers 平台规范完成 Agent 项目创建和迁移。
可以直接向 AI 输入以下类似提示语：
在 EdgeOne Makers 上用 Claude Agent SDK 写一个对话 Agent
把这个 LangGraph Agent 项目改造成 EdgeOne Makers 的平台格式
本地调试和部署
启动本地开发调试
若需使用 Makers 控制台中已配置的环境变量，请先执行
edgeone makers link 关联已有项目。启动本地调试：
edgeone makers dev
您可通过 http://localhost:8088/ 访问 Agent 页面。
通过 http://localhost:8088/agent-metrics 访问本地可观测链路追踪页面。
部署项目
如果项目已关联 Git 仓库，推送代码即可触发 Makers 的 CI 构建与部署。也可以通过 CLI 直接部署：
# 部署至生产环境edgeone makers deploy -n <项目名>
部署成功后点击 Console 的链接可以访问具体构建信息和部署后的 URL。