この記事の内容
まとめ
建築の概要
データハンドリング
dropdown icon
認証と承認
    ユーザーが同意した権限
    サービスの許可
コントロールハブでのCopilot統合機能の管理と承認
Webex アプリの設定と構成
その他の参考資料
AI Assistant が外部の Microsoft データソースを検索できるようにしてください
list-menuこの記事の内容
list-menuフィードバックがある場合

Microsoft Copilotと統合することで、Webexミーティングユーザーはデータソースの1つとしてMicrosoft Copilotアカウントに安全に接続できます。

まとめ

Webex Cisco AI Assistant Appを活用することで、 ユーザーはSharePoint、OneDrive、Copilotコネクタを含むマイクロソフトのデータソースからの結果を検索、分析、要約することができます。

建築の概要

Microsoft Copilotに接続すると、 マイクロソフト検索APIを使用してマイクロソフトのデータソースを操作できます。 を使用するとCisco AI Assistant、Microsoftのソースからリアルタイムでデータを取得します。

Webexは、経由で返されたデータを保存または保持しません。Cisco AI Assistant データは、 お客様のプライバシーを保護するために、お客様の回答を生成するためにのみ使用されます。

Architecture overview for how Webex AI Assistant uses Microsoft data

詳細なデータフローステップ

ユーザー管理と割り当て

管理者は、コントロールハブを使用して、Microsoft Copilotライセンスを持つユーザーを管理したり、組織、ユーザー、 またはテンプレートレベルで機能をオンまたはオフにしたりできます。

ユーザー認証と接続

  1. ユーザーは Webex アプリにログインします

  2. ユーザーは「設定」ページに移動して、 Microsoftアカウントに接続します。

ユーザーは認証プロセスを完了し、アクセスするソース(SharePoint、 OneDrive、またはコパイロットコネクタ)を選択します。

質問と回答のワークフロー

ユーザーが質問をします。例えば、プロジェクトABCはどのような状況ですか?

次のステップは、Webex Meeting Serviceによって複数のサブステップを使用して実行されます。

  1. 復号化:システムがリクエストを復号化します。

  2. コンテキストを読み込む:関連するコンテキストが読み込まれます。

  3. LLMの理由:LLMは、最適な検索ができるように、質問を書き換えます。

  4. 統合情報を取得する:システムは、 マルチパス検索の設定とトークンを取得します。

  5. マルチパス検索:システムは、サポートされているMicrosoftツール間で検索を実行します。

    • 検索:マルチパス検索ツールは詳細な内容を検索します。

    • 検索結果を返す:マルチパス検索ツールは検索結果を返します。

  6. 再ランク付けとフィルタリング: Webex meetingサービスは、LLMを使用してコンテンツを再ランク付けし、関連性があるようにフィルタリングします。

  7. 世代:LLMは引用を含む最終的な回答を生成します。

  8. 答え:Webexアプリに最終回答を投稿してください。

データハンドリング

データハンドリング

