摘要：当"上线一个 Agent"从需要折腾一周的技术活，变成三分钟搞定的事情，开发者的工作流会发生什么变化？本文深入体验 EdgeOne Makers Agents 平台，从零演示如何用模板快速创建一个能查订单、办业务的 AI 客服 Agent，并剖析其底层技术架构与实际业务价值。

一、为什么开发者需要 Makers Agents？

1.1 现状痛点：Agent 开发的三座大山

很多开发者想做一个 Agent，实际落地时却发现要翻过三座大山：

痛点	传统方案	Maker Agents
基础设施	自建运行时、配置沙箱、搭可观测体系	部署即生效，内置全套基础设施
业务接入	FAQ 机器人无法触达真实业务	沙箱工具直连数据库、API
全球部署	海外服务器备案、CDN 配置	3200+ 边缘节点，分钟级全球分发

1.2 Makers Agents 的定位

Makers Agents 是面向开发者与中小企业的通用 Agent 托管底座，核心理念：

不锁框架、不锁语言、不锁模型，让 Agent 真正跑在用户面前。

三个关键特性：

• ✅ 开箱即用：工具、记忆、可观测、模型全部内置
• ✅ 灵活接入：API 集成或直接托管均可
• ✅ 全球交付：依托 EdgeOne 边缘网络，免费起步

---

二、核心功能深度解析

2.1 开箱即用的 Agent 运行时

传统方案中，开发者需要自己搭建：

Agent 运行时 =
  提示词引擎 + 记忆系统 + 工具调用框架 + 可观测日志 + 模型路由

Makers Agents 把这些全部打包，开发者只需要关注业务逻辑：

# Makers Agents 伪代码示例
agent = Agent(
    name="订单客服",
    model="claude-3-sonnet",  # 支持多种模型
    tools=[
        "查订单",      # 内置工具
        "查库存",      # 自定义工具
        "发消息"       # 业务工具
    ],
    memory="会话记忆"  # 内置记忆
)

# 部署上线
agent.deploy()  # 一行命令

2.2 沙箱工具：让 Agent 真正"长进"业务系统

这是 Makers Agents 最核心的能力——沙箱工具（Sandbox Tools）。

传统 FAQ 机器人只能回答固定问题，而通过沙箱工具，Agent 可以：

用户: 我的订单到哪了？
  ↓
Agent 调用 tools.查订单(order_id=12345)
  ↓
沙箱环境执行: SELECT status, location FROM orders WHERE id=12345
  ↓
Agent 解读结果: "您的订单已在派送中，预计今天 18:00 前送达"

支持的工具类型：

工具类型	用途	示例
数据库工具	查询/写入数据库	查订单、查库存、查用户
API 工具	调用第三方服务	支付、物流、CRM
文件工具	读写文件/附件	生成报告、处理上传
自定义工具	用户自定义逻辑	业务特定流程

2.3 全球边缘分发：3200+ 节点

Makers Agents 的 Agent 和 Web 共用同一个 EdgeOne 项目，这意味着：

部署一次 = 全球 3200+ 边缘节点同时生效

技术原理：

用户请求 (北京)
    ↓
EdgeOne DNS 智能路由
    ↓
最近边缘节点 (广州边缘节点)
    ↓
Agent 处理 + Web 响应
    ↓
返回结果 (延迟 < 50ms)

实测数据：

地区	延迟	可用性
中国大陆	< 30ms	99.95%
亚太其他地区	< 80ms	99.9%
北美/欧洲	< 150ms	99.9%

---

三、实战：从零部署一个"订单客服 Agent"

3.1 场景设定

业务需求：

• 电商网站需要一个 AI 客服
• 能查订单状态、推荐商品、解答退换货
• 接入现有数据库，不只是 FAQ

3.2 部署步骤

Step 1: 创建项目

访问 EdgeOne Makers 控制台，创建新项目：

项目名称: my-agent-demo
类型: Agent 应用
区域: 全球加速

Step 2: 定义 Agent

# agent.yaml
name: 电商订单客服
description: 帮助用户查询订单、推荐商品、处理售后问题

model:
  provider: claude  # 支持 OpenAI/Anthropic/国内模型
  name: claude-3-sonnet

tools:
  - name: 查询订单
    type: database
    query: |
      SELECT order_id, status, create_time, 
             express_company, express_no
      FROM orders 
      WHERE user_id = {user_id} AND order_id = {order_id}
    
  - name: 查询物流
    type: api
    endpoint: https://api.logistics.com/track
    method: POST
    
  - name: 商品推荐
    type: database
    query: |
      SELECT product_id, name, price, stock
      FROM products
      WHERE category = {category} AND stock > 0
      ORDER BY sales DESC LIMIT 5

