コンテンツの追加と管理の方法

このページで学べること

カスタマーエージェントに含まれるコンテンツ、ストアフロントからインデックスされたコンテンツの確認方法、コンテンツの追加方法、そしてカスタマーエージェントが買い物客の質問に回答するために使用できるコンテンツの書き方について説明します。

始める前に

必要なもの：

• オーナー、管理者、または マネージャー のロール

自動的にウェブサイトを同期するには、カスタマーエージェントの有料購読が必要です。トライアル期間中も、コンテンツを追加して手動更新をリクエストできます。

すでにコンテンツがあります

カスタマーエージェントは、設定時にKlaviyoAIBotクローラーを使用して、接続済みのストアフロントをインデックス化します。これには、商品ページ、ヘルプ記事、ポリシーページ、FAQなどが含まれます。

追加する前に、すでにある内容を確認してください。カスタマーエージェント>[ナレッジ]を開き、カスタマーエージェントがインデックスした内容を参照します。不足がある場合は、不足しているソースを追加してください。古いコンテンツが表示される場合は、更新するか削除してください。

サイトを継続的に自動インデックスするには、カスタマーエージェントのウェブサイトコンテンツを自動的に同期する方法をご覧ください。

コンテンツとスキルの比較

カスタマーエージェントを設定する際に、以下の2つを混同しやすい点にご注意ください。

• コンテンツ はカスタマーエージェントが把握している内容（事実、ポリシー、製品の詳細）です。ユーザーが文書で残せる固定の情報となります。
• スキルはカスタマーエージェントの実行内容（特定の種類のリクエストへの対応）であり、多くの場合ツールや複数ステップのワークフローを伴います。

判断の基準：すべての顧客に対し同じ答えとなり、事実として記述できる内容は、コンテンツに含めるべき情報です。カスタマーエージェントが何かを実行する必要がある場合（データを検索する、アクションを実行する、複数ステップのプロセスを実行するなど）は、スキルに該当します。

たとえば、返品ポリシーはコンテンツです。購入者の返品を実際に開始するのは、Returns & exchanges スキルです。

コンテンツをさらに追加する

カスタマーエージェントのナレッジベースに情報を追加する3つの方法：

文書をアップロード

これはポリシー、FAQ、トレーニング資料など、ファイルとしてあるものの、ウェブサイトにはないあらゆる内容に使用できます。

1. [カスタマーエージェント] > [ナレッジ] に移動します。
2. ファイルを追加をクリックします。
3. 最大50 MBのPDF、DOC、DOCX、またはTXTファイルを選択してください。
4. ファイルを追加をクリックします。

ウェブページの追加

カスタマーエージェントにインデックス登録させたい URL（特定のランディングページ、ヘルプ記事、ヘルプセンター、またはストアフロント全体）の場合は、以下の方法に従ってください。

1. [カスタマーエージェント] > [ナレッジ] に移動します。
2. [ウェブサイトを追加]をクリックします。
3. URL を貼り付けます。
4. このソースの設定を選択してください：
   • [マイストアフロント URL に設定] — この URL をストアフロントとして接続します。カスタマーエージェントはストアフロント接続を使用して、ページコンテンツとともに、より豊富なEコマースデータを取得します。このオプションを選択すると、すべてのページも選択され、自動同期がオンになります。ストアフロントがすでに接続されている場合、これによりそのストアフロント URL が置き換えられます。
   • 自動同期をオンにする — 定期的に新しい、または更新されたウェブサイトのコンテンツがないかを確認します。自動同期には有料のカスタマーエージェントサブスクリプションが必要です。1回限りのインポートを希望する場合は、オフのままにしてください。
   • AI エージェントがインポートすべきページを指定してください。
     • このURLからすべてのページをインポート—このページと、サイトマップに記載されており、サイトのクローラールールで許可されているURLパス配下の公開ページをインポートします。ヘルプセンター、ブログ、またはセクションルートに使用します。
     • このページのみをインポート — この 1 ページのみ。単発の URL に使用します。