この機能は、次のデータとサービス設定情報を使用して、 承認を管理し、承認されたMicrosoft 365コンテンツを取得し、Webex アプリで応答を提供します。

  • マイクロソフトアプリケーション登録:

    マイクロソフトアプリケーション登録は、インテグレーションのためにMicrosoft Azureポータル(Entra ID) に登録されたOAuth 2.0クライアント構成を表します。Cisco AI Assistant

    この登録は、 Microsoftアカウントの認証フロー中に必要な特定の委任権限を定義します。

    • すべて読み取りとサイト.読み取りすべて:SharePointとOneDriveのコンテンツにアクセスするために必要です。

    • externalItem.read.all: コパイロットコネクタのコンテンツにアクセスするために必要です。

    Cisco AI AssistantMicrosoft 365 Copilot検索APIを呼び出す前に、 この登録を使用してサインインとトークンの取得のための正しいOAuth設定を見つけます。 詳しい情報については、「Microsoft Azure Cisco AI Assistant に登録する」を参照してください。

  • マイクロソフトのOAuthトークン:

    Microsoft OAuthトークンは、ユーザーがWebexアプリの設定ページからMicrosoftアカウントにサインインし、必要な権限を付与すると、Microsoft Entra IDによって発行される短期間の委任アクセストークンです。

    Cisco AI Assistantこれらのトークンを使用して、ユーザーに代わってMicrosoft 365 Copilot検索APIを呼び出します。 Microsoft Entra IDはこれらのトークンを使用して各リクエストを認証し、 ユーザーを識別し、Microsoft 365のアクセス制御と情報バリアポリシーを適用して、 サインインしたユーザーがアクセスを許可されているコンテンツのみが返されるようにします。

    トークンの更新

    最初の認証時に、Microsoft Entra IDは短期アクセストークン(約60〜90分間有効)と長期間有効な更新トークンの両方を発行します。 Webexは、ユーザーのWebex IDにバインドされた更新トークンをサーバー側に安全に保存します。

    アクセストークンは継続的に更新されません。 代わりに、ユーザーがリクエストを送信すると、Webexは現在のアクセストークンがまだ有効かどうかを確認します。 有効期限が切れている場合は、更新トークンを新しいアクセストークンと簡単に交換します。 更新トークンの有効性は使用されるたびに延長され、機能が通常使用されている限り、 ユーザーの介入なしにセッションをアクティブなままにすることができます。

    セッション終了

    セッションは終了し、 次の条件では再認証が必要です。

    • 非アクティブ:ユーザーがこの機能を長期間 (Microsoft Entra IDのデフォルトポリシーとお客様のテナント設定にもよりますが、通常は90日間)使用していません。

    • 手動による接続解除:ユーザーは、自分の Microsoft アカウントを Webex アプリの設定から明示的に切断します。

    • 管理者:Microsoft 365の管理者は、Entra IDのアプリケーションのアクセスを取り消します。

    • 設定の変更:付与された権限範囲が変更されたり、 アプリケーションの登録が変更されたりします。

    詳しい情報については、「Webex アプリでの Microsoft アカウント認証」を参照してください。

  • プロンプトテキスト:

    プロンプトテキストとは、プロジェクトの状況を確認したりCisco AI Assistant、 Microsoftアカウント内で文書を検索したりするリクエストなど、ユーザーが入力する自然言語入力を指します。 このテキストは実行時にユーザーによって生成されます。

    処理ワークフロー

    プロンプトが送信されたら、Cisco AI Assistant次の手順に従って情報を取得して表示します。

    • 解釈と最適化:アシスタントはプロンプトを解釈し、 推論を行い、クエリの書き換えを実行して、最適化されたクエリ文字列を生成します。

    • API呼び出し:アシスタントは、1つ以上のデータソースに対してMicrosoft 365 Copilot検索APIを呼び出します。

    • フィルタリング:該当する場合、キーワードクエリ言語(KQL) のフィルター式を適用して、特定のサイト、 ドキュメントライブラリ、ファイルタイプ、または日付範囲に検索範囲を限定します。

    • 再ランク付けと合成:アシスタントは、 返されたテキストチャンクを再ランク付けしてフィルタリングします。 次に、 元のプロンプトと、ソース文書への引用を含めて、取得した内容を組み合わせた最終応答を生成します。

  • シェアポイントとOneDriveのコンテンツ:シェアポイントとOneDriveのコンテンツは、 ユーザーの要求に応えるためにMicrosoft 365 Copilot Retrieval APIを介して取得されたMicrosoft 365データの認証を受けています。 Retrieval APIは、データを複製、エクスポート、または個別にインデックス化することなく、 Microsoft 365ハイブリッドコンテンツインデックスから関連するテキストチャンクを直接抽出します。

    サポートされているファイルタイプ:.docx、.pptx、.pdf、.aspx、.one。画像やグラフなどの非テキストコンテンツはサポートされていません。

    すべてのコンテンツはMicrosoft 365の信頼範囲内で取得され、 サインインしたユーザーがMicrosoft 365の権限モデルでアクセスを許可されているファイルとドキュメントに厳密に限定されます。

    • リクエスト:認証ヘッダーに Microsoft Entra ID の委任されたアクセストークンを入れて、HTTPS POST リクエストを https://graph.microsoft.com/v1.0/copilot/retrieval Cisco AI Assistant に送信します。 リクエスト本文には以下が含まれます:

      • queryString — ユーザーのプロンプトから生成された、書き直された自然言語クエリ(最大1,500文字)。

      • データソース — SharePointまたはOneDriveに設定します(リクエストごとに1つ、ソースごとに別々の呼び出しが行われます)。

      • filterExpression(オプション)—サイトのURL、パス、 ファイルタイプ、または日付範囲でスコープを設定するKQL式。

      • 結果の最大数-1回の通話につき25件までです。

    • 応答:Microsoft 365は信頼境界内でリクエストを処理し、 RetrievalHits配列を返します。各エントリには次のものが含まれます。

      • contentChunk — コンテンツインデックスから抽出されたテキストスニペット

      • elevanceScore—クエリとチャンクの間のコサイン類似度スコア。0〜1の範囲に正規化されています

      • リソース—ファイル名、URL、作成者、最終更新日を含むソースメタデータ

    • データ処理:ファイルコンテンツ全体が転送されることはありません。Microsoft 365ハイブリッドインデックスから事前に抽出されたテキストチャンクのみが返されます。 Cisco AI Assistantこれらのチャンクを一時的にLLMに渡して、ランク変更、フィルタリング、回答生成を行います。 ソースメタデータは、最終回答の引用を作成するために使用されます。 テキストチャンクは、リクエストの期間が過ぎると Webex に保存されません。

  • コパイロットコネクタのコンテンツ:コパイロットコネクタのコンテンツは、Microsoft Graphコネクタを介してMicrosoft 365コンテンツインデックスに取り込まれ、Microsoft 365 Copilot検索APIを介して取得可能になるサードパーティデータまたはカスタムエンタープライズデータです。 返されるすべてのコンテンツは、Microsoft 365でコネクタが設定した権限の下で、 サインインしたユーザーがアクセスを許可されているアイテムに限定されます。

    • リクエスト:認証ヘッダーに Microsoft Entra ID の委任されたアクセストークンを入れて、HTTPS POST リクエストを https://graph.microsoft.com/v1.0/copilot/retrieval Cisco AI Assistant に送信します。 リクエスト本文には以下が含まれます:

      • queryString — ユーザーのプロンプトから生成された、書き直された自然言語クエリ(最大1,500文字)。

      • データソース — コパイロットコネクタに設定します。

      • filterExpression(オプション) —特定のコネクタソースまたはコンテンツタイプに検索範囲を限定するためのKQL式。

      • 結果の最大数-1回の通話につき25件までです。

    • 応答:Microsoft 365は信頼境界内でリクエストを処理し、 RetrievalHits配列を返します。各エントリには次のものが含まれます。

      • contentChunk — インデックスに登録されたサードパーティのコンテンツから抽出されたテキストスニペット。

        elevanceScore—クエリとチャンクの間のコサイン類似度スコアを、0〜1の範囲に正規化します。 Copilot Connectorのすべての結果に関連性スコアが表示されるわけではないことに注意してください。

        リソース—アイテム名、URL、コネクタ定義の属性を含むソースメタデータ。

  • データ処理:完全なソースコンテンツは転送されません。Microsoft 365コンテンツインデックスから事前に抽出されたテキストチャンクのみが返されます。 Retrieval APIは1回の呼び出しで1つのデータソースを対象としているため、SharePoint、OneDrive、Cisco AI Assistant Copilotコネクタに対して個別に取得呼び出しを発行し、再ランク付けの段階で結果をマージします。

    テキストチャンクは、再ランク付け、フィルタリング、 回答生成のために一時的にLLMに渡され、リクエストの期間が過ぎるとWebexによって保存されません。

