Microsoft Foundry プロジェクトを Work IQ に接続する

Microsoft Foundry プロジェクトで Work IQ 接続を使用して、Foundry エージェントがメール、会議、ファイル、チャット、その他の作業データから Microsoft 365 コンテキストを使用できるようにします。 プロジェクト接続を作成した後、Work IQ をエージェントまたはツールボックスに追加し、プロンプトで使用できます。 要求は、サインインしているユーザーのコンテキストで実行され、Microsoft 365 のアクセス許可、秘密度ラベル、テナント ポリシーを尊重します。

このクイック スタートでは、プロジェクト レベルの接続フローをまとめたものです。 Foundry の完全な記事と SDK の例については、「 Work IQ を使用してエージェントを Microsoft 365 に接続する」を参照してください。

前提条件

開始する前に、次の情報があることを確認してください。

  • デプロイされたモデルを含む Microsoft Foundry プロジェクト。
  • Work IQ 接続を作成するための Foundry プロジェクトの Foundry プロジェクト マネージャー ロール。
  • 開発者 ID、エージェント ランタイム ID、OAuth フローに関係するユーザーの Foundry プロジェクトの Foundry ユーザー ロール。
  • エージェントを介して Work IQ を呼び出す各ユーザーのMicrosoft 365 Copilot ライセンス。
  • WorkIQAgent.Ask委任されたアクセス許可に対して管理者の同意を付与できるMicrosoft Entraグローバル管理者。

注:

Foundry での作業 IQ 接続では、委任されたMicrosoft Entra認証を使用します。 アプリケーションのみの認証はサポートされていません。

Microsoft Entra アプリを設定する

Foundry で Work IQ 接続を作成する前に、Entra管理者がアプリ登録を作成または構成する必要があります。

  1. Microsoft Entra 管理センターで、Entra ID>アプリの登録 に移動します。
  2. 新しいアプリ登録を作成するか、Foundry エージェントの既存のアプリ登録を開きます。
  3. アプリケーション (クライアント) ID とディレクトリ (テナント) ID をコピーします。
  4. クライアント シークレットを追加し、シークレットの値をコピーします。
  5. [ API のアクセス許可] で、 Work IQ 委任されたアクセス許可 WorkIQAgent.Askを追加します。
  6. [テナント に管理者の同意を付与 する] を選択します。

API のアクセス許可を検索するときに Work IQ が表示されない場合は、テナントに Work IQ サービス プリンシパルがプロビジョニングされていない可能性があります。 セットアップ ガイダンスについては、「 Work IQ API を有効にする」を参照してください。

Foundry で Work IQ MCP ツールを接続する

Foundry プロジェクトのツールとしてリモート Work IQ MCP サーバーを接続します。

  1. Microsoft Foundry でプロジェクトを開きます。

  2. 左側のナビゲーションで、[ツール] を選択 します。

  3. [ツール] ページ で 、[ ツール ] タブを選択します。

  4. [ ツールの接続] を選択します。

  5. [ ツールの選択] で、[ カタログ ] タブを選択します。

  6. Work IQ MCP を検索します。

  7. [ Work IQ MCP] を選択し、[ 作成] を選択します。

  8. Work IQ MCP エンドポイントを確認または入力します。

    https://workiq.svc.cloud.microsoft/mcp

  9. アプリ登録の値を使用して OAuth を構成します。

    フィールド 値
    クライアント ID アプリの登録からのアプリケーション (クライアント) ID
    クライアント シークレット アプリ登録からのクライアント シークレット値
    承認 URL https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize
    トークン URL https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
    URL の更新 https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/token
    Scope api://workiq.svc.cloud.microsoft/WorkIQAgent.Ask,offline_access

  10. {tenant-id}を、アプリ登録のディレクトリ (テナント) ID に置き換えます。

  11. ツール接続を保存します。

アプリ登録にリダイレクト URI を追加する

Foundry がツール接続を作成すると、OAuth リダイレクト URL が表示されます。 この URL をアプリ登録に追加します。

  1. Microsoft Entra 管理センターで、アプリの登録を開きます。
  2. [認証>プラットフォームの追加>Web] を選択します。
  3. Foundry ツール接続の OAuth リダイレクト URL を リダイレクト URI に貼り付けます。
  4. [構成] を選択します。

エージェントへの Work IQ の追加

プロジェクトで Work IQ MCP ツール接続を使用できるようになったら、Work IQ をエージェントに追加します。

  1. Foundry プロジェクトを開きます。
  2. Microsoft 365 コンテキストを使用する必要があるエージェントを開きます。
  3. Work IQ MCP ツールをエージェントに追加するか、エージェントが使用するツールボックスに追加します。
  4. 作成した Work IQ ツール接続を選択します。
  5. Foundry から MCP ツール アクセスの構成を求められた場合は、エージェントが呼び出すことができる Work IQ ツールを許可します。 また、MCP ツールの呼び出しで承認が必要か、organizationのレビューと安全性の要件に基づいて自動的に承認されるかを選択することもできます。
  6. エージェント構成を保存または発行します。

Work IQ プロンプトを試す

Foundry エージェントに、Microsoft 365 コンテキストを必要とする質問をします。 ユーザーが初めて Work IQ を使用するプロンプトを送信すると、Foundry はユーザーにサインインを求め、アクセスに同意するように求める場合があります。

例:

Summarize my upcoming meetings for today.

Find recent messages from my manager from this week.

Retrieve the latest email related to the quarterly business review.

Foundry は、要求を Work IQ にルーティングします。 Work IQ は、ユーザーの Microsoft 365 データに対する取得と理由を取得し、エージェントに対して根拠のある応答を返します。

応答は、サインインしているユーザーの Microsoft 365 アクセス許可、アプリケーションの OAuth アクセス許可、テナント ポリシーによって異なります。

関連コンテンツ

  • Last updated on