5. ウェブページの追加をクリックします。

スニペットを追加

これは、完全なドキュメントにするほどではない短い情報（単一の FAQ の回答、簡単なポリシーの明確化、製品仕様など）に使用します。

1. [カスタマーエージェント] > [ナレッジ] に移動します。
2. スニペットを作成をクリックしてください。
3. わかりやすいタイトルと、カスタマーエージェントに使用させたい情報を入力してください。FAQの場合は、質問をタイトルとして使用し、本文に明確な回答を記載してください。変更内容は自動的に保存されます。

ウェブサイト全体を自動的かつ継続的にスクレイピングするには、自動同期を設定します。カスタマーエージェントのウェブサイトコンテンツを自動的に同期する方法をご覧ください。

コンテンツの地域を設定

ポリシーまたはページが国によって異なる場合は、適用される地域に限定できます。ウェブサイト、フォルダ、ファイル、スニペット、またはQ&Aを開きます。地域カードで編集をクリックし、地域を選択して、保存をクリックします。ウェブサイトまたはフォルダ内のページは、ページで別の地域を設定しない限り、その地域を継承します。独自の地域も継承された地域もないコンテンツは、すべての買い物客に適用されます。

カスタマーエージェントがショッパーの国を判別できない場合、地域に限定されたコンテンツを含め、すべてのコンテンツを使用できます。

設定手順と例については、複数の国と地域向けにカスタマーエージェントを設定する方法をご覧ください。

カスタマーエージェントが適切に活用できるコンテンツを記載する

すべての読みやすいページがカスタマーエージェントに適しているとは限りません。守るべき原則は以下のとおりです。

• 明確でわかりやすい言葉を使う。専門用語やマーケティングコピーは避けてください。カスタマーエージェントはコンテンツに記載された文言を使用するため、買い物客に読まれたくない内容はコンテンツに入れないでください。
• 「見出し1/見出し2/見出し3」の構造を使用する。見出しは、カスタマーエージェントが質問の回答に必要な箇所を特定するのに役立ちます。
• 宣伝ではなく、事実に基づいてください。トーンはコンテンツではなくガイダンスに入れます。コンテンツは販売ではなく、質問に答える必要があります。
• 回答内で質問を言い換えます。「返品期間は配達から 30 日間です」は「30 日間」よりも効果的です。全文のほうが検索しやすく、読みやすくなります。
• プロセスには番号付きリストを使用します。ステップバイステップで手順を説明したほうが、カスタマーエージェントが明確な回答として整形しやすくなります。
• 長文の中に回答を埋もれさせないでください。回答から始め、詳細は後に追加します。
• 競合する内容を削除する。ポリシーが競合すると、回答が不正確になる可能性があります。不一致があるページを診断して統合してください。
• ドキュメントは焦点を絞ってください。1 つのトピックに絞った 1 ページは、あらゆる内容を網羅する 20 ページの巨大ドキュメントよりも優れています。
• 画像や動画のコンテンツにはテキストが必要。画像や動画の情報をナレッジソース内でテキスト化し、カスタマーエージェントがそれを使用して質問に回答できるようにします。

例

良い — 配送ポリシー：

配送対象

米国 50 州すべてに発送します。私書箱、APO/FPO 住所、または海外の配送先には発送しません。

送料

$ 50以上のご注文でStandard配送が無料になります。$ 50以下の注文には一律$ 7の送料がかかります。

良い — 返品要件：

返品できるもの

商品は、未使用で、元の梱包のままで、元のレシートが同梱されている場合、配達から 30 日以内であれば返品できます。

返品できないもの

最終セール品、カスタマイズ製品、ギフトカードは返品の対象外です。

どちらの例も、明確な見出し、短い事実に基づく文章、明示的な肯定および否定の情報を使用しています。

コンテンツの管理

[ナレッジ]タブから、次のことができます。

