02 快速上手：搭建你的第一个数字员工

本篇目标：30 分钟走完最小闭环。体验"对悟帆说一句话，它就帮你操作简道云"。

前置：已读完「01-认识悟帆」，手边有简道云企业版 + 悟帆账号。

选一个够简单的起步场景

我们不贪多。第一个数字员工只做一件事：你说"帮我查一下XX客户的订单"，它就去简道云里查出来并回复你。

这个场景的好处很直接——你不用打开简道云、不用在表格里筛来筛去、不用点来点去。一句话的事。

在正式开始之前，确认你的简道云里有一张有数据的表单——「客户订单表」「员工信息表」「报销记录表」，哪张都行，有数据就行。

第一步：登录悟帆，让你的悟帆获得连接简道云的能力与钥匙

打开悟帆后（https://wufanai.com/），你会看到一个对话界面。这就是你和数字员工交互的主界面。

在左上角找到“探索”，在“工具” 分区中找到 简道云API 工具包点击安装，这样悟帆就具备了连接简道云的能力

然后还需要给你的悟帆一把钥匙——简道云的API KEY（如何获取简道云API KEY：API文档 - 简道云 - 开放平台）

在悟帆对话框里输入：

你："帮我配置简道云连接器，我的API KEY是：{复制你的API KEY}"

这样悟帆就拥有了连接简道云的 能力 跟 钥匙

第二步：让悟帆认识你的简道云

悟帆需要知道你的简道云"地址"。你需要提供两个信息：

在悟帆对话框里输入：

你："我的简道云应用 ID 是 65151c88461026e98da31d0b，里面有一张表单叫'客户'。你能读取这张表的结构吗？"

悟帆收到后，会调用简道云的 API 去查询表单包含哪些字段（字段名、字段类型）。它会回复类似：

悟帆："已读取'客户'的结构，包含以下字段：客户编码（流水号）、客户名称（单行文本）、客户分类（下拉框）、客户分类（下拉框）……"

这个回复说明悟帆已经连上了你的简道云。如果这一步没成，通常就两个原因：应用 ID 填错了，或者你的简道云版本不支持 API——升级到企业版就行。

第三步：第一次查询

现在让悟帆真的帮你查点东西。在对话框里输入：

你："帮我查一下'销售订单'里，客户名称是'无锡简道云'的所有订单。"

悟帆会调用简道云的数据查询接口，筛选客户名称为"无锡简道云"的记录，然后回复你类似：

悟帆："查询到 3 条无锡简道云的订单：

订单编号 ORD-2026-001，金额 12,800 元，下单日期 2026-03-15，状态：已完成

订单编号 ORD-2026-042，金额 3,500 元，下单日期 2026-04-02，状态：待发货

订单编号 ORD-2026-089，金额 28,000 元，下单日期 2026-05-10，状态：待审核"

到这一步，你已经跑通了最关键的一条链路：发指令 → 悟帆理解 → 调简道云 API → 返回结果。

如果跑到了这一步还没问题，你的数字员工已经在干活了。

第四步：试试写一条数据

光查不够，试试让悟帆帮你写一条数据进去。输入：

你："帮我在'客户'里新增一条记录：客户名称'李四'，客户分类'潜在客户'，客户标签'KA'。"

悟帆会调用数据创建接口，把这条记录写入简道云，然后回复：

悟帆："已写入。新增订单：ORD-2026-125，客户名称'李四'，客户分类'潜在客户'，客户标签'KA'。"

  

你现在打开简道云，刷新「客户」，会看到这条新记录确实出现了。这就是数字员工帮你"动手操作"的结果。

第五步：让查询变得更自然

上一步你的指令已经相当具体了（"客户名称是张三"）。现在试试更模糊的表达：

你："近五年有哪些大额订单？金额超过 5 万的。"

 

悟帆会自己理解你的意思——"近五年"是哪个日期范围、"大额"是多大的金额——然后去查。跟固定报表查询不同，你不需要把每个条件都写死，它能处理模糊的说法。

第六步：记录你的数字员工

你已经有一个基本可用的数字员工了。接下来把它"存"起来——下次你或同事可以直接用，不用再教悟帆认识表单。

在对话框里输入：

你："帮我记住这个场景：以后当我说'查订单'时，你就默认查询'销售订单'。查询时优先展示金额最高的订单。"

悟帆会把这个规则记入长期记忆。下次你只要说"查一下李四的订单"，悟帆就知道去查哪张表、优先展示什么。

如果卡住了

以下是最常见的问题和解决方式：

问题一：悟帆说"无法连接简道云"

检查三件事：

问题二：查询结果为空，但你知道数据存在

检查悟帆返回的字段名是否正确。有时表单字段的实际 ID（如 _widget_1667454111796）和你看到的字段标题（如"客户名称"）不一致。这时可以让悟帆先显示所有字段 ID，再用精确字段查询。

问题三：悟帆写入了数据，但某些字段是空的

这是简道云 API 的数据格式问题——某些字段需要用 {"value": "..."} 的格式包装。如果遇到这种情况，告诉悟帆：

"写入的数据字段都是空的，请注意写入时注意使用简道云 API 的正确格式"

你刚刚完成了什么

回顾一下，你在 30 分钟内做到了：

你的第一个数字员工已经能干活了。觉得顺手的话，下一步打开 「场景实战：三大典型数字员工搭建详解」，照着教程把完整的企业场景搭出来。

如果还不太熟，回到第二步重新走一遍——换一张你更熟的表单，多练两遍就顺了。