Work IQ API の概要

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

Work IQ は、エージェント間 (A2A)、モデルコンテキストプロトコル (MCP)、REST など、エージェントと対話するための複数のプロトコルを提供するため、アプリケーションまたはエージェントのアーキテクチャに最適なプロトコルを選択できます。

Microsoft Work IQ API にアクセスするか使用すると、 Microsoft Work IQ API の使用条件に同意したものとみなされます。

ワークIQとは何ですか?

Work IQ は、Microsoft 365 データとコンテキスト理解を組み合わせたワークプレース インテリジェンス レイヤーで、エージェントが仕事を推論し、アクションを実行できるようにします。 Work IQ 機能の完全な概要については、「 Work IQ の概要」を参照してください。

Work IQを使用する理由

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

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

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

Work IQ は、次のプロトコルをサポートします。

サポートされている機能

ワークIQは次のように推論できます。

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

プロトコルの選択

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

API サンプル

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

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

要求の例 — 同期 (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"
        }
      }
    }
  }
}

応答の例

{
  "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 を使用して、Microsoft 365 作業コンテキストを開発者環境で実行される AI アシスタント用のツールとして公開します。

ローカル MCP

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

▶ 対話型デモでローカル 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 は、Microsoft 365 データ上の新しいエージェントおよび AI 搭載アプリケーションに推奨される基盤です。 Work IQ API で新しい開発を構築し、統合されたプロトコル、統合されたガバナンス、継続的な投資を活用します。

ライセンスの要件

Work IQ API は、 Microsoft 製品条項を含む、Microsoft Online Services の使用を管理する契約に基づいてライセンスが付与されます。 Work IQ API の使用料は、Copilot クレジットを使用する使用量ベースのモデルを通じて発生します。 詳細については、「 Copilot クレジットの使用量ベースの課金とコスト管理について」を参照してください。

関連コンテンツ

• Work IQ A2A クイックスタート
• Work IQ REST API の概要
• Microsoft Work IQ CLI
• Microsoft Work IQ API の使用条件
• Copilot クレジットの使用量ベースの課金とコスト管理を理解する
• 使用量ベースの請求によって有効化された AI エクスペリエンスの管理
• 使用量ベースの課金によって有効になる AI エクスペリエンスの検出設定
• 対話型デモで API を試す