Work IQ API の概要 (プレビュー)

Work IQ API を使用すると、開発者は、既存のアクセス許可、コンプライアンス、ガバナンス制御を維持しながら、Microsoft 365 データを安全に推論するエージェント型および AI を利用したアプリケーションを構築できます。

Work IQ には、エージェント間 (A2A)、モデル コンテキスト プロトコル (MCP)、REST など、エージェントと対話するための複数のプロトコルが用意されているため、アプリケーションまたはエージェントのアーキテクチャに最適なプロトコルを選択できます。 このパブリック プレビューでは、A2Aとローカル MCP を現在使用できます。REST とリモート MCP は近日公開予定です。

Microsoft Work IQ API にアクセスするか、Microsoft Work IQ API を使用することで、 Microsoft Work IQ API の使用条件 (プレビュー) に同意したことになります。

Work IQ とは

Work IQ は、Microsoft 365 Copilotとエージェントの背後にあるインテリジェンス レイヤーです。 単にコンテンツを取得するシステムとは異なり、実際に作業がどのように行われるかを理解しています。 Microsoft 365 (メール、会議、ドキュメント、チャット) のデータと、パターン、基本設定、リレーションシップのメモリを組み合わせたものです。 すべての推論に必要な推論が適用され、次に最適なアクションが表示されます。 Work IQ は、エンタープライズのアクセス許可とガバナンスを尊重しながら、コンテキストの組み立てから応答の基礎作成、スキルの選択、ツールの呼び出しまで、あらゆるインテリジェンスレイヤーを調整します。

すべての Work IQ 要求:

  • サインインしているユーザーのコンテキストで実行する
  • Microsoft 365 のアクセス許可と秘密度ラベルを適用する
  • Microsoft 365 信頼境界内に留まります

これにより、アプリケーションは、コンテンツをエクスポートまたは複製することなく、作業データを推論できます。

Work IQ を使用する理由

従来の AI 統合では、多くの場合、エンタープライズ データの抽出、インデックス作成、セキュリティ保護を行うためにカスタム パイプラインを構築する必要があります。 Work IQ では、次の機能を提供することで、この複雑さが解消されます。

  • セキュリティで保護されたエンタープライズ 接地: Microsoft 365 データへのアクセスは、自動的にアクセス許可がトリミングされ、ポリシーが適用されます。
  • 柔軟な対話モデル: 会話型 API、エージェントの委任、またはツール ベースのアクセスから選択します。
  • 運用オーバーヘッドの削減: ベクター ストア、データ同期ジョブ、またはカスタム コンプライアンスの適用を管理する必要はありません。

サポートされるプロトコル

Work IQ では、次のプロトコルがサポートされています。

プロトコル 説明 一般的なシナリオ
A2A 構造化エージェント間通信 マルチエージェント システム、委任
ローカル MCP ツールベースのコンテキスト アクセス IDE、CLI、AI コーディング アシスタント
リモート MCP ツールベースのコンテキスト アクセス IDE、CLI、AI コーディング アシスタント
REST (近日公開予定) 会話型、要求/応答 API サービスでホストされるエージェント、オーケストレーター

サポートされている機能

作業 IQ では、次の理由が考えられます。

  • 電子メール メッセージ
  • 会議と予定表のデータ
  • OneDrive と SharePoint のドキュメント
  • メッセージのMicrosoft Teams
  • Peopleと組織のコンテキスト
  • エンタープライズ検索結果

プロトコルを選択する

次のガイドを使用して、適切なプロトコルを選択します。

注:

次の表に、厳密な規則ではなく、特定のシナリオに最適なプロトコルの 推奨事項 を示します。 最適なプロトコルを使用します。

A2A REST API (近日公開予定) Mcp
次の場合に使用する 別のエージェントは、タスクを Work IQ に委任し、結果を返す必要があります プログラムで Work IQ を呼び出すアプリまたはサービスを構築している AI アシスタント (Copilot、Claudeなど) は、ユーザーのツールとして Work IQ を呼び出す必要があります
Caller 別のエージェント アプリまたはバックエンド LLM ベースのクライアント
例 "私たちのopsエージェントは、回帰を調査するために仕事IQを求めます。 "Web アプリから Work IQ に質問が送信され、返信が表示されます。 "ユーザーが Copilot に質問し、Work IQ を呼び出して回答します。

API の例

エージェント間 (A2A) プロトコル

エージェントのコラボレーションと委任にはA2Aを使用します。エージェントは、単純な API 呼び出しではなく、自律的に動作し、構造化されたタスクを交換します。 Work IQ では、A2A-Version 要求ヘッダーを介してディスパッチされた v1.0 と v0.3 の両方A2Aサポートされます。

Work IQ Gateway

  • エンドポイント： https://workiq.svc.cloud.microsoft/a2a/
  • トークンの対象ユーザー: api://workiq.svc.cloud.microsoft
  • スコープ: WorkIQAgent.Ask

要求の例 — 同期 (SendMessage)

