跑通第一个任务
目标:让 Agent 在一个文件夹里完成一件小事,然后用一次插件。
开始前:已经配置好模型,Pi 显示 可以派活(见配置模型和 Agent 底座)。
1. 准备文件夹
新建一个空文件夹用来测试,例如 ~/soduwork-test,在里面放一个小的 CSV 文件,命名为 data.csv。请使用编造的数据。
2. 设置对话
在客户端主页,检查输入框下方的几个选项:
| 选项 | 设置为 |
|---|---|
| 本机 / 云端(电脑图标) | 本机:在这台电脑上执行 |
| 工作位置 | 选 选择现有文件夹,选中你刚建的文件夹,Agent 会在这里读写文件。选 默认工作区 则为这个对话单独建一个文件夹 |
| 权限 | 默认权限:常规操作自动执行,敏感操作先询问。只读只读取不修改;完全访问还可以写文件、运行命令、访问网络 |
| 模型 | 你配置的模型 |
| 底座 | Pi |

之后可以在同一个对话里更换模型和底座,对话记录和文件夹都会保留。
3. 发送请求
在当前文件夹写一个 Python 脚本,读取 data.csv,统计每一列的空值数量,结果输出成 Markdown 表格,然后运行它。
Agent 工作时,对话里会显示它读了哪些文件、执行了什么命令、改了哪些文件。遇到敏感操作会先询问你。
完成后,新文件会出现在回复里,点文件名可以打开。想修改,直接在同一个对话里回复。
4. 使用插件
插件把一套做法打包起来,让 Agent 每次都按同样的步骤完成。
-
在输入框里输入
/,会弹出插件列表,继续输入可以筛选。 -
选择 插件开发助手(Plugin Developer)。
-
发送:
把刚才的 CSV 检查做成一个插件:输入一个 CSV 文件,按列报告空值数量。
插件会引导 Agent 生成一份插件草稿,你可以检查它、安装到本机并运行。你做的插件保存在本机,只有你主动上传,才会进入组织。
想浏览全部插件,打开左侧的 插件。
5. 可选:在云端运行
如果你的组织配置了云端执行机,发送前点电脑图标,切换到 云端。工作会在那台服务器上执行,运行期间可以关闭客户端。见一次云端执行的过程。
确认运行成功
- 回复里列出了新脚本,文件夹里也有这个文件。
- 在管理端 用量与成本(Usage and cost) 里能看到你所用模型的请求记录。
下一步
- 编写自己的插件:插件概览
- 试试其他底座:Agent 底座
- 给团队部署:用 Docker 自部署