コンテンツ AI ソースの設定と管理
このガイドでは、Cloud Managerでコンテンツ AI ソースを設定する方法(前提条件の確認から、コンテンツソースの作成、インデックス作成、使用可能な状態の確認まで)について説明します。
前提条件 prerequisites
開始する前に、次の条件が満たされていることを確認してください。
- 1つ以上のAEM as a Cloud Service環境を持つアクティブなCloud Manager プログラムがあります。
- お客様のユーザーは、ターゲット環境の AEM Users 製品プロファイルに割り当てられ、ユーザーはコンテンツソースを表示できます。
- お客様のユーザーは、ターゲット環境の AEM Administrators 製品プロファイルに割り当てられます。これにより、ユーザーはコンテンツ ソースを作成および編集できます。 Cloud Managerへのアクセスだけでは不十分です。以下の「AEM製品プロファイルへのユーザーの割り当て」を参照してください。
- 環境製品プロファイルが Adobe Admin Console でプロビジョニングされました。
AEM製品プロファイルへのユーザーの割り当て assign-product-profile
特定の環境に対するAdobe Experience Manager as a Cloud Serviceへのアクセス権をユーザーに付与するには、次の手順を実行します。 ユーザーが必要とするアクセス権に一致するプロファイルを割り当てます。
- AEM ユーザー - コンテンツソースを表示します。
- AEM管理者 - コンテンツソースを作成および編集します。
これらのプロファイルを割り当てるには、Business Owner Cloud Manager製品プロファイルを持つシステム管理者である必要があります。 ユーザーの名前とメールアドレスを準備します。
- Cloud Managerで、プログラムに移動し、ターゲット環境の アクセスの管理 を選択します。 その環境のAdobe Admin Consoleが新しいタブで開きます。
- パブリッシュ層(例:
AEM Administrators - publish - Program 12345 - Environment 67890)の AEM Users または AEM Administrators 製品プロファイルを選択します。 Content AIは公開されたコンテンツにインデックスを作成するので、プロファイルはオーサーではなく公開レベルで割り当てる必要があります。 - 「ユーザーを追加」を選択します。
- ユーザーの名前とメールアドレスを入力し、変更を保存します。 ユーザーが製品プロファイルに追加されます。
開発、ステージング、実稼動など、ユーザーがアクセスを必要とする環境ごとに、これらの手順を繰り返します。
割り当てを確認 verify-assignment
割り当てが成功したことを確認するには、次の手順に従います。
- Admin Consoleで、割り当てた製品プロファイルを再度開きます。
- ユーザーがメンバーリストに表示されていることを確認します。
アクセスまたはトークンの問題をトラブルシューティングする場合は、ユーザーがグループを通じてだけでなく、製品プロファイルに直接追加されていることを確認します。
手順1 - 「コンテンツ AI設定」タブを開く open-tab
-
Cloud Managerにログインし、プログラムを選択します。
プログラムカードを表示する
-
プログラムの概要から、環境 セクションを見つけ、設定する環境を選択します。
-
環境の詳細ページで、「コンテンツ AI設定」タブを選択します。
ステップ 2 - コンテンツ AI Sourceの作成 create-source
コンテンツソースは、Content AIがクロールするweb サイトとインデックスを定義します。
-
「Content AI Configuration」タブで、「Sourceを作成」を選択します。
-
新しいコンテンツ AI Source ダイアログで、次のフィールドに入力します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 フィールド 説明 Content AI設定名 このソースの一意のID (例: my-site-index)。 作成後に変更することはできません。説明 (オプション) コンテンツソースの簡単な説明。 Web サイトのアドレス クロールするweb サイトのルート URL (例: https://www.example.com/)。URLを除外 クロール中にスキップする(オプション) URL パターン。 更新頻度 Content AIがソースを再クロールする頻度(毎週、毎日、毎日4×、60分、または15分)。
利用可能なオプションを表示する
-
「Sourceを作成」を選択します。
ステップ 3 - トリガーの獲得 trigger-acquisition
ソースを作成した後、そのステータスは 新規 です。 インデックス作成を開始するには、最初の取得を実行します。
-
ソースリストで、ソースの横にあるその他のアクション (。…)アイコンを選択し、トリガー獲得を選択します。
-
トリガー獲得 ダイアログで、ソースの詳細 – コンテンツソース、前回の実行、次回のスケジュール実行 – を確認し、トリガーを選択します。
手順4 - インデックス作成ステータスの監視 monitor-status
顧客獲得が開始されると、ソースステータスがリアルタイムで更新されます。
インデックス作成ステータスを表示する
インデックスを検索するかAPIをテストする前に、ステータスが Available に達するのを待ちます。
手順5 - インデックス付きコンテンツの検索 search-content
ソースのステータスが Available になると、Cloud Managerから直接検索クエリを実行して、コンテンツが正しくインデックス付けされていることを確認できます。
-
ソースリストで、ソースの横にある 検索 を選択します。
-
検索フィールドにクエリを入力します。 結果には、一致するスコアとコンテンツタイプを持つ一致する項目のリストが表示されます(例:PAGEまたはPDF)。 結果を選択すると、右側にプレビューが開きます。
Sourceの変更または削除 modify-source
ソース設定を作成後に更新するには、次の手順に従います。
-
ソースリストで、ソースの横にあるその他のアクション (。…)アイコンを選択し、編集を選択します。
-
コンテンツ AI Sourceを変更 ダイアログで、必要に応じて説明、Web サイトのアドレス、URLを除外、または 更新頻度 を更新します。 Content AI設定名は読み取り専用で、変更できません。
-
保存を選択して変更を適用するか、ダイアログの左下にある 削除 を選択して、ソースを完全に削除します。
note warning WARNING ソースの削除は永続的です。 そのソースのすべてのインデックス付きコンテンツが削除され、検索クエリを提供できなくなります。
ソースリストが更新され、変更内容が反映されます。 ソースを削除すると、そのソースはリストに表示されなくなります。
次の手順 next-steps
- Adobe Developer Console プロジェクトの設定 - APIを呼び出すために必要なADC プロジェクトと資格情報を作成します。
- コンテンツ AI API リファレンス - セマンティック、フルテキスト、またはハイブリッド検索エンドポイントを使用して、インデックス化されたコンテンツをクエリします。
トラブルシューティング troubleshooting
- Sourceは、長期間 インデックス作成に滞在します。 (。…) メニューから取得を再試行します。 2回目の実行後にステータスが進まない場合は、Web サイトのアドレスに公開可能であること、およびURLの除外 パターンがすべてのページをフィルタリングしていないことを確認してください。
- Sourceは、実行後に新規に戻ります。 Web クローラーは、設定されたルート URLからページを取得できませんでした。 URLが
200 OKで応答し、サイトが自動要求をブロックしていないことを確認してください。 - 検索では、使用可能な ソースの結果は返されません。 インデックス作成は成功しましたが、クエリに一致するコンテンツはありません。 より幅広いクエリを試すか、クロールされたURLに想定されるページが含まれていることを確認します。