POST https://workiq.svc.cloud.microsoft/a2a/
Authorization: Bearer {access-token}
Content-Type: application/json
A2A-Version: 1.0

{
  "jsonrpc": "2.0",
  "id": "<request-guid>",
  "method": "SendMessage",
  "params": {
    "message": {
      "role": "ROLE_USER",
      "messageId": "<message-guid>",
      "parts": [
        {
          "text": "What meetings do I have today?"
        }
      ],
      "metadata": {
        "Location": {
          "timeZoneOffset": -480,
          "timeZone": "America/Los_Angeles"
        }
      }
    }
  }
}

注:

v1.0 メソッド名 (SendMessage) を使用するには、A2A-Version: 1.0 ヘッダーが必要です。 省略すると、既定では v0.3 になります。

応答の例

{
  "jsonrpc": "2.0",
  "id": "<request-guid>",
  "result": {
    "task": {
      "id": "<task-id>",
      "contextId": "ctx-1",
      "status": {
        "state": "TASK_STATE_COMPLETED"
      },
      "artifacts": [
        {
          "artifactId": "<artifact-id>",
          "name": "Answer",
          "parts": [
            {
              "text": "Today you have: 9 AM standup, 11 AM review with Dana, 2 PM customer call."
            }
          ]
        }
      ]
    }
  }
}

複数ターンの会話

次のメッセージで、前の応答から contextId を渡します。

{
  "jsonrpc": "2.0",
  "id": "<request-guid-2>",
  "method": "SendMessage",
  "params": {
    "message": {
      "role": "ROLE_USER",
      "messageId": "<message-guid-2>",
      "contextId": "ctx-1",
      "parts": [
        {
          "text": "Tell me more about the 2 PM customer call."
        }
      ]
    }
  }
}

キーの特徴

  • JSON-RPC エンベロープが必要 (jsonrpc、 id、 method、 params)
  • ベース URL への POST — メソッド名は URL パスではなく本文内にあります
  • 同期 (SendMessage) をサポート
  • マルチターン経由 contextId
  • Location 時間依存クエリに必要なメタデータ

リモート モデル コンテキスト プロトコル (MCP)

MCP を使用して、開発者環境で実行されている AI アシスタントのツールとして Microsoft 365 作業コンテキストを公開します。

重要

  • 現在の状態: 現在、Microsoft 365 の作業コンテキストは、 特定のワークロードに対して個々の MCP サーバーを介して使用できます。
  • もうすぐです： 単一の統合されたリモート Work IQ MCP サーバーは、キュレーションされた一連のツールとスキルを使用して、これらを 1 つのサーバーに統合します。構成を簡素化し、一貫性のある開発者エクスペリエンスを提供します。

ローカル MCP

Microsoft Work IQ CLI (プレビュー) をインストールし、ローカル MCP サーバーとして構成します。

MCP サーバー構成の例

{
  "workiq": {
    "type": "stdio",
    "command": "workiq",
    "args": ["mcp"]
  }
}

エージェントベースのクエリの例

プロンプト

Summarize recent discussions about project risks.

概念的な MCP 呼び出し
{
  "tool": "workiq.search",
  "arguments": {
    "query": "project risks",
    "source": "teams"
  }
}
結果
{
  "results": [
    {
      "summary": "Recent discussions highlighted timeline and dependency risks."
    }
  ]
}

キーの特徴

  • IDE と CLI 用に最適化
  • コンテキストは、必要に応じて動的にプルされます
  • 手動によるプロンプトの作成を減らす
  • 統合ツールを備えた単一サーバー (近日公開予定)

認証とセキュリティ

Work IQ では、委任された認証Microsoft Entra ID使用されます。

  • サインインしているユーザーのコンテキストで要求が実行される
  • 代理 (OBO) フローがサポートされています
  • アプリケーションのみの認証はサポートされていません
  • Microsoft 365 のアクセス許可、秘密度ラベル、コンプライアンス ポリシーが自動的に適用される

Work IQ と Copilot Chat API の比較

Work IQ は、Copilot Chat API の運用環境に対応した進化になります。 Work IQ が一般公開 (5 月とすぐに) に達すると、運用環境のシナリオで Copilot エージェントと統合するための推奨され、完全にサポートされる方法になります。 これは、エンタープライズ SLA、安定した契約、および長期的なサポート コミットメントによってサポートされます。

この変更の意味

  • 新しいプロジェクトは、1 日目から Work IQ に基づいて構築する必要があります。
  • Copilot Chat API を使用した既存の統合は引き続き機能します。 Copilot Chat API は、実験と初期段階の開発のためにパブリック プレビューに残りますが、運用環境の SLA ではカバーされません。
  • 移行は簡単です。 Work IQ は、既に知っている概念を保持し、運用ワークロードに必要な信頼性、ガバナンス、サポートの保証を追加します。

製品のリリースに先立って Work IQ への移行を計画し、発売時の運用サポートを最大限に活用することをお勧めします。

関連コンテンツ

  • Last updated on