前言

周五下午，老板突然甩来一条消息：“小X，最近Agent很火，领导想知道咱们的使用深度，下周开会，你做一个能查项目进度、自动生成周报的那种智能助理出来，给大家演示一下我们使用AI的最新成果。”

我：？

正常人可能要一周都搞不定，这不得妥妥骂老板。

本来我是不想惯着的，但是现在可好了，我用 EdgeOne Makers，从零到全球上线，只用了一个下午。

剩下的时间那不白嫖摸鱼吗，聪明如我，哈哈！

这篇文章就是我的完整复盘，也是一份可以照着抄的实战手册，操作非常简单易学，小白也能玩转，思路供大家参考，希望大家喜欢。

---

一、故事：从"这得排期两周"到"下午搞定"

事情是这样的。

周五快下班了，我正琢磨晚上是吃烤鱼还是咖喱饭，老板发来消息，问我能不能做一个企业智能项目助理——能查项目进度、能自动生成周报、能分析财务数据、最好还能做风险预警。就是那种最近很火的Agent,你懂得，大家都在搞AI，我们更不能落后！

我心里一盘算。这可不好整啊！

正常流程：评估需求 → 排期 → 搭基础设施 → 写 Agent 逻辑 → 部署上线。一周起步。

但这次不一样。我刚好看完 EdgeOne Makers 的文档，决定试试"分钟级上线"是不是真的。

结果：

15:30  确定需求和 Agent 定位
16:00  写完 Agent 核心提示词和工具定义
16:30  完成前端 Demo（数据看板 + 对话界面）
17:00  部署到 EdgeOne Makers，全球节点同步生效
17:15  发效果图给老板长眼
17:20  老板回："可以，干得不错！"

周五下午茶时间，我还在讨论周末去哪玩，我的 Agent 已经跑在云服务器全球 3200+ 边缘节点上了。

这次说什么也不加班了，到点就下班！

---

二、先说清楚：这个 Agent 到底能干什么

在做之前，先说清楚要做什么。

核心定位：企业智能项目助理——一个能接入真实项目数据、帮管理者和项目经理省时间的 AI 助手。

五大核心能力：

能力	场景举例	解决的问题
📋 项目进度查询	“Q3 所有项目进展怎么样了？”	不再需要翻 Excel、问 PM
📝 周报自动生成	“生成本周周报”	每周重复劳动，一句话搞定
💰 财务数据分析	“Q3 各项目回款情况如何？”	数据散落在不同系统，一问即知
📄 合同版本对比	“对比一下 V2.3 和 V2.4 合同差异”	法务/采购必备，减少合同纠纷
⚠️ 风险预警	“目前有哪些项目需要关注？”	从被动救火到主动预防

技术亮点：

• Agent 不只是"答 FAQ"，而是能真正调用工具查数据库、读文档
• 全球极速访问——国内 < 30ms，亚太 < 80ms
• 前端界面：数据看板 + 智能对话 + 知识库三合一

---

三、EdgeOne Makers 是什么，为什么它解决了这些问题

3.1 核心理念：不锁框架、不锁语言、不锁模型

EdgeOne Makers 是面向开发者与中小企业的通用 Agent 托管底座。它的核心设计哲学是：

让 Agent 真正跑在用户面前，而不是卡在工程师的电脑上。

三个关键词：

• ✅ 开箱即用：运行时、记忆、工具、可观测全部内置，部署后自动生效
• ✅ 接得进真实业务：沙箱工具（Sandbox Tools）直连数据库和 API
• ✅ 全球极速交付：依托 EdgeOne 边缘网络，3200+ 节点分钟级部署

3.2 全球节点分布（为什么快）

┌──────────────────────────────────────────────┐
│              全球 3200+ 边缘节点               │
│                                              │
│  🇨🇳 中国大陆     2000+ 节点    < 30ms       │
│  🌏 亚太其他       500+ 节点    < 80ms       │
│  🌎 北美/欧洲      300+ 节点   < 150ms       │
└──────────────────────────────────────────────┘