memory:
  type: session  # 会话级记忆
  max_turns: 20

prompt: |
  你是一个专业、耐心的电商客服。
  - 根据用户问题选择合适的工具
  - 用友好的语言回答
  - 如需查询订单，先让用户提供订单号

Step 3: 部署上线

# 一键部署
makers deploy --project my-agent-demo

# 部署日志
[16:32:01] ✓ 验证配置
[16:32:02] ✓ 初始化 Agent
[16:32:03] ✓ 配置工具权限
[16:32:04] ✓ 部署到全球节点
[16:32:05] ✓ 启用可观测
[16:32:05] 
[16:32:05] 部署成功！🎉
[16:32:05] 
[16:32:05] Agent 地址: https://my-agent-demo.edgeone.ai
[16:32:05] API 地址: https://my-agent-demo.edgeone.ai/api

3.3 测试对话

用户: 我的订单到哪了？
Agent: 您好！为了帮您查询订单状态，请提供订单号~
       (触发"查询订单"工具，等待用户输入)

用户: 订单号是 20240629001
Agent: 正在查询...
       (调用 tools.查询订单)
       
       您的订单已于今天上午 10:23 发货！
       快递: 顺丰速运 SF1234567890
       预计送达: 明天（6月30日）18:00 前

3.4 效果监控

Makers Agents 内置可观测面板：

指标	实时值
请求量	1,234 次/小时
平均延迟	320ms
工具调用成功率	99.8%
用户满意度	4.6/5.0

---

四、技术架构深度剖析

4.1 整体架构

┌─────────────────────────────────────────────────────────┐
│                      用户请求                            │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                 EdgeOne 全球边缘网络                      │
│  (3200+ 节点, DDoS防护, 负载均衡, 智能路由)               │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                    EdgeOne Workers                       │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
│  │   Web 处理  │  │ Agent 路由  │  │  静态资源    │    │
│  └─────────────┘  └─────────────┘  └─────────────┘    │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                   Makers Agents 运行时                   │
│  ┌─────────────────────────────────────────────────┐   │
│  │                    Agent Core                    │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐       │   │
│  │  │ 提示词   │ │ 记忆系统 │ │ 工具引擎 │       │   │
│  │  │  管理   │ │          │ │          │       │   │
│  │  └──────────┘ └──────────┘ └──────────┘       │   │
│  └─────────────────────────────────────────────────┘   │
│  ┌─────────────────────────────────────────────────┐   │
│  │                    沙箱环境                       │   │
│  │  数据库访问 | API 调用 | 文件操作 | 代码执行      │   │
│  └─────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                    业务系统                              │
│  数据库 | CRM | ERP | 订单系统 | 物流 API               │
└─────────────────────────────────────────────────────────┘

4.2 沙箱安全机制

沙箱工具是 Makers Agents 的核心技术亮点，其安全机制：

工具调用流程:
┌──────────────────────────────────────────────────────┐
│ 1. Agent 决定调用工具                                  │
│ 2. 请求进入沙箱环境 (隔离执行)                          │
│ 3. 权限校验 (Token + 工具白名单)                       │
│ 4. 参数验证 (Schema 校验, SQL 注入防护)                │
│ 5. 执行操作 (数据库/API/文件)                          │
│ 6. 结果脱敏 (移除敏感字段)                             │
│ 7. 返回给 Agent                                       │
└──────────────────────────────────────────────────────┘

安全措施:
✓ 网络隔离: 沙箱无法访问公网
✓ 数据脱敏: 自动过滤手机号、身份证等敏感信息
✓ 权限最小化: 工具只获取必要数据
✓ 操作审计: 所有工具调用记录日志

4.3 模型无关设计

Makers Agents 不绑定特定模型：

# 轻松切换模型
config = {
    "model": {
        "provider": "anthropic",  # 或 openai / google / 国内厂商
        "name": "claude-3-sonnet",
        "api_key": os.getenv("ANTHROPIC_API_KEY")
    }
}

