入门 📋 6 个步骤 第 280 / 470 篇

豆包 Agent 从零入门:低代码创建你的第一个 Excel 数据分析助手

豆包 Agent 让不懂代码的普通人也能创建自己的智能体:通过系统指令 + 内置工具(代码解释器/网页搜索/文件上传)描述任务,AI 就能拆解执行。本教程从概念、创建入口、写指令、配工具到上传 Excel 实战验证,再进阶到自定义工具接入自己的 API。

2026.08.14· 15 分钟阅读· 约 1857 字· 📊 豆包 Agent

很多人以为「做 AI 智能体」是程序员专属,其实豆包 Agent 已经把它变成了点几下就能完成的事。它和豆包聊天的本质区别在于:聊天只会「说」,而 Agent 会「干」——你上传一份 Excel 说「帮我算一下每个产品第一季度的总销量」,它会自己调用代码解释器、跑 Python 算完、再把结果整理给你。本教程从零开始,带你创建一个自己的 Excel 数据分析助手,并进阶到让它调用你自己的 API。

📊 本教程适合:完全没写过代码、却想拥有一个「数据小助手」的运营、财务、学生与打工人。全程在豆包网页上操作。想了解豆包的视频通话 Agent 能力可看《豆包 SeedRealtime》;想对比扣子(Coze)平台可看《Coze 零代码搭客服》。

先搞懂:豆包 Agent 和豆包聊天的区别

传统聊天模型是「知识库 + 文本生成器」:你问,它答。豆包 Agent 则是一个「任务执行者」,核心差异在于它具备感知-思考-行动-循环的能力:

能力通俗解释
感知接收你的指令或上传的文件、环境信息
思考理解意图,把复杂任务拆成步骤,决定调用哪个工具
行动运行代码、调用 API、操作软件,真正把事情做完
循环根据行动结果继续思考下一步,直到任务完成

驱动这一切的关键是工具调用(Function Calling)能力:豆包 Agent 预置了网页搜索、代码解释器、知识库查询等官方工具,也支持你自定义工具接入外部 API。本教程做的 Excel 助手,核心就是「代码解释器 + 文件上传」。

权限提示:豆包 Agent 目前可能处于逐步开放阶段,部分账号需要先开通对应功能权限,按页面引导操作即可。

Step 1:进入豆包平台,找到创建入口

1 登录豆包,找到「创建智能体」
1. 浏览器打开 doubao.com
2. 登录你的字节跳动账号(手机号即可)
3. 寻找「创建智能体 / 我的 Agent / 工作室 / 开发平台」入口
   (可能在侧边栏、顶部导航或个人中心)
4. 找不到?直接在对话里问豆包:
   「怎么创建 Agent?帮我打开创建页面」,
   它会引导你到正确入口
💡 页面打不开或空白?清缓存、换 Chrome/Edge 最新版、换网络后重试,是三大常规解法。

Step 2:新建智能体,填写身份信息

2 起名、写描述、选头像

进入创建页面后,先建立这个 Agent 的「身份证」:

名称:Excel 数据分析助手
描述:我是一个专业的 Excel 数据分析助手,可以帮你
     读取上传的 Excel/CSV 文件,回答关于数据的各种
     问题,如计算总和、平均值、最大值、最小值,
     以及进行简单的汇总分析。
头像:可以上传一个图表类图标,增加辨识度
🔑 描述写清楚「能做什么」,将来 Agent 在场景里被调用的机会更大,也是它的自我介绍。

Step 3:写好系统指令——Agent 的「宪法」

3 定义身份、流程与红线

系统指令决定了 Agent 如何思考和行动,照着下面这段改改就能用:

你是一个专注于 Excel/CSV 文件数据分析的助手。
你的工作流程如下:
1. 用户上传文件后,先确认已接收,并简要描述
   你看到的数据结构(X 行 Y 列,列名分别是什么)
2. 仔细理解用户的问题,可能涉及:
   求和、平均、最大值、最小值、筛选、分组汇总等
3. 所有计算必须基于文件中的真实数据,不得编造
4. 给出最终答案前,简要说明你的计算步骤
5. 数据有歧义时,主动向用户询问确认
6. 回答清晰、结构化,优先用列表或简短段落
7. 风格专业、简洁、乐于助人
🎯 系统指令的三个万能要素:它是谁(身份)、它该做什么(流程)、它不能做什么(红线)。写清楚这三样,Agent 的表现就稳了。

Step 4:配置工具能力

4 开启代码解释器,这是「干活」的关键

不给工具,Agent 只能「纸上谈兵」;配上工具,它才能真正动手:

1. 在「工具 / 能力」区域找到「代码解释器」并启用
   (让 Agent 能在沙箱里运行 Python 处理数据)
2. (可选)启用「网页搜索」:遇到非常规分析概念
   时可以自行搜索补充知识
3. 确认「文件上传」是开启状态(通常默认开启)
4. 保存完成创建,进入测试对话界面
🧰 代码解释器是数据分析类 Agent 的核心工具——求和、透视、绘图全靠它在后台跑 pandas 实现,而你完全不用写代码。

Step 5:实战测试——上传 Excel 提问

5 建一份数据,验证 Agent 真能干活

创建一份测试数据 sales.xlsx,包含:产品、一月销量、二月销量、三月销量四列(产品A/B/C 各三行数据)。然后在对话框里上传并提问:

提问:「帮我计算第一季度(前三个月)每个产品的
      总销量,并找出销量最高的产品。」

预期表现:
1. Agent 确认文件并描述结构
2. 后台调用代码解释器跑 pandas 计算
3. 输出:产品A总销量400,产品B总销量295,
        产品C总销量600。销量最高的是产品C。
✅ 验证标准:回答符合预期 → 创建成功;不符合 → 回到系统指令微调(比如强调「必须说明计算步骤」)。

Step 6:进阶——自定义工具,接你自己的 API

6 把分析结果发到企业微信/群聊

内置工具之外,豆包 Agent 支持用 OpenAPI 规范定义自定义工具,让它调用你自己的 HTTP 接口。以「把结果发到群聊」为例:

1. 准备一个 Webhook 地址(webhook.site 可临时测试)
2. 在 Agent 编辑页「自定义工具」里按 OpenAPI 3.0
   格式填写:接口路径、请求方法、参数(如
   analysis_result)、接口地址
3. 在系统指令末尾追加:
   「如果用户要求『发送到群聊』,在完成分析后
    调用群消息发送工具,把结果文本作为参数传入」
4. 测试:对 Agent 说「分析这个文件,然后把结果
   发到群聊」,它会先分析再调用你的接口

调不通先排查这三点:① 接口地址是否可公网访问;② 参数名/格式是否与定义一致;③ 是否需要鉴权(有鉴权要在规范里配 securitySchemes)。先用 Postman 单独测通接口,再接 Agent。

常见问题速查

你遇到的问题原因 & 解决
Agent 不调用工具,只给建议工具描述写清楚「何时调用」;系统指令里明确触发条件
代码解释器报 ModuleNotFoundError沙箱缺库,指令里建议 Agent 优先用内置常用库(pandas 等)
自定义工具调用返回 4xx/5xxURL/参数/CORS/鉴权逐个排查,先用 Postman 单独验证
答案在编数据指令里加死规定:所有结论必须严格基于用户提供的文件
← 返回教程中心