接続方式
Confluence 連携では 2 つの接続方式を選択できます。どちらの方式でも、接続後は AI エージェントが Confluence を検索できるようになります。
前提条件
- AIヘルプデスクの 管理者（Admin） ロールが必要です
- Confluence（OAuth） の場合: Confluence Cloud の管理者権限が必要です
- Confluence（API キー） の場合: Confluence の API トークン発行権限が必要です（Atlassian アカウント設定 で発行）
Confluence（OAuth）で接続する
Atlassian OAuth を使って Confluence Cloud ワークスペースを接続する方式です。1
ナレッジ連携設定を開く
左のナビゲーションから 設定 を選択し、連携 タブを開きます。
ナレッジ連携 セクションの 連携を追加 ボタンをクリックし、Confluence（OAuth） を選択します。
2
Atlassian で認証する
Atlassian の OAuth 認証ページにリダイレクトされます。
Atlassian アカウントでログインし、AIヘルプデスクへのアクセスを許可します。
3
接続完了を確認する
認証が成功すると、ナレッジ連携 セクションに接続済みの Confluence（OAuth）カードが表示されます。
カードのステータスが 接続済み になっていることを確認してください。
クロール対象を絞り込む（任意）
デフォルトではすべてのスペース・ページ・ブログがクロール対象になります。特定のエンティティのみを対象にする場合は、以下を設定します。- 接続済みカードの 設定（歯車アイコン） をクリックします
- エンティティURL フィールドに、対象にしたいスペース・ページ・ブログの URL を 1 行 1 件で入力します（最大 100 件）
- クロール対象のオブジェクトタイプ（Space / Page / BlogPost / Attachment / Comment）から、インデックス化するコンテンツ種別を 1 つ以上選択します
- 保存 をクリックします
Confluence（API キー）で接続する
Confluence のベース URL・メールアドレス・API トークンを入力して接続する方式です。接続に必要な情報
1
ナレッジ連携設定を開く
左のナビゲーションから 設定 を選択し、連携 タブを開きます。
ナレッジ連携 セクションの 連携を追加 ボタンをクリックし、Confluence（API キー） を選択します。
2
API トークンを取得する
Atlassian アカウントのセキュリティ設定 を開き、API トークンを作成 をクリックします。
生成されたトークンをコピーします。
API トークンは生成直後にしか確認できません。コピーし忘れた場合は再生成してください。
3
接続情報を入力する
接続フォームに Confluence ベース URL・メールアドレス・API トークン を入力します。入力が完了したら 保存 をクリックします。接続テストが自動で実行されます。
4
接続完了を確認する
接続テストが成功すると、ナレッジ連携 セクションに接続済みカードが表示されます。
ステータスが 接続済み になっていることを確認してください。
クロール対象を絞り込む（任意）
接続後、デフォルトではすべてのスペース・ページ・ブログがクロール対象になります。特定のエンティティのみを対象にする場合は、以下を設定します。- 接続済みカードの 設定（歯車アイコン） をクリックします
- エンティティURL フィールドに、対象にしたいスペース・ページ・ブログの URL を 1 行 1 件で入力します（最大 100 件）
- クロール対象のオブジェクトタイプ（Space / Page / BlogPost / Attachment / Comment）から、インデックス化するコンテンツ種別を 1 つ以上選択します
- 保存 をクリックします
AI エージェントでの利用
Confluence を接続すると、AI エージェントがナレッジ検索時に自動的に Confluence を検索対象に含めます。 プレイブックのステップで明示的に参照する場合は、{{document_search}} ツールを使用します。
連携を切断する
1
ナレッジ連携設定を開く
設定 > 連携 タブの ナレッジ連携 セクションを開きます。
2
切断する
切断する Confluence カードのゴミ箱アイコンをクリックします。
確認ダイアログで 削除 をクリックしてください。
トラブルシューティング
ステータスが「エラー」のままになる- Confluence（OAuth）の場合: 再接続 ボタンをクリックして OAuth フローを再実行してください
- Confluence（API キー）の場合: API トークンの有効期限切れや失効の可能性があります。Atlassian アカウント設定で新しいトークンを発行し、設定を更新してください