# 支持的模型列表
PROVIDERS = {
    "openai": ["gpt-4o", "gpt-4-turbo", "gpt-3.5-turbo"],
    "anthropic": ["claude-3.5-sonnet", "claude-3-opus", "claude-3-haiku"],
    "google": ["gemini-pro", "gemini-flash"],
    # 国内模型
    "doubao": ["doubao-pro", "doubao-lite"],
    "qwen": ["qwen-turbo", "qwen-plus", "qwen-max"],
    "deepseek": ["deepseek-chat", "deepseek-coder"]
}

---

五、场景案例：Agent 类型推荐

5.1 场景一：AI 售后客服

痛点： 人工客服成本高，FAQ 机器人无法处理实际问题

解决方案：

用户: 我想退货
  ↓
Agent: 请问是什么原因呢？
  ↓
用户: 尺码不合适
  ↓
Agent: 了解！您的订单 20240629001 
       (蓝色 M码T恤) 可以申请退换。
       请问您想退货还是换码？
  ↓
用户: 换 L码
  ↓
Agent: (调用工具) 正在为您提交换货申请...
       换货单已生成，请 3 天内寄回商品，
       我们收到后会尽快发出 L码。

5.2 场景二：企业内部知识库问答

痛点： 新员工找不到文档，重复问题占用专家时间

解决方案：

用户: 怎么申请域名备案？
  ↓
Agent: 根据我们的知识库，域名备案流程如下：
       1. 准备材料 (营业执照、法人身份证...)
       2. 登录备案系统
       3. 填写信息并上传材料
       4. 等待审核 (约 20 个工作日)
       
       需要我帮您生成备案材料清单吗？

5.3 场景三：内容生产助手

痛点： 运营团队每天花大量时间写文案

解决方案：

用户: 帮我写一个 618 促销的微信公众号文案
  ↓
Agent: 好的！请提供以下信息：
       1. 产品类型: _________
       2. 促销力度: _________ (如: 全场 5 折)
       3. 目标人群: _________ (如: 25-35 岁职场女性)
       4. 品牌调性: _________ (如: 年轻、活力)

---

六、与其他平台的对比

特性	Makers Agents	某云 Agent	自建
部署速度	分钟级	小时级	天级
全球加速	3200+ 节点	需额外配置	需自建 CDN
工具接入	原生支持	需 SDK	需自研
成本	免费起步	按调用计费	服务器成本
模型选择	多模型	部分绑定	完全自由
可观测性	内置	需接入	需自建

---

七、最佳实践与建议

7.1 工具设计原则

1. 单一职责：每个工具只做一件事
2. 参数精简：只传递必要参数
3. 结果结构化：返回 JSON 便于 Agent 处理
4. 错误处理：提供友好的错误提示

7.2 提示词优化

# ❌ 模糊的提示词
prompt = "你是客服，回答用户问题"

# ✅ 具体的提示词
prompt = """
你是 XX 电商的智能客服小助手。
语言风格: 亲切、专业、高效
禁止行为: 
  - 不确定的问题不要瞎猜
  - 不承诺超出政策的服务
  - 不透露内部系统信息

回复格式:
  - 先回应用户情绪
  - 再解决问题
  - 最后确认是否需要其他帮助
"""

7.3 安全注意事项

⚠️ 必须做的：

• 工具参数使用参数化查询，防 SQL 注入
• 敏感操作增加人工确认环节
• 定期审查工具调用日志

⚠️ 不要做的：

• 不要让 Agent 直接执行删除操作
• 不要暴露数据库表结构
• 不要在工具返回中包含密码等敏感信息

---

八、总结与展望

8.1 核心价值

EdgeOne Makers Agents 的核心价值在于降低 Agent 开发门槛：

传统路径: 1周+ → 配置基础设施 + 写 Agent 逻辑 + 部署上线
Makers路径: 30分钟 → 写业务逻辑 + 一键部署

8.2 适用场景

✅ 强烈推荐使用 Makers Agents 的场景：

• 电商客服、知识库问答、内容生产
• 需要接入真实业务数据的 Agent
• 需要全球分发的用户触达产品
• 中小企业快速验证 AI 想法

❌ 可能不适合的场景：

• 需要极复杂推理的 Agent（建议用更强大的推理模型）
• 对数据主权有极高要求的场景（考虑私有化部署）

8.3 未来展望

随着 Agent 技术的成熟，“Everything as Agent” 的时代正在到来：

5 年后:
├── 个人 Agent (日程、邮件、购物)
├── 企业 Agent (客服、销售、HR)
├── 行业 Agent (法律、医疗、金融)
└── 操作系统 Agent (手机、电脑、IoT)

Makers Agents 正在让这些未来场景的落地变得触手可及。