---
title: Confluence
description: Confluenceとの連携
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="confluence"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
[Confluence](https://www.atlassian.com/software/confluence)はAtlassianの強力なチームコラボレーションおよびナレッジマネジメントプラットフォームです。部門や組織全体で情報を作成、整理、共有するための集中型ワークスペースとして機能します。

Confluenceでは以下のことが可能です：

- **構造化されたドキュメントの作成**: リッチフォーマットを使用した包括的なウィキ、プロジェクト計画、ナレッジベースの構築
- **リアルタイムでのコラボレーション**: コメント、メンション、編集機能を使用してチームメイトとドキュメント上で共同作業
- **階層的な情報整理**: 直感的なナビゲーションのためのスペース、ページ、ネストされた階層によるコンテンツの構造化
- **他のツールとの統合**: シームレスなワークフロー統合のためのJira、Trelloなどの他のAtlassian製品との連携
- **アクセス権限の管理**: 特定のコンテンツを閲覧、編集、コメントできるユーザーの管理

Simでは、Confluence統合により、エージェントが組織のナレッジベースにアクセスして活用することができます。エージェントはConfluenceページから情報を取得し、特定のコンテンツを検索し、必要に応じてドキュメントを更新することもできます。これにより、ワークフローに社内ドキュメントを参照し、確立された手順に従い、最新の情報リソースを維持するエージェントを構築することが可能になります。
{/* MANUAL-CONTENT-END */}

## 使用手順

Confluenceをワークフローに統合します。ページの読み取り、作成、更新、削除、コメント管理、添付ファイル管理、ラベル管理、コンテンツ検索が可能です。

## ツール

### `confluence_retrieve`

Confluence APIを使用してConfluenceページからコンテンツを取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `pageId` | string | はい | 取得するConfluenceページID |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 取得のタイムスタンプ |
| `pageId` | string | ConfluenceページID |
| `content` | string | HTMLタグが削除されたページコンテンツ |
| `title` | string | ページタイトル |

### `confluence_update`

Confluence APIを使用してConfluenceページを更新します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `pageId` | string | はい | 更新するConfluenceページID |
| `title` | string | いいえ | ページの新しいタイトル |
| `content` | string | いいえ | Confluenceストレージ形式での新しいページコンテンツ |
| `version` | number | いいえ | ページのバージョン番号（競合防止のために必要） |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 更新のタイムスタンプ |
| `pageId` | string | Confluenceページ ID |
| `title` | string | 更新されたページタイトル |
| `success` | boolean | 更新操作の成功ステータス |

### `confluence_create_page`

Confluenceスペースに新しいページを作成します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `spaceId` | string | はい | ページが作成されるConfluenceスペースID |
| `title` | string | はい | 新しいページのタイトル |
| `content` | string | はい | Confluenceストレージ形式（HTML）のページコンテンツ |
| `parentId` | string | いいえ | 子ページを作成する場合の親ページID |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 作成のタイムスタンプ |
| `pageId` | string | 作成されたページID |
| `title` | string | ページタイトル |
| `url` | string | ページURL |

### `confluence_delete_page`

Confluenceページを削除します（復元可能なゴミ箱に移動します）。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `pageId` | string | はい | 削除するConfluenceページID |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 削除のタイムスタンプ |
| `pageId` | string | 削除されたページID |
| `deleted` | boolean | 削除ステータス |

### `confluence_search`

Confluenceのページ、ブログ投稿、その他のコンテンツ全体を検索します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `query` | string | はい | 検索クエリ文字列 |
| `limit` | number | いいえ | 返す結果の最大数（デフォルト：25） |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 検索のタイムスタンプ |
| `results` | array | 検索結果 |

### `confluence_create_comment`

Confluenceページにコメントを追加します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `pageId` | string | はい | コメントするConfluenceページID |
| `comment` | string | はい | Confluenceストレージ形式でのコメントテキスト |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 作成のタイムスタンプ |
| `commentId` | string | 作成されたコメントID |
| `pageId` | string | ページID |

### `confluence_list_comments`

Confluenceページのすべてのコメントを一覧表示します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `pageId` | string | はい | コメントを一覧表示するConfluenceページID |
| `limit` | number | いいえ | 返すコメントの最大数（デフォルト：25） |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 取得のタイムスタンプ |
| `comments` | array | コメントのリスト |

### `confluence_update_comment`

Confluenceページの既存のコメントを更新します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `commentId` | string | はい | 更新するConfluenceコメントID |
| `comment` | string | はい | Confluenceストレージ形式での更新されたコメントテキスト |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 更新のタイムスタンプ |
| `commentId` | string | 更新されたコメントID |
| `updated` | boolean | 更新ステータス |

### `confluence_delete_comment`

Confluenceページからコメントを削除します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `commentId` | string | はい | 削除するConfluenceコメントID |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 削除のタイムスタンプ |
| `commentId` | string | 削除されたコメントID |
| `deleted` | boolean | 削除ステータス |

### `confluence_upload_attachment`

ファイルをConfluenceページに添付ファイルとしてアップロードします。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `pageId` | string | はい | ファイルを添付するConfluenceページID |
| `file` | file | はい | 添付ファイルとしてアップロードするファイル |
| `fileName` | string | いいえ | 添付ファイルのオプションのカスタムファイル名 |
| `comment` | string | いいえ | 添付ファイルに追加するオプションのコメント |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | アップロードのタイムスタンプ |
| `attachmentId` | string | アップロードされた添付ファイルID |
| `title` | string | 添付ファイル名 |
| `fileSize` | number | ファイルサイズ（バイト単位） |
| `mediaType` | string | 添付ファイルのMIMEタイプ |
| `downloadUrl` | string | 添付ファイルのダウンロードURL |
| `pageId` | string | 添付ファイルが追加されたページID |

### `confluence_list_attachments`

Confluenceページのすべての添付ファイルを一覧表示します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `pageId` | string | はい | 添付ファイルを一覧表示するConfluenceページID |
| `limit` | number | いいえ | 返す添付ファイルの最大数（デフォルト：25） |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 取得のタイムスタンプ |
| `attachments` | array | 添付ファイルのリスト |

### `confluence_delete_attachment`

Confluenceページから添付ファイルを削除します（ゴミ箱に移動します）。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `attachmentId` | string | はい | 削除するConfluence添付ファイルID |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 削除のタイムスタンプ |
| `attachmentId` | string | 削除された添付ファイルID |
| `deleted` | boolean | 削除ステータス |

### `confluence_list_labels`

Confluenceページのすべてのラベルを一覧表示します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `pageId` | string | はい | ラベルを一覧表示するConfluenceページID |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 取得のタイムスタンプ |
| `labels` | array | ラベルのリスト |

### `confluence_get_space`

特定のConfluenceスペースに関する詳細を取得します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `spaceId` | string | はい | 取得するConfluenceスペースID |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 取得のタイムスタンプ |
| `spaceId` | string | スペースID |
| `name` | string | スペース名 |
| `key` | string | スペースキー |
| `type` | string | スペースタイプ |
| `status` | string | スペースステータス |
| `url` | string | スペースURL |

### `confluence_list_spaces`

ユーザーがアクセスできるすべてのConfluenceスペースを一覧表示します。

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `domain` | string | はい | あなたのConfluenceドメイン（例：yourcompany.atlassian.net） |
| `limit` | number | いいえ | 返すスペースの最大数（デフォルト：25） |
| `cloudId` | string | いいえ | インスタンスのConfluence Cloud ID。提供されない場合、ドメインを使用して取得されます。 |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `ts` | string | 取得のタイムスタンプ |
| `spaces` | array | スペースのリスト |

## 注意事項

- カテゴリー: `tools`
- タイプ: `confluence`
