> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Harvest

> Harvest 可帮助团队和自由职业者通过你已连接的账户跟踪时间、管理项目并处理开票。

# Harvest

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

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Harvest 账户。 |
| Action | 是 | 要执行的 Harvest 操作（例如 Create Client、Get Client、Update Client、Create Project）。 |
| Arguments | 是 | 根据操作的 schema 生成的每个操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于插入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制此步骤失败时工作流应**Terminate Workflow**还是**Continue**。 |

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

## Arguments form

当你选择一个操作时，**Arguments** 部分会根据该操作的输入 schema 呈现一个表单。引用现有记录的字段会包含下拉选择器。

当你更希望手动编写完整的 arguments 对象时，可以切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## Common actions

| Action | Description |
| - | - |
| **Create Client** | 创建一个新客户。 |
| **Get Client** | 按 ID 检索客户。 |
| **Update Client** | 更新现有客户。 |
| **Create Project** | 创建一个新项目。 |
| **Get Project** | 按 ID 检索项目。 |
| **Update Project** | 更新现有项目。 |
| **Create Task** | 创建一个新任务。 |
| **Get Task** | 按 ID 检索任务。 |
| **Update Task** | 更新现有任务。 |
| **Create Time Entry** | 创建一个新的工时记录。 |
| **Get Time Entry** | 按 ID 检索工时记录。 |
| **Update Time Entry** | 更新现有工时记录。 |
| **Create Invoice** | 创建一张新发票。 |
| **Get Invoice** | 按 ID 检索发票。 |
| **Update Invoice** | 更新现有发票。 |

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

## 输出

此步骤会将 Harvest 响应存储为步骤输出。响应的结构取决于操作。

在后续步骤中使用完整输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

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](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.