• スニペットを編集：スニペットを開き、タイトルまたはテキストを更新します。変更は自動的に保存され、インデックス作成のためにキューに追加されます。
• アップロード済みファイルを更新：元のファイルを編集し、Knowledgeから古いコピーを削除してから、更新後のファイルをアップロードしてください。アップロードしたファイルを再同期すると、既存のアップロードが再処理されます；コンピューターから変更内容が取得されるわけではありません。
• 削除：ソースの三点メニューを開き、削除を選択して、古くなった、または関連性がなくなったコンテンツを削除します。
• ウェブページを再同期：元のウェブページを更新してから、Knowledgeでソースを開き、再同期をクリックしてください。これにより、ウェブサイトからの更新がキューに追加されます。
• インポートしたコンテンツを確認：ソースを開き、カスタマーエージェントがインポートしたテキストを確認します。子ページがあるウェブサイトの場合は、該当するページを開きます。

コンテンツを追加または更新したら、該当するファイル、スニペット、またはページにLiveと表示されていることを確認し、Playgroundで質問をテストしてください。エラーまたはコンテンツなしと表示される場合は、ソースを開き、アクセス可能なテキストが含まれていることを確認してください。

トラブルシューティング

問題：カスタマーエージェントが追加したドキュメントを使用していません。
確認：ドキュメントを開き、公開と表示され、想定どおりのテキストが含まれていることを確認してください。テキストが存在する場合は、不明確な見出し、無関係なトピック、または矛盾するソースがないか確認してください。
修正：保留中のコンテンツの同期が完了するのを待つか、使用可能なテキストがないソースを修正してください。長いドキュメントは要点ごとにページを分け、明確な見出しを追加してください。ドキュメントが回答すべき質問を使用して、Playgroundでテストしてください。

症状：自動同期でページが取り込まれませんでした。
考えられる原因：ページにログインが必要である、サイトマップに含まれていない、またはクロールがブロックされています。
修正方法：サイトマップに含まれていないアクセス可能な公開ページの場合は、そのURLをウェブページソースとして追加し、このページのみをインポートを選択してください。ログインで保護されたコンテンツについては、ドキュメントをアップロードするか、情報を含むスニペットを作成してください。公開ページがブロックされている場合は、サイトのクローラールールを確認してください。

問題：カスタマーエージェントが古いウェブサイトコンテンツを使用しています。
考えられる原因: 更新後にソースが同期されていません。
修正方法: ウェブサイトで変更を公開し、Knowledgeでソースを開き、再同期をクリックしてください。該当ページに公開中が表示されるまで待機し、その後Playgroundで新しいコンテンツが使用されていることを確認してください。

症状：購入者が別の国向けのポリシーを受け取ります。
考えられる原因：ポリシーがすべてのリージョンに適用されている、リージョンが誤っている、またはカスタマーエージェントが購入者の国を判別できませんでした。
修正：[リージョン]カードで、ページ自体のリージョンと継承されたリージョンを確認してください。複数の国と地域向けにカスタマーエージェントを設定する方法をご覧ください。

FAQ

アップロードできるファイルタイプは何ですか？
ナレッジファイルピッカーでは、最大50MBのPDF、DOC、DOCX、またはTXTファイルを使用できます。カスタマーエージェントはテキストを抽出するため、画像にのみ表示されている情報についても、文字での説明を含めてください。

自動同期はどのくらいの頻度で実行されますか？
自動同期は、自動同期がオンになっているウェブサイトのソースを毎週チェックします。コンテンツをより早く更新するには、ソースを開いて再同期をクリックしてください。詳しくは、カスタマーエージェントのウェブサイトコンテンツを自動的に同期する方法をご覧ください。

ゲート付きページやログインで保護されたページはどうなりますか？
自動同期では、ログインの背後にあるページにアクセスできません。それらはドキュメントまたはスニペットとして手動で追加してください。

次の手順

• 継続的なサイトカバレッジのために 自動同期を設定します
• プレイグラウンドでテストして、カスタマーエージェントがコンテンツをどのように使用するかを確認します。
• ガイダンスを設定して、カスタマーエージェントがこのコンテンツをどのように伝えるかを制御します。

その他のリソース