3.3 Agent 原生开发能力

Makers Agents 内置了做生产级 Agent 所需的全部能力：

内置能力	说明
运行时	Agent 执行引擎，无需自建
沙箱工具	连接数据库、API、文件，安全隔离执行
会话记忆	自动管理多轮对话上下文
模型网关	支持 OpenAI / Claude / 豆包 / 通义 / DeepSeek 等
可观测性	请求量、延迟、工具调用成功率，开箱即见

---

四、完整部署实操：从零到全球上线只需四步

提示：以下步骤基于 EdgeOne Makers 平台的实际界面。最终界面可能略有更新，请以官方文档为准。

前置条件

在开始之前，请确保：

1. ✅ 已注册腾讯云账号并开通 EdgeOne 服务
2. ✅ 账号已完成 GitHub 绑定（方便后续自动部署）

---

Step 1：进入控制台

访问 EdgeOne Makers 控制台：
如下所示，第一次使用我们需要先进行一下注册。

然后我们进行激活操作。
Activate Now,立即激活！

登录后，点击「创建项目」或「新建 Agent」进入项目创建页面。

---

Step 2：连接 Git 仓库

EdgeOne Makers 支持两种 Git 连接方式：

方式 A：直接在平台编写代码

• 在控制台的在线编辑器中编写 Agent 提示词、工具定义、前端代码
• 适合快速验证和小项目

方式 B：连接 GitHub 仓库（推荐）

• 先将代码推送到 GitHub，然后在控制台选择「导入 GitHub 仓库」
• 支持自动部署：每次 push 自动触发重新部署

# 推送代码到 GitHub
git init
git add .
git commit -m "feat: 企业智能项目助理 v1.0"
git remote add origin https://github.com/你的用户名/enterprise-project-agent.git
git push -u origin main

---

操作界面如下图所示，我觉得其实github以外，gitee和gitlab也很好，这里我们选择Gitee。

登录到自己对应的git仓库进行授权。

Step 3：创建和部署

我们选择模板进行创建，这样比较简单，也可以自由创建。

在 控制台项目页，选择项目来源：

我这次使用的是方式一（从模板开始），基于平台模板快速搭建了前端界面。
然后启动Build&Deploy就行了。

构建完成后，我们可以通过预览访问地址看到运行效果：

基于模板的Agent就创建好了，运行效果如下：

Step 4：定义 Agent（配置提示词 + 工具）

这是最核心的一步——告诉 Agent 它是谁、能做什么、遇到问题怎么办。我们定义好配置文件如下（参考示意）：

# agent.yaml（Agent 核心配置）

name: 企业智能项目助理
description: 帮助项目经理查进度、生周报、分析风险

model:
  provider: anthropic
  name: claude-3.5-sonnet

# 沙箱工具定义 —— 让 Agent 能真正"动手"查数据
tools:
  - name: 查询项目进度
    type: database
    description: 查询所有活跃项目的进度、状态、截止日期
    query: |
      SELECT project_name, client, pm, progress,
             status, deadline, budget, spent
      FROM projects WHERE period = 'Q3'

  - name: 财务数据分析
    type: database
    description: 查询 Q3 各项目的财务数据
    query: |
      SELECT project_name, contract_amount,
             paid_amount, unpaid_amount, budget_usage
      FROM finance WHERE period = 'Q3'

  - name: 合同版本对比
    type: file
    description: 读取并对比两个合同版本的差异
    files:
      - contract_v2.3.pdf
      - contract_v2.4.pdf

  - name: 生成周报文档
    type: file_write
    description: 将周报内容写入文件
    output: "weekly_report_{date}.md"

