翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Atlassian Confluence Cloud ナレッジベースの統合
<a name="confluence-knowledge-base"></a>

Atlassian Confluence Cloud ナレッジベース統合を使用して Confluence コンテンツのインデックスを作成し、Amazon Quick エージェントがそれに関する質問を検索して回答できるようにします。Amazon Quick は、Confluence ナレッジベースのオプションのドキュメントレベルのアクセスコントロール (ACLs) をサポートしています。有効にすると、Confluence でアクセスが許可されているドキュメントからの回答のみが表示されます。詳細については、「[ドキュメントレベルのアクセスコントロール](confluence-kb-acl.md)」を参照してください。

## [開始する前に]
<a name="confluence-kb-prerequisites"></a>

統合を設定する前に、以下があることを確認してください。
+ Atlassian Confluence Cloud インスタンス。
+ クイックサブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

ドキュメントレベルのアクセスコントロールを有効にする場合は、セットアップ時に Atlassian 管理者認証情報を指定する必要があります。これらの認証情報により、Amazon Quick は個々の E メールの可視性設定に関係なく、すべてのユーザーおよびグループの情報にアクセスできます。管理者認証情報がない場合、ナレッジベースの作成中に ACL オプションを使用することはできません。管理者認証情報を提供するには、Atlassian 組織管理者からの以下が必要です。
+ **Atlassian 管理者 API キー** – Atlassian 管理者ポータルで生成された英数字の文字列。
+ **組織 ID (UUID)** – Atlassian 組織の一意の識別子。これは、 管理者ポータルにサインインすると、ブラウザ URL で確認できます`admin.atlassian.com/o/orgId`。
+ **ディレクトリ ID (UUID)** – ユーザーディレクトリの一意の識別子。Atlassian Admin Workspace API を使用してこの値を取得します。

これらの認証情報を取得する詳細な手順については、「」を参照してください[Atlassian 管理者認証情報を取得する](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)。

## ナレッジベース統合を設定する
<a name="confluence-kb-setup"></a>

セットアップウィザードには、認証、ナレッジベースの作成、追加設定の 3 つのステップがあります。

### アカウントの認証
<a name="confluence-kb-setup-auth"></a>

1. Amazon Quick コンソールで、**統合**を選択します。

1. **ナレッジ**で、**Atlassian Confluence Cloud** を選択し、追加 (プラス「＋」) ボタンを選択します。

1. **「Confluence ナレッジベースの作成**」ダイアログの**「認証方法**」で、**名前**ドロップダウンから既存の接続アカウントを選択するか、**「アカウントの追加**」を選択して新しい接続を作成します。

1. 新しいアカウントを追加する場合は、次のフィールドに入力します。
   + **名前** – 接続のわかりやすい名前。
   + **説明** (オプション) – 接続に関する注意事項。
   + **Confluence URL** – Atlassian サイトの URL (例: `https://your-site.atlassian.net`)。

1. (オプション) **ACL 管理**で、**「Atlassian 管理者認証情報を使用して** Atlassian 管理者認証情報を指定する」を選択します。選択したら、次のように入力します。
   + **API キー** – Atlassian 管理者 API キー。
   + **OrganizationID (UUID)** – アトラシアン組織 ID。
   + **ディレクトリ ID (UUID)** – Atlassian ユーザーディレクトリ ID。
