跳转到主要内容

Harvest

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

配置

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

Arguments form

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

Common actions

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

输出

此步骤会将 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