工作 IQ API 概述 (预览版)

Work IQ API 使开发人员能够构建代理和 AI 支持的应用程序，这些应用程序可以安全地对Microsoft 365 数据进行推理，同时保留现有权限、合规性和治理控制。

Work IQ 提供了多个协议来与代理交互-代理到代理 (A2A) 、模型上下文协议 (MCP) 和 REST，因此你可以选择最适合应用程序或代理体系结构的协议。 在此公共预览版中，A2A和本地 MCP 现已推出。REST 和远程 MCP 即将推出。

访问或使用 Microsoft Work IQ API 即表示你同意 Microsoft Work IQ API 使用条款 (预览版) 。

什么是工作 IQ？

工作 IQ 是智能 智能 Microsoft 365 Copilot 副驾驶® 副驾驶®和代理背后的智能层。 与仅检索内容的系统不同，它了解实际工作原理。 它将来自 Microsoft 365 (电子邮件、会议、文档、聊天) 的数据与模式、首选项和关系的记忆相结合。 它将所需的推理应用于所有推理，并显示下一个最佳操作。 Work IQ 协调每一层智能-从组合上下文到地面响应，选择技能和调用工具-同时遵守企业权限和治理。

所有工作 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 的客户端
示例 “我们的运营代理要求 Work IQ 调查回归。” “我的 Web 应用向 Work IQ 发送问题并呈现回复。” “用户向 Copilot 提出问题，并调用 Work IQ 来回答。”

API 示例

代理到代理 (A2A) 协议

使用A2A进行代理协作和委派，代理可以自主运行并交换结构化任务，而不是简单的 API 调用。 Work IQ 支持通过请求标头调度A2A-Version的 A2A v1.0 和 v0.3。

工作 IQ 网关

  • 端点： 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"
        }
      }
    }
  }
}

注意

标头 A2A-Version: 1.0 需要使用 v1.0 方法名称 (SendMessage) 。 省略它默认为 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、 methodparams)
  • POST 到基 URL - 方法名称位于正文中，而不是 URL 路径内
  • 支持同步 (SendMessage)
  • 多轮次通过 contextId
  • Location 时间敏感型查询所需的元数据

远程模型上下文协议 (MCP)

使用 MCP 将 Microsoft 365 工作上下文公开为在开发人员环境中运行的 AI 助手的工具。

重要

  • 当前状态： 目前，Microsoft 365 工作上下文可通过 特定工作负载的单个 MCP 服务器获得。
  • 即将推出： 单个统一的远程 Work IQ MCP 服务器会利用一组特选的工具和技能将这些内容合并到一台服务器中，从而简化配置并提供一致的开发人员体验。

本地 MCP

安装 Microsoft Work IQ CLI (预览版) 并将其配置为本地 MCP 服务器。

MCP 服务器配置示例

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

基于代理的示例查询

Prompt

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 个权限、敏感度标签和合规性策略

工作 IQ 如何与 Copilot 对话助手 API 进行比较

工作 IQ 是Copilot 对话助手 API 的生产就绪演变。 当 Work IQ (2026 年 5 月) 正式发布时，在生产方案中与 Copilot 代理集成是建议的、完全受支持的方法。 它由企业 SLA、稳定合同和长期支持承诺提供支持。

了解这对你意味着什么。

  • 新项目应从第一天起就基于 Work IQ。
  • 使用 Copilot 对话助手 API 的现有集成将继续工作。 Copilot 对话助手 API 将保持公共预览版，用于试验和早期开发，但生产 SLA 未涵盖该 API。
  • 迁移非常简单 - Work IQ 保留了你已经知道的概念，并增加了生产工作负载所需的可靠性、治理和支持保证。

建议在产品发布之前规划迁移到 Work IQ，以充分利用发布时的生产支持。

相关内容

  • Last updated on