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

# Confluence

> 通过已连接的账户管理 Confluence 的空间、页面、博客文章、标签、属性和任务。

# Confluence

当你的工作流程需要创建或更新页面、博客文章、空间、标签、属性或任务时，请使用 Confluence。它在你需要先搜索或获取现有内容再执行操作时也很适合。

## 配置

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

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

## Arguments form

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

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

## Common actions

| Action | 描述 |
| - | - |
| **Get current user** | 返回已连接的 Confluence 用户和账户详情。 |
| **List spaces** | 列出已连接用户可见的空间。 |
| **Get space** | 根据空间 ID 获取其详情。 |
| **Search spaces** | 按名称、键、类型、状态或标签搜索空间。 |
| **Create space** | 使用键和名称创建新空间。 |
| **Create private space** | 使用键和名称创建私人空间。 |
| **List pages** | 列出 Confluence 中的页面。 |
| **Get page** | 根据页面 ID 获取页面。 |
| **Search pages** | 按标题、空间或状态搜索页面。 |
| **Create page** | 在某个空间中创建新页面。 |
| **Update page** | 更新现有页面标题或正文。 |
| **List child pages** | 列出某个页面的直接子页面。 |
| **List page versions** | 列出页面的所有版本。 |
| **Get page labels** | 获取应用到某个页面的标签。 |
| **Add content label** | 向某段内容添加标签。 |

诸如删除记录之类的破坏性操作，不会出现在工作流程操作选择器中。

## 输出

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

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

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

## 示例

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

## 用例

### 创建项目页面

1. List spaces
2. Get space
3. Create page

### 更新跟踪的任务

1. List tasks
2. Update task

### 使用标签整理内容

1. Search pages
2. Get page labels
3. Add content label

## 注意事项

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

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

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

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