很多人以为「做 AI 智能体」是程序员专属,其实豆包 Agent 已经把它变成了点几下就能完成的事。它和豆包聊天的本质区别在于:聊天只会「说」,而 Agent 会「干」——你上传一份 Excel 说「帮我算一下每个产品第一季度的总销量」,它会自己调用代码解释器、跑 Python 算完、再把结果整理给你。本教程从零开始,带你创建一个自己的 Excel 数据分析助手,并进阶到让它调用你自己的 API。
先搞懂:豆包 Agent 和豆包聊天的区别
传统聊天模型是「知识库 + 文本生成器」:你问,它答。豆包 Agent 则是一个「任务执行者」,核心差异在于它具备感知-思考-行动-循环的能力:
| 能力 | 通俗解释 |
|---|---|
| 感知 | 接收你的指令或上传的文件、环境信息 |
| 思考 | 理解意图,把复杂任务拆成步骤,决定调用哪个工具 |
| 行动 | 运行代码、调用 API、操作软件,真正把事情做完 |
| 循环 | 根据行动结果继续思考下一步,直到任务完成 |
驱动这一切的关键是工具调用(Function Calling)能力:豆包 Agent 预置了网页搜索、代码解释器、知识库查询等官方工具,也支持你自定义工具接入外部 API。本教程做的 Excel 助手,核心就是「代码解释器 + 文件上传」。
权限提示:豆包 Agent 目前可能处于逐步开放阶段,部分账号需要先开通对应功能权限,按页面引导操作即可。
Step 1:进入豆包平台,找到创建入口
1. 浏览器打开 doubao.com
2. 登录你的字节跳动账号(手机号即可)
3. 寻找「创建智能体 / 我的 Agent / 工作室 / 开发平台」入口
(可能在侧边栏、顶部导航或个人中心)
4. 找不到?直接在对话里问豆包:
「怎么创建 Agent?帮我打开创建页面」,
它会引导你到正确入口
Step 2:新建智能体,填写身份信息
进入创建页面后,先建立这个 Agent 的「身份证」:
名称:Excel 数据分析助手
描述:我是一个专业的 Excel 数据分析助手,可以帮你
读取上传的 Excel/CSV 文件,回答关于数据的各种
问题,如计算总和、平均值、最大值、最小值,
以及进行简单的汇总分析。
头像:可以上传一个图表类图标,增加辨识度
Step 3:写好系统指令——Agent 的「宪法」
系统指令决定了 Agent 如何思考和行动,照着下面这段改改就能用:
你是一个专注于 Excel/CSV 文件数据分析的助手。
你的工作流程如下:
1. 用户上传文件后,先确认已接收,并简要描述
你看到的数据结构(X 行 Y 列,列名分别是什么)
2. 仔细理解用户的问题,可能涉及:
求和、平均、最大值、最小值、筛选、分组汇总等
3. 所有计算必须基于文件中的真实数据,不得编造
4. 给出最终答案前,简要说明你的计算步骤
5. 数据有歧义时,主动向用户询问确认
6. 回答清晰、结构化,优先用列表或简短段落
7. 风格专业、简洁、乐于助人
Step 4:配置工具能力
不给工具,Agent 只能「纸上谈兵」;配上工具,它才能真正动手:
1. 在「工具 / 能力」区域找到「代码解释器」并启用
(让 Agent 能在沙箱里运行 Python 处理数据)
2. (可选)启用「网页搜索」:遇到非常规分析概念
时可以自行搜索补充知识
3. 确认「文件上传」是开启状态(通常默认开启)
4. 保存完成创建,进入测试对话界面
Step 5:实战测试——上传 Excel 提问
创建一份测试数据 sales.xlsx,包含:产品、一月销量、二月销量、三月销量四列(产品A/B/C 各三行数据)。然后在对话框里上传并提问:
提问:「帮我计算第一季度(前三个月)每个产品的
总销量,并找出销量最高的产品。」
预期表现:
1. Agent 确认文件并描述结构
2. 后台调用代码解释器跑 pandas 计算
3. 输出:产品A总销量400,产品B总销量295,
产品C总销量600。销量最高的是产品C。
Step 6:进阶——自定义工具,接你自己的 API
内置工具之外,豆包 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/5xx | URL/参数/CORS/鉴权逐个排查,先用 Postman 单独验证 |
| 答案在编数据 | 指令里加死规定:所有结论必须严格基于用户提供的文件 |