View a markdown version of this page

Atlassian Confluence Cloud ナレッジベース統合 - Amazon Quick
[開始する前に]認証ナレッジベース統合を設定するサポートされているコンテンツタイプアクセス制御ナレッジベースの管理トラブルシューティング

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

Atlassian Confluence Cloud ナレッジベース統合

Atlassian Confluence Cloud ナレッジベース統合を使用して Confluence コンテンツのインデックスを作成し、Amazon Quick エージェントがそれに関する質問を検索して回答できるようにします。

[開始する前に]

統合を設定する前に、以下があることを確認してください。

認証

ナレッジベースの統合の場合、Amazon Quick はセットアップ中にポップアップフローを通じて認証を処理します。以下の手順を実行します。

  1. 表示される Confluence Cloud 認証ポップアップを完了します。

  2. Amazon Quick が Confluence コンテンツにアクセスするためのアクセス許可を付与します。

  3. 認証プロセスを確認して完了します。

ナレッジベース統合を設定する

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

  2. Atlassian Confluence Cloud を選択し、追加 (プラス「＋」) ボタンを選択します。

  3. Confluence ナレッジベースの作成ダイアログの「接続されたアカウント」で、次のフィールドに入力します。

    • 名前 – データアクセス統合のわかりやすい名前。

    • Confluence URL – Atlassian サイトの URL (例: your-site.atlassian.net)。

  4. サインインを選択し、ポップアップウィンドウで Confluence Cloud 認証フローを完了します。

  5. ナレッジベースの作成で、次のフィールドに入力します。

    • 名前 – ナレッジベースの名前。

    • 説明 (オプション) – ナレッジベースの使用方法に関する注意事項。

  6. コンテンツで、含める Confluence スペース、ブログ、またはページの URLs を貼り付けます。各 URL の後に追加を選択します。

    注記

    構造に従う URLshttps://company.atlassian.net/wiki/spaces/space-key/overviewは、ページ URLs。

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

サポートされているコンテンツタイプ

  • Confluence のページとブログ記事

  • Spaces コンテンツ

  • ページとブログの添付ファイル

アクセス制御

重要

Amazon Quick は、データソースからのアクセスコントロールリスト (ACLs同期しません。Amazon Quick でナレッジベースを作成する場合、デフォルトでは、ナレッジベースからインサイトを取得できるのは自分だけです。共有コンテンツの場合、ナレッジベースのアクセス許可を更新することで、さまざまなユーザーとグループへのアクセスを提供できます。

ナレッジベースの管理

既存のナレッジベースを編集する

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

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

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

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

トラブルシューティング

統合を編集、共有、または削除するには、「」を参照してください既存の統合の管理。

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

ブロックされた OAuth アプリ認可

症状:

  • エラーメッセージ：「アプリがアカウントにアクセスする前に、サイト管理者がサイト instance-name.atlassian.net に対してこのアプリを承認する必要があります。」

  • 同意ダイアログで Accept をクリックしても効果はありません。

原因:

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

解決の手順:

この問題を解決するには、次のいずれかのオプションを使用します。

  • オプション 1 (推奨): 管理者がアプリを直接承認する

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

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

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

    管理者がアプリを承認すると、サイト上の他のすべてのユーザーが問題なく接続できます。

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

重要

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

注記

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

認証ポップアップが失敗する

症状:

  • 認証ポップアップはすぐには表示または閉じません。

  • ポップアップが表示されますが、OAuth フローを完了できません。

解決の手順:

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

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

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

ナレッジベースにコンテンツがない

症状:

  • ナレッジベースの同期は完了しますが、予想されるコンテンツのインデックスは作成されません。

  • 検索結果には、特定のスペースやページからのコンテンツは含まれません。

  • スペース全体でインデックスが作成されるドキュメントは 1 つだけです。

解決の手順:

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

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

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

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