**重要**  
**追加の設定**でドキュメントレベルのアクセスコントロール (ACLs) を有効にするには、アトラシアン管理者認証情報が必要です。管理者認証情報がない場合、ACL オプションは無効になります。ナレッジベースの作成後に管理者認証情報を追加することはできません。これらの認証情報を取得する手順については、「」を参照してください[Atlassian 管理者認証情報を取得する](confluence-kb-acl.md#confluence-kb-atlassian-admin-credentials)。

1. [**次へ**] を選択します。

1. 表示される Confluence Cloud 認証ポップアップを完了します。リクエストされたアクセス許可を確認し、**Accept** を選択して Amazon Quick が Confluence コンテンツにアクセスすることを許可します。

### ナレッジベースを作成する
<a name="confluence-kb-setup-create"></a>

1. **ナレッジベースの作成** に、ナレッジベース**の名前**を入力します。

1. (オプション) ナレッジベースの使用方法に関するメモを含む**説明**を入力します。

1. **Confluence URLs** で、含める Confluence スペース、ブログ、またはページの URLs を貼り付けます。各 URL の後に**追加**を選択します。
**注記**  
構造に従う URLs`https://company.atlassian.net/wiki/spaces/space-key/overview`は、スペース URLsではなくページ URL として扱われURLs。スペース全体のインデックスを作成するには、スペース URL を なしで使用します `/overview` (例: `https://company.atlassian.net/wiki/spaces/space-key`)。

1. **次へ: アクセスコントロールとインデックス作成オプションを設定する追加設定**を選択するか、**作成**を選択してデフォルト設定でナレッジベースを作成します。

### 追加設定を構成する
<a name="confluence-kb-setup-settings"></a>

1. ドキュメントレベルのアクセスコントロールを有効にするには、**ACLs を使用してドキュメントアクセスを制御する**を選択します。このオプションは、**認証方法で** Atlassian 管理者認証情報を指定した場合にのみ使用できます。有効にすると、Amazon Quick は Confluence のアクセスコントロールリストを同期し、クエリ時に各ユーザーのアクセス許可を検証します。アクセスコントロールの仕組みの詳細については、「」を参照してください[ドキュメントレベルのアクセスコントロール](confluence-kb-acl.md)。

   ACLs を有効にしない場合、アクセスはナレッジベースレベルで制御されます。ナレッジベースにアクセスできるユーザーは、ナレッジベース内のすべてのコンテンツからインサイトを得ることができます。ACLsを有効にすると、アクセスはドキュメントレベルで制御されます。ナレッジベースにアクセスできるユーザーには、Confluence でアクセスが許可されているドキュメントからの回答のみが表示されます。
**重要**  
ナレッジベースの作成後に ACL 管理を変更することはできません。この設定を変更する必要がある場合は、新しいナレッジベースを作成する必要があります。
**注記**  
**認証方法で** Atlassian 管理者認証情報を指定しなかった場合、このオプションは無効になります。ACLs を有効にするには、ウィザードを**戻る**またはキャンセルを選択し、管理者認証情報を含む接続されたアカウントで再度開始します。

1. **マルチメディアコンテンツ、ファイルサイズ、ファイルパターン**で、必要に応じて次のインデックス作成オプションを設定します。
   + **ドキュメント内のビジュアルコンテンツ** – ドキュメントに埋め込まれたイメージやグラフなどのビジュアルコンテンツをインデックス化します。
   + **オーディオファイル** – オーディオファイルの添付ファイルのインデックスを作成します。
   + **動画ファイル** – 動画ファイルの添付ファイルのインデックスを作成します。
   + **最大単一ファイルサイズ** – 個々の添付ファイルの最大ファイルサイズ (デフォルト: 50 MB)。

1. **[作成]** を選択します。

## サポートされているコンテンツタイプ
<a name="confluence-kb-content-types"></a>
+ Confluence のページとブログ記事
+ ページとブログ投稿の添付ファイル

Confluence スペース URL を追加すると、Amazon Quick はそのスペース内のすべてのページとブログ投稿をクロールします。サポートされている添付ファイルのタイプとサイズ制限については、「」を参照してください[ファイルサイズとコンテンツの制限](knowledge-base-integrations.md#file-size-and-content-limits)。

## ナレッジベースの管理
<a name="confluence-kb-management"></a>

### 既存のナレッジベースを編集する
<a name="confluence-kb-edit"></a>

1. Amazon Quick コンソールで、**ナレッジベース**を選択します。

1. リストから Confluence Cloud ナレッジベースを選択します。

1. **アクション**で 3 つのドットのアイコンを選択し、**ナレッジベースの編集**を選択します。

1. 必要に応じて設定を更新し、**保存**を選択します。

## トラブルシューティング
<a name="confluence-kb-troubleshooting"></a>

統合を編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

同期の問題やドキュメントの欠落など、一般的なナレッジベースのトラブルシューティングについては、「」を参照してください[ナレッジベースのトラブルシューティング](troubleshooting-knowledge-bases.md)。

### ブロックされた OAuth アプリ認可
<a name="confluence-kb-troubleshooting-blocked-oauth"></a>

**症状:**
+ エラーメッセージ：「アプリがアカウントにアクセスする前に、サイト管理者がサイト *instance-name*.atlassian.net に対してこのアプリを承認する必要があります。」
+ 同意ダイアログで**承諾**を選択しても効果はありません。

**原因**:

Atlassian サイト管理者が、ユーザーがインストールした OAuth アプリをブロックしました。この設定を有効にすると、サイトまたは組織の管理者のみが新しいサードパーティーアプリを承認できます。

**解決の手順:**

この問題を解決するには、次のいずれかのオプションを使用します。
+ **オプション 1 (推奨): 管理者がアプリを直接承認する**

  1. Atlassian サイト管理者は Amazon Quick に移動し、Confluence Cloud で新しいナレッジベースのセットアップを開始します。

  1. 管理者にはサイトレベルのアクセス許可があるため、クリーンな同意画面がエラーなしで表示されます。

  1. 管理者は **Accept** を選択してアプリをインストールします。

  管理者がアプリを承認すると、サイト上の他のすべてのユーザーが問題なく接続できます。
+ **オプション 2: ユーザーがインストールしたアプリを一時的に許可**する – 管理者は に移動し`admin.atlassian.com`、**アプリ**、**アトラシアンアプリ**に移動し、サードパーティーアプリと Marketplace アプリのリンクを選択します。**設定**で、**ユーザーインストールアプリを検索**し、ユーザーアプリを許可するように切り替えます。ユーザーが Amazon Quick を承認したら、設定を再び切り替えてユーザーアプリケーションをブロックします。

**重要**  
管理者認可は、組織ごとではなく、アトラシアンサイトごとに適用されます。会社に複数のサイト ( `team-a.atlassian.net`や など`team-b.atlassian.net`) がある場合は、各サイトに個別の認可が必要です。

**注記**  
ユーザーがインストールしたアプリはブロック解除されますが (オプション 2)、サイトのすべてのユーザーは任意の OAuth アプリを承認できます。ユーザーが接続した直後にブロックを再度有効にします。

### 認証ポップアップが失敗する
<a name="confluence-kb-troubleshooting-auth-popup"></a>

**症状:**
+ 認証ポップアップはすぐには表示または閉じません。
+ ポップアップが表示されますが、OAuth フローを完了できません。

**解決の手順:**

1. ブラウザで Amazon Quick コンソールドメインからのポップアップが許可されていることを確認します。

1. Confluence Cloud インスタンスがネットワークからアクセス可能であることを確認します。

1. 別のブラウザを使用するか、ブラウザキャッシュをクリアしてみてください。

### ナレッジベースにコンテンツがない
<a name="confluence-kb-troubleshooting-missing-content"></a>

**症状:**
+ ナレッジベースの同期は完了しますが、予想されるコンテンツのインデックスは作成されません。
+ 検索結果には、特定のスペースやページからのコンテンツは含まれません。
+ スペース全体でインデックスが作成されるドキュメントは 1 つだけです。

**解決の手順:**

1. 認証した Confluence Cloud ユーザーが、セットアップ時に選択したスペースとページにアクセスできることを確認します。

1. 選択したコンテンツタイプ (ページ、ブログ記事、添付ファイル) がサポートされていることを確認します。

1. ナレッジベース設定のコンテンツ選択を確認して、正しいスペースとページが含まれていることを確認します。

1. Confluence URLsサフィックスを確認します。 `/overview`で終わる URLs`/wiki/spaces/space-key/overview`は、フルスペースではなく、単一ページの URL として扱われます。スペース全体のインデックスを作成する場合は、スペース URL を なしで使用します `/overview` (例: `https://company.atlassian.net/wiki/spaces/space-key`)。

### ACL 関連の問題
<a name="confluence-kb-troubleshooting-acl"></a>

**ACL 対応ナレッジベースの結果がない**
+ 最初のクエリ中にプロンプトが表示されたら、エンドユーザーが Confluence にサインインしていることを確認します。サインインは、リアルタイムのアクセス許可の検証に必要です。
+ エンドユーザーが Confluence インスタンス内の関連する Confluence コンテンツにアクセスできることを確認します。

**同期中にスキップされたドキュメント**
+ 同期レポートにステータスが SKIPPED の項目が表示されている場合は、認証ユーザーがナレッジベースに含まれる Confluence スペースとページにアクセスできることを確認します。
+ ドキュメントアクセスの検証の詳細については、「」を参照してください[ドキュメントアクセスの確認 (ACL 検証)](sync-reports-observability.md#sync-reports-acl-verification)。