跳到主要内容

跑通第一个任务

目标:让 Agent 在一个文件夹里完成一件小事,然后用一次插件。

开始前:已经配置好模型,Pi 显示 可以派活(见配置模型和 Agent 底座)。

1. 准备文件夹​

新建一个空文件夹用来测试,例如 ~/soduwork-test,在里面放一个小的 CSV 文件,命名为 data.csv。请使用编造的数据。

2. 设置对话​

在客户端主页,检查输入框下方的几个选项:

选项设置为
本机 / 云端(电脑图标)本机:在这台电脑上执行
工作位置选 选择现有文件夹,选中你刚建的文件夹,Agent 会在这里读写文件。选 默认工作区 则为这个对话单独建一个文件夹
权限默认权限:常规操作自动执行,敏感操作先询问。​只读只读取不修改;​完全访问还可以写文件、运行命令、访问网络
模型你配置的模型
底座Pi

选择执行底座

之后可以在同一个对话里更换模型和底座,对话记录和文件夹都会保留。

3. 发送请求​

在当前文件夹写一个 Python 脚本,读取 data.csv,统计每一列的空值数量,结果输出成 Markdown 表格,然后运行它。

Agent 工作时,对话里会显示它读了哪些文件、执行了什么命令、改了哪些文件。遇到敏感操作会先询问你。

完成后,新文件会出现在回复里,点文件名可以打开。想修改,直接在同一个对话里回复。

4. 使用插件​

插件把一套做法打包起来,让 Agent 每次都按同样的步骤完成。

  1. 在输入框里输入 /,会弹出插件列表,继续输入可以筛选。

  2. 选择 插件开发助手(Plugin Developer)。

  3. 发送:

    把刚才的 CSV 检查做成一个插件:输入一个 CSV 文件,按列报告空值数量。

插件会引导 Agent 生成一份插件草稿,你可以检查它、安装到本机并运行。你做的插件保存在本机,只有你主动上传,才会进入组织。

想浏览全部插件,打开左侧的 插件。

5. 可选:在云端运行​

如果你的组织配置了云端执行机,发送前点电脑图标,切换到 云端。工作会在那台服务器上执行,运行期间可以关闭客户端。见一次云端执行的过程。

确认运行成功​

  • 回复里列出了新脚本,文件夹里也有这个文件。
  • 在管理端 用量与成本(Usage and cost) 里能看到你所用模型的请求记录。

下一步​

harness harnesses runtime runtimes 底座
编辑此页