Work IQ API の概要

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

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

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

Work 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と組織のコンテキスト
• Microsoft Plannerプラン
• エンタープライズ検索結果

プロトコルを選択する

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

API の例

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

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

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

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

ライセンスの要件

Work IQ API の使用料金は、Copilot クレジットを使用する使用量ベースのモデルを通じて行います。 詳細については、「 Copilot クレジットの使用量ベースの課金とコスト管理について」を参照してください。

関連コンテンツ

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