跳转到主要内容

Harvest

当你需要在工作流中管理已跟踪的工作、计费或客户记录时,可以使用 Harvest。你可以创建、查找并更新核心记录,例如客户、项目、任务、时间条目和发票。

配置

在你配置此步骤之前,请先在工作区的 Integrations 中通过登录流程连接 Harvest。如果没有可用的活动连接,步骤会显示一个警告,并带有指向 Integrations 的链接,而不是账户选择器。

参数表单

当你选择某个操作时,Arguments 部分会呈现一个由该操作输入 schema 驱动的表单。引用现有记录的字段包括下拉选择器。 当你更希望手动编写完整的参数对象时,请切换到 Raw JSON 选项卡。任一选项卡中的更改都会保持同步。

常用操作

诸如删除记录之类的破坏性操作在工作流操作选择器中不可用。

输出

此步骤会将 Harvest 响应存储为步骤输出。响应的结构取决于所选操作。 在后续步骤中使用完整的输出引用:

示例

  1. 打开 Integrations,如果你还没有这样做过,就先连接 Harvest。
  2. 将一个 Harvest 步骤添加到你的工作流中。
  3. 在 Authentication 中选择一个已连接的账户。
  4. 在 Action 中选择 Create Client。
  5. 填写必填字段。对任何字段值,使用 Insert Variable 引用前一步的输出。
  6. 点击步骤标题栏中的 Run 来测试该操作,然后在 Output 中查看返回的有效载荷。

使用场景

记录可计费工作

  1. Get Project
  2. Get Task
  3. Create Time Entry

创建客户项目

  1. Create Client
  2. Create Project
  3. Update Project

起草发票

  1. Get Client
  2. Create Invoice
  3. Update Invoice

备注

  • 此步骤依赖于你工作区中已连接的 Harvest 集成。
  • 工作流操作选择器会显示一组精选操作。拥有 Harvest 工具的智能体可以使用更多操作。
  • 登录界面可能会显示第三方授权品牌标识。

将 Harvest 作为智能体工具使用

你也可以在 Agent Editor 中将 Harvest 添加为工具。打开该智能体,点击 Add tool,然后选择 Harvest。在工具设置面板中,选择智能体应使用的已连接账户。当相关于对话时,智能体会调用 Harvest 操作。 另请参阅:Integrations、Creating and Editing 和 Testing and Iteration