> ## 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.

# Attio

> 可自定义的工作区，可通过已连接的账户管理关系、记录和工作流。

# Attio

当你需要在工作流中创建、查找或更新 CRM 记录时，请使用 Attio。它也适用于与这些记录关联的任务、备注和会议。

## 配置

| 选项 | 是否必填 | 说明 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| 身份验证 | 是 | 此步骤要使用的已连接 Attio 账户。 |
| 操作 | 是 | 要执行的 Attio 操作（例如 Get person、Create person、Update person、Assert person）。 |
| 参数 | 是 | 根据操作的架构生成的各操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于插入 `{{placeholder}}` 值。高级用法可使用 **Raw JSON** 选项卡。 |
| 当步骤失败时 | 否 | 控制当此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

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

## 参数表单

当你选择一个操作时，**Arguments** 部分会渲染一个由该操作输入架构驱动的表单。引用现有记录的字段包含下拉选择器。

当你更愿意手动编写完整的参数对象时，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常用操作

| 操作 | 说明 |
| - | - |
| **Get person** | 按记录 ID 检索人员记录。 |
| **Create person** | 创建新的人员记录。 |
| **Update person** | 按记录 ID 更新人员记录。 |
| **Assert person** | 使用匹配属性创建或更新人员记录。 |
| **Get company** | 按记录 ID 检索公司记录。 |
| **Create company** | 创建新的公司记录。 |
| **Update company** | 按记录 ID 更新公司记录。 |
| **Assert company** | 使用匹配属性创建或更新公司记录。 |
| **Get deal** | 按记录 ID 检索交易记录。 |
| **Create deal** | 创建新的交易记录。 |
| **Update deal** | 按记录 ID 更新交易记录。 |
| **Get task** | 按任务 ID 检索任务。 |
| **Create task** | 创建新任务。 |
| **Update task** | 按任务 ID 更新现有任务。 |
| **Get note** | 按备注 ID 检索备注。 |

删除记录等破坏性操作在工作流操作选择器中不可用。

## 输出

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

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

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

## 示例

1. 打开 **Integrations**，如果你还没有连接过 Attio，就先连接它。
2. 在工作流中添加一个 **Attio** 步骤。
3. 在 **Authentication** 中选择一个已连接的账户。
4. 在 **Action** 中选择 **Get person**。
5. 填写所需字段。对任意字段值，使用 **Insert Variable** 引用前一步的输出。
6. 点击步骤标题栏中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的有效载荷。

## 使用场景

### 从表单数据创建人员

1. Assert person
2. Get person
3. Create note

### 在收到回复后更新交易

1. Get deal
2. Update deal
3. Create task

### 记录会议并跟进

1. Create meeting
2. Create note
3. Create task

## 注释

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

## 将 Attio 作为代理工具使用

你也可以在 **Agent Editor** 中将 Attio 添加为工具。打开代理，点击 **Add tool**，然后选择 **Attio**。在工具设置面板中，选择该代理应使用的已连接账户。代理会在相关于对话时调用 Attio 操作。

另请参阅：[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.