For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.
AI アシスタントを使用する
ユーザーがどのように AI アシスタントを開くかは、ウィジェットの設定方法によって異なりますが、基本的なパターンは次のとおりです。
AI アシスタントウィジェットランチャーを見つけてください。
ヘルプやチャットアイコンを探してください。多くの場合、ページの右下隅にあります。チームは「ヘルプ」、「サポートが必要ですか?」、またはあなたの会社名など、あなたのブランド名を付けることができます。
ウィジェットを開きます。
ランチャーを選択します。 AI Assistantウィジェットがページ上のパネルとして開きます。 設定によっては、ウィジェットに次のようなものが含まれます。
- AI アシスタントと会話できるチャットタブ。
- 推奨コンテンツや検索可能なコンテンツを含むリソースセンタータブ。
- 両方とも同じウィジェット内の別々のタブとして使用できます。
チャットとリソースセンターを切り替えます。
チームが両方を有効にしている場合は、ウィジェットの上部にあるタブ(チャットとリソースなど)を使用してモードを切り替えます。
- 会話ヘルプのためのチャット。
- 記事、ガイド、その他のコンテンツを閲覧および検索するためのリソースです。
質問する
チャットタブでは、ユーザーはAIアシスタントに質問できます。接続されたコンテンツやツールで回答できます。典型的なユースケースは次のとおりです。
- 「チームメイトを招待するにはどうすればよいですか?」
- 「なぜ私のダッシュボードは空っぽなのですか?」
- 「新機能のクイックツアーを表示してください。」
- 「請求ドキュメントはどこで入手できますか?」
質問するには:
- チャットタブの下部にあるメッセージボックスを選択します。
- 質問内容をわかりやすい言葉で入力してください。
- Enter キーを押すか、送信 を選択します。
AI アシスタントはあなたのリクエストを処理し、次に次のことを行います。
- その回答をチャットにストリーミングします。
- 関連するドキュメントやリソースセンターのアイテムへのリンクを含めることができます。
- アプリ内のガイド、チェックリスト、またはアンケートを開いて、プロセスを説明することがあります。
会話を継続する
AI Assistantは1つのチャット内のコンテキストを追跡します:
- 同じことを繰り返さずにフォローアップ質問をすることができます。
- AIアシスタントは、同じ会話内の以前のメッセージを参照できます。
例えば:
- あなた: 「SSO を設定するにはどうすればよいですか?」
- AI アシスタント:プロセスを説明し、セットアップガイドへのリンクを提供します。
- あなた: 「これをすべてのユーザーに要求できますか?」
- AI アシスタント: 前の回答に基づいて実施について説明します。
トピックを完全に切り替えたい場合は、同じチャットで新しい質問を開始してください。 AI Assistantは、関連のないスレッド全体ではなく、会話内のコンテキストを保持します。
回答に対するフィードバックの提供
エンドユーザーはフィードバックを提供することで、AI Assistantの改善に貢献できます。
- 役に立つ回答に「いいね」をして、管理者にそれがうまく機能したことを伝えてください。
- 低評価を付けて、役に立たない回答を報告します。AI Assistant(および管理者)はこれを活用して改善を行います:
- AI アシスタントは別の回答を試したり、説明を求めたりすることがあります。
- 管理者はこの回答が機能しなかったことを確認し、コンテンツや設定を調整することができます。
X線で回答を確認する
AI Assistantには、AI Assistantがどのように各回答を生成したかを説明する詳細な検査ビューが含まれています。
概要としては、X-rayでは以下のことが可能です:
- AI Assistantが回答を生成するために使用したコンテンツソースを確認してください。
- AI Assistantが呼び出したツールやワークフローを確認します。
- AI アシスタントがどのように回答を導き出したかについての簡単な推論説明を読んでください。
- ライブテストチャットと履歴ユーザーチャットの両方を監査します。
チャットから X-ray を開く
主なエントリポイントは2つあります。
AIアシスタント管理エリアでのテスト中。
AIAssistantを構成ビューで直接テストする場合:
- 画面の右側から会話を開始できます。
- その会話の「X-ray」タブを開きます。
- 各AIアシスタントメッセージについて、詳細を開いて確認してください:
- 思考のタイムライン(ツール呼び出しと中間推論)。
- AI Assistantが検索して引用した情報源。
アナリティクスにおける履歴チャットから。
AIAssistantまたはチャットアナリティクス領域から:
- フィルタリングまたは検索を行い、関心のあるチャットを見つけます。たとえば、フォールバックが発生したり否定的なフィードバックを受けたチャットなどです。
- チャット詳細ビューを開きます。
- X線 または 検査 ボタンを選択します。
- それぞれの回答を同じ方法で確認してください。つまり、思考方法、情報源、ワークフロー(該当する場合)などです。
思考の視点を理解する
思考タイムラインには、AI アシスタントがメッセージをどのように処理したかが時系列で表示されます。
このビューを使用して次のことを行います。
- AI Assistant が適切なツールを適切な順序で呼び出すことを確認します。
- AI Assistant が適切なタイミングでワークフローを選択することを確認してください。
- AI Assistantが使用するはずのツールをスキップしたケースを特定します。
ソースビューを理解する
[ソース] タブには、AI アシスタントが回答を作成する際にアクセスできた情報が表示されます。一般的な情報には次のものが含まれます。
- 引用された情報源 — 回答の形成に最も直接的に寄与した文章と回答。
- その他の考慮されたソース — AI Assistantが取得および評価したが、直接引用しなかったコンテンツ。
- ソースごとの詳細情報 — タイトル、URL、コンテンツセクションなど。
AI Assistantは内部的に関連する文章のポイントインタイムスナップショットを保存するため、後で誰かがその記事を編集または削除した場合でも、AI Assistantが何を使用したかを確認できます。
このビューを使用して次のことを行います。
- AI アシスタントが正しいドキュメントを使用していることを確認します。
- 古くなったり不正確なコンテンツが間違った回答を引き起こす場合を特定します。
- 次のいずれかを選択します:
- 記事を更新します。
- より明確な回答を含むAnswerを作成します。
- コンテンツ タグやインデックス作成を調整します。
チャットを分析して AI アシスタントを改善
AI アシスタントの価値は、繰り返し作業を行うにつれて高まります。 チャットアナリティクスとX-rayを使用して、カバー範囲と品質を向上させます。
問題領域を見つける
チャットアナリティクス領域から:
- チャットを次の基準でフィルタリングします:
- 高いフォールバック率。
- ネガティブなフィードバック。
- 特定のトピックまたはキーワード。
- 個々のチャットを開き、X-rayで詳細を確認して以下をレビューします:
- AI Assistantが使用したソース。
- AI Assistantが呼び出したツール。
- 回答が不完全だったか、間違っていたか。
ギャップを解消する
結果に基づくと:
- ドキュメントやヘルプセンターでコンテンツを更新または追加できます。
- 繰り返し発生する重要な質問に対する回答を作成します。
- AIアシスタントが正しい道を選択していない場合、ワークフローやツールを調整できます。
- リソースセンターのコンテンツのターゲット設定を強化または拡大することで、ユーザーが必要とするタイミングと場所に記事が表示されるようになります。
- 重要なプロダクト分野や混乱を招くプロダクト分野に関するガイドを作成してください。
このループ(チャット、X-ray、コンテンツや設定の更新)が時間の経過とともに、AIアシスタントを汎用的なチャットボットではなく、高品質なプロダクト固有のヘルパーへと変貌させます。
これは役に立ちましたか?