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