認証と承認

Webex は、マイクロソフトアイデンティティプロバイダー (IdP) によって認証および管理される Microsoft Retrieval API を使用して、お客様の Microsoft アカウントやコンテンツとやり取りします。 Microsoft IdPと検索APIとのすべての通信は、TLSで保護された接続によって保護されています。

Webex サービス認証

Cisco AI Assistantで Webex アプリは、標準の OAuth 2.0 フローを利用して Webex サービスとやり取りします。

  • アイデンティティプロバイダー:Webex IDサービスは、 ユーザーを認証し、APIアクセスを承認するクラウドベースのIdPとして機能します。

  • ベアラートークン:Webex APIへのリクエストは、Webex IDサービスによって発行されたベアラートークンを使用して承認されます。

  • 安全な通信:Webex、Webex アイデンティティサービスAI Assistant、Webex API間のすべてのデータ交換は 、TLSで保護された接続を介して行われます。

管理要件

この統合を有効にするには、管理者は次の手順を実行する必要があります。

  1. Microsoft 365の設定:管理者は、 該当するユーザーに適切なMicrosoft Copilotライセンスを割り当てる必要があります。

  2. Webexの設定:管理者は、Control Hub内で組織、ユーザー、またはテンプレートレベルで機能を直接有効または無効にできます。

ユーザーが同意した権限

セットアップ中に、次の権限が要求されます。

許可が必要です 目的
Webex App サインインしてユーザープロフィールを読みます アカウントで Webex アプリにサインインします。
Microsoftアカウントを認証してログインします Webex アプリを Microsoft アカウントに接続することを検証して承認してください。

これらの権限はセットアッププロセス中にのみ使用され、保存されません。

サービスの許可

特定のサービス許可は必要ありません。 管理者は、以下のセクションの詳細でコントロールハブの機能と設定を管理できます。

Webex アプリの設定と構成

管理者がコントロールハブを使用して認証して機能を有効にすると、ユーザーはWebex アプリにサインインして Microsoft アカウントへの接続を許可できます。

詳細については、「Microsoftデータにアクセスする」を参照してください Cisco AI Assistant

この投稿記事は役に立ちましたか?
この投稿記事は役に立ちましたか?