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

# Miro

> 通过已连接账户进行头脑风暴、线框设计、规划和可视化项目工作的协作式在线白板。

# Miro

当你需要在白板上创建、查看或更新工作时使用此应用。它适合头脑风暴、规划和可视化任务映射。

## 配置

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

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

## Arguments form

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

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

## Common actions

| 操作 | 说明 |
| - | - |
| **List boards** | 检索你可以访问的看板。 |
| **Create board** | 创建一个新看板。 |
| **Get board** | 检索特定看板的详细信息。 |
| **List board items** | 列出看板上的项目。 |
| **Get item** | 检索看板上的特定项目。 |
| **Create sticky note** | 在看板上创建便签。 |
| **Update sticky note** | 更新看板上的便签。 |
| **Create text item** | 在看板上创建文本项。 |
| **Create card** | 在看板上创建卡片。 |
| **Create connector** | 在两个看板项目之间创建连接线。 |
| **Get connector** | 从看板中检索连接线。 |
| **Update connector** | 更新看板上现有的连接线。 |
| **List tags** | 列出看板上的所有标签。 |

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

## 输出

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

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

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

## 示例

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

## 使用场景

### 启动规划看板

1. Create board
2. Create sticky note
3. Create text item
4. Create connector

### 查看看板内容

1. List boards
2. Get board
3. List board items
4. Get item

### 组织带标签的工作

1. List tags
2. Create tag
3. Attach tag
4. List item tags

## 注意事项

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

## 将 Miro 用作代理工具

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

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