# 提示词 —— Agent 的人设和说话风格
prompt: |
  你是明远科技集团的企业智能项目助理小智。
  
  【能力范围】
  - 查询 Q3 所有项目的进度、风险、里程碑状态
  - 分析财务数据（营收、回款、预算执行）
  - 对比合同版本差异
  - 自动生成周报
  
  【回复风格】
  - 先回应用户意图，再给出具体数据
  - 用结构化输出（表格/列表），方便用户直接使用
  - 主动发现风险，给出应对建议
  
  【禁止行为】
  - 不确定的问题不瞎猜，明确告知无法回答
  - 不透露内部系统表结构
  - 不执行任何删除/修改操作

我们可以向配置好的Agent提出专业性的问题,如下所示，只要提供完整的文件资料作为知识库，就可以进行关于项目工作计划、规划等方面的专业问题，如下所示：

在后台上可以非常直观地看到我们使用资源的消耗情况以及运行状态，我觉得这功能超级赞，数据一目了然，省了不少功夫，非常透明！

---

Step 5：配置前端界面

Makers Agents 支持同一个项目同时托管 Web 前端和 Agent 接口，不需要分开部署。

我设计的界面包含三个模块：

📊 数据看板

• KPI 卡片（营收目标、项目数、里程碑达成率、回款率）
• 项目进度列表（颜色指示器 + 进度条）
• 风险预警卡片
• 财务明细表格

💬 智能对话

• 自然语言输入框
• 实时"正在输入"动画
• 工具调用可视化展示（让用户知道 Agent 在调用哪个工具）
• 支持快捷入口一键发送

📁 知识库

• 文档卡片网格展示
• 实时搜索过滤
• 支持 PDF / Word / Excel / Markdown 多格式

---

Step 6：发起部署

一切配置完成后，点击「部署」按钮：

# 同时也可以用 CLI 部署
cd enterprise_project_assistant
edgeone deploy

# 部署日志（示意）
[17:00:01] ✓ 验证配置
[17:00:02] ✓ 初始化 Agent 运行时
[17:00:03] ✓ 配置沙箱工具权限
[17:00:04] ✓ 部署前端到全球节点
[17:00:05] ✓ 启用可观测面板
[17:00:05]
[17:00:05]  🎉 部署成功！
[17:00:05]
[17:00:05]  前端地址:  https://enterprise-agent.edgeone.ai
[17:00:05]  Agent API:  https://enterprise-agent.edgeone.ai/api
[17:00:05]  全球节点:  已同步至 3200+ 边缘节点

部署完成后，前端和 Agent API 共用同一个域名，前端 fetch('/api/chat') 即可调用 Agent，零跨域问题。

效果展示：Agent 跑起来是什么体验

部署完成之后，用户访问地址，看到的是一个完整的企业级应用。

五、效果展示

4.1 数据看板

进入首页即是数据看板：

• 4 个 KPI 卡片：Q3 营收进度（73%）、项目数量（12个）、里程碑达成率（91%）、回款率（78%）
• 项目进度列表：每个项目用颜色标识（绿=正常 / 黄=预警 / 红=风险）
• 风险预警区：显示当前最高优先级的风险项及建议行动
• 财务明细表：合同额、已回款、未回款、预算执行一目了然

4.2 智能对话（Agent 核心能力）

用户可以用自然语言与 Agent 交互：

示例对话 1：查项目进度

用户: Q3 所有项目进度怎么样了？

Agent: 正在查询项目数据库...
       (调用 tools.查询项目进度)

       共 5 个活跃项目，其中 3 个正常推进，2 个需要关注：

       ✅ 正常：
       • 财务共享中心 — 进度 91%，8月20日交付
       • 智慧社区平台 — 进度 82%，9月15日交付
       • 智能营销平台 — 进度 67%，按计划推进

       ⚠️ 预警：
       • 供应链优化系统 — 进度 58%，滞后 15 天
       • 数据中台建设 — 进度 45%，人力不足

       建议本周召开项目进度会对齐预期。

示例对话 2：合同版本对比

用户: 对比一下供应链合同 V2.3 和 V2.4 的差异

