> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# Confluence 連携

> Confluence をナレッジソースとして接続し、AI エージェントが Confluence のページを検索・参照できるようにする手順

Confluence をナレッジソースとして接続すると、AI エージェントが問い合わせへの回答時に Confluence のページを検索・参照できるようになります。

## 接続方式

Confluence 連携では 2 つの接続方式を選択できます。

| 方式                     | 説明                                         | こんな場合に                                                        |
| ---------------------- | ------------------------------------------ | ------------------------------------------------------------- |
| **Confluence（OAuth）**  | Atlassian OAuth でワークスペースを接続する方式            | Confluence Cloud をすぐに連携したい                                    |
| **Confluence（API キー）** | Confluence ベース URL・メール・API トークンを入力して接続する方式 | Confluence Server / Data Center を使用している、または API トークンで細かく制御したい |

<Note>
  どちらの方式でも、接続後は AI エージェントが Confluence を検索できるようになります。
</Note>

## 前提条件

<Info>
  * AI Helpdesk の **管理者（Admin）** ロールが必要です
  * **Confluence（OAuth）** の場合: Confluence Cloud の管理者権限が必要です
  * **Confluence（API キー）** の場合: Confluence の API トークン発行権限が必要です（[Atlassian アカウント設定](https://id.atlassian.com/manage-profile/security/api-tokens) で発行）
</Info>

## Confluence（OAuth）で接続する

Atlassian OAuth を使って Confluence Cloud ワークスペースを接続する方式です。

<Steps>
  <Step title="ナレッジ連携設定を開く">
    左のナビゲーションから **設定** を選択し、**連携** タブを開きます。
    **ナレッジ連携** セクションの **連携を追加** ボタンをクリックし、**Confluence（OAuth）** を選択します。
  </Step>

  <Step title="Atlassian で認証する">
    Atlassian の OAuth 認証ページにリダイレクトされます。
    Atlassian アカウントでログインし、AI Helpdesk へのアクセスを許可します。
  </Step>

  <Step title="接続完了を確認する">
    認証が成功すると、**ナレッジ連携** セクションに接続済みの Confluence（OAuth）カードが表示されます。
    カードのステータスが **接続済み** になっていることを確認してください。
  </Step>
</Steps>

### クロール対象を絞り込む（任意）

デフォルトではすべてのスペース・ページ・ブログがクロール対象になります。特定のエンティティのみを対象にする場合は、以下を設定します。

1. 接続済みカードの **設定（歯車アイコン）** をクリックします
2. **エンティティURL** フィールドに、対象にしたいスペース・ページ・ブログの URL を 1 行 1 件で入力します（最大 100 件）
3. **クロール対象のオブジェクトタイプ**（Space / Page / BlogPost / Attachment / Comment）から、インデックス化するコンテンツ種別を 1 つ以上選択します
4. **保存** をクリックします

## Confluence（API キー）で接続する

Confluence のベース URL・メールアドレス・API トークンを入力して接続する方式です。

### 接続に必要な情報

| 項目                     | 説明                         | 例                                        |
| ---------------------- | -------------------------- | ---------------------------------------- |
| **Confluence ベース URL** | Confluence インスタンスの URL     | `https://yourcompany.atlassian.net/wiki` |
| **メールアドレス**            | API トークンを発行したアカウントのメール     | `bot@example.com`                        |
| **API トークン**           | Atlassian アカウント設定で発行したトークン | —                                        |

<Steps>
  <Step title="ナレッジ連携設定を開く">
    左のナビゲーションから **設定** を選択し、**連携** タブを開きます。
    **ナレッジ連携** セクションの **連携を追加** ボタンをクリックし、**Confluence（API キー）** を選択します。
  </Step>

  <Step title="API トークンを取得する">
    [Atlassian アカウントのセキュリティ設定](https://id.atlassian.com/manage-profile/security/api-tokens) を開き、**API トークンを作成** をクリックします。
    生成されたトークンをコピーします。

    <Note>
      API トークンは生成直後にしか確認できません。コピーし忘れた場合は再生成してください。
    </Note>
  </Step>

  <Step title="接続情報を入力する">
    接続フォームに **Confluence ベース URL**・**メールアドレス**・**API トークン** を入力します。

    入力が完了したら **保存** をクリックします。接続テストが自動で実行されます。
  </Step>

  <Step title="接続完了を確認する">
    接続テストが成功すると、**ナレッジ連携** セクションに接続済みカードが表示されます。
    ステータスが **接続済み** になっていることを確認してください。

    <Warning>
      ステータスが **エラー** の場合は、URL・メールアドレス・API トークンを確認してください。
    </Warning>
  </Step>
</Steps>

### クロール対象を絞り込む（任意）

接続後、デフォルトではすべてのスペース・ページ・ブログがクロール対象になります。特定のエンティティのみを対象にする場合は、以下を設定します。

1. 接続済みカードの **設定（歯車アイコン）** をクリックします
2. **エンティティURL** フィールドに、対象にしたいスペース・ページ・ブログの URL を 1 行 1 件で入力します（最大 100 件）
3. **クロール対象のオブジェクトタイプ**（Space / Page / BlogPost / Attachment / Comment）から、インデックス化するコンテンツ種別を 1 つ以上選択します
4. **保存** をクリックします

## AI エージェントでの利用

Confluence を接続すると、AI エージェントがナレッジ検索時に自動的に Confluence を検索対象に含めます。

プレイブックのステップで明示的に参照する場合は、`{{document_search}}` ツールを使用します。

```markdown theme={null}
### Step 2: 社内ドキュメントを検索する

{{document_search}} で関連手順を検索する。
Confluence の IT スペースも検索対象に含めてください。
```

## 連携を切断する

<Steps>
  <Step title="ナレッジ連携設定を開く">
    **設定** > **連携** タブの **ナレッジ連携** セクションを開きます。
  </Step>

  <Step title="切断する">
    切断する Confluence カードのゴミ箱アイコンをクリックします。
    確認ダイアログで **削除** をクリックしてください。

    <Warning>
      切断すると、AI エージェントは Confluence を参照しなくなります。
    </Warning>
  </Step>
</Steps>

## トラブルシューティング

**ステータスが「エラー」のままになる**

* Confluence（OAuth）の場合: **再接続** ボタンをクリックして OAuth フローを再実行してください
* Confluence（API キー）の場合: API トークンの有効期限切れや失効の可能性があります。Atlassian アカウント設定で新しいトークンを発行し、設定を更新してください

**特定のページが検索結果に出てこない**

エンティティURL が設定されている場合、そのスペース・ページ・ブログのみが検索対象です。エンティティURL の設定を確認し、対象の URL が正しく含まれているか確認してください。

## 関連ページ

* [連携の概要](/ai-helpdesk/integrations/index)
* [ナレッジを追加する](/ai-helpdesk/knowledge/adding)
* [プレイブックを登録する](/ai-helpdesk/playbooks/creating)