Agent: 正在分析合同文档...
       (调用 tools.合同版本对比)

       对比结果如下：

       | 条款      | V2.3         | V2.4           | 变更     |
       |-----------|--------------|----------------|---------|
       | M2截止    | 2026-08-15  | 2026-09-05    | ⏰+15天 |
       | M3截止    | 2026-09-15  | 2026-09-30    | ⏰+15天 |
       | M4截止    | 2026-10-31  | 2026-11-15    | ⏰+15天 |
       | 付款结构  | 30%/30%/20% | 25%/25%/25%  | 💰调整  |
       | 违约豁免  | 无           | 新增甲方变更条款| 📌新增  |

       ⚠️ 风险提示：V2.4 整体延期 15 天，建议：
       1. 8月20日设 Checkpoint 评估进度
       2. 存档 V2.4 及其变更附件
       3. 与法务确认增项开票时间

示例对话 3：自动生成周报

用户: 生成本周周报

Agent: 正在整合本周数据...
       (调用 tools.查询项目进度 + tools.财务数据分析)

       ## 本周工作总结（2026.7.7 - 7.13）

       ✅ 已完成：
       • 智慧社区平台：完成用户权限模块，进入联调
       • 财务共享中心：上线报销自动化，效率提升 40%

       🔄 进行中：
       • 供应链优化系统：核心模块开发（58%）
       • 数据中台：数据建模与 ETL 设计

       📋 下周计划：
       • 智慧社区进入 UAT 测试
       • 供应链召开变更对齐会
       • 数据中台启动数据接入

       ⚠️ 风险提示：供应链延期风险上升，逾期 ¥320万待追回

       ✅ 周报已生成，可直接复制使用。

运行效果如下：

整个系统的功能界面，包含强大的数据看板，后台集成了知识库、智能对话、项目总览等功能。

将项目相关的资料合同、财务数据等导入作为历史资料知识库。

然后，最关键的是，作为一个智能体，如何体现它的智能呢？

我们就用智能问答来解决，可以直接问Agent项目进展情况等问题。

光回答问题还不够，还需要有智能分析的功能，这样才是一个有工作价值的agent!

---

六、踩过的坑：为什么我以前做 Agent 总卡在"最后一公里"

在说部署步骤之前，我想先吐槽一下我之前踩过的坑。

坑一：基础设施耗掉 70% 的时间

以前搭一个 Agent，真正的"智能"代码可能只占 30%，剩下全是基础设施：

• 搭 LLM 调用框架
• 配置工具调用（Function Calling）
• 写记忆系统（短期/长期会话）
• 接可观测（日志、Trace、Token 监控）
• 搭向量数据库做 RAG

光这些配置，就耗掉了我 2-3 周。

坑二：FAQ 机器人无法接入真实业务

很多团队做的"AI 客服"，其实是把问答对塞进知识库。问题是——它只能答"我们知道的事"，无法查订单、无法连数据库、无法办业务。

用户问"我的订单到哪了"，FAQ 机器人只能说"请提供订单号，我帮您查询"。但查了之后呢？答不上来。

坑三：上线之后发现海外用户访问慢

好不容易本地跑通了，部署上去发现海外用户延迟 800ms。再去配 CDN、备案、回源，一周又过去了。

---

写在最后：从"感觉很强"到"真的有用"

写完这篇复盘，我最大的感受是：

EdgeOne Makers 真正降低的门槛，不是"写代码"，而是"把代码变成用户能用的服务"。

以前一个 Agent 项目，代码写完只完成了 30%，剩下 70% 是基础设施、部署、运维。 Makers 把这 70% 变成了"配置项"而不是"工程问题"。开发者的精力终于可以放回——到底要帮用户解决什么问题。

这个企业智能项目助理，现在已经上线跑在 EdgeOne 边缘节点上了。老板每周开会前都会问它一句"Q3 进度怎么样"，比以前翻 Excel、追 PM 要高效多了。

好的工具，让好的想法落地。EdgeOne Makers 就是这样的工具。

好了，到点下班，希望大家也能有所收获，共同学习进步。