Work IQ API cho phép các nhà phát triển xây dựng các ứng dụng agentic và ứng dụng tích hợp AI có khả năng suy luận an toàn trên dữ liệu Microsoft 365, đồng thời vẫn giữ nguyên các quyền truy cập, quy tắc tuân thủ và cơ chế quản trị hiện có.
Work IQ hỗ trợ nhiều giao thức để tương tác với agent bao gồm Agent-to-Agent (A2A), Model Context Protocol (MCP) và REST giúp bạn có thể lựa chọn giao thức phù hợp nhất với kiến trúc ứng dụng hoặc hệ thống agent của mình. Trong bản public preview này, A2A và local MCP đã khả dụng ngay hôm nay; còn REST và remote MCP sẽ sớm được ra mắt.
Khi truy cập hoặc sử dụng Microsoft Work IQ APIs, bạn đồng ý với các Điều khoản sử dụng Microsoft Work IQ APIs (bản preview).
Work IQ là gì?
Work IQ là lớp trí tuệ đứng phía sau Microsoft 365 Copilot và các agent. Không giống những hệ thống chỉ đơn thuần truy xuất nội dung, Work IQ hiểu cách công việc thực sự diễn ra. Nó kết hợp dữ liệu từ Microsoft 365 (email, cuộc họp, tài liệu, tin nhắn chat) cùng với bộ nhớ về các thói quen, sở thích và mối quan hệ. Sau đó, hệ thống áp dụng khả năng suy luận để phân tích toàn bộ dữ liệu đó và đưa ra những hành động phù hợp tiếp theo. Work IQ điều phối mọi lớp trí tuệ — từ việc tập hợp ngữ cảnh, làm nền tảng cho phản hồi, lựa chọn kỹ năng cho đến gọi công cụ — đồng thời vẫn tuân thủ các quyền truy cập và cơ chế quản trị doanh nghiệp.
Tất cả các yêu cầu Work IQ:
- Được thực thi trong ngữ cảnh của người dùng đã đăng nhập
- Tuân thủ quyền truy cập và nhãn bảo mật của Microsoft 365
- Hoạt động hoàn toàn bên trong ranh giới tin cậy của Microsoft 365
Điều này cho phép các ứng dụng có thể suy luận trên dữ liệu công việc mà không cần xuất hoặc sao chép nội dung ra bên ngoài.
Tại sao nên sử dụng Work IQ?
Các tích hợp AI truyền thống thường yêu cầu xây dựng các pipeline tùy chỉnh để trích xuất, lập chỉ mục và bảo mật dữ liệu doanh nghiệp. Work IQ giúp loại bỏ sự phức tạp này bằng cách cung cấp:
- Secure enterprise grounding: Truy cập vào dữ liệu Microsoft 365 được tự động giới hạn theo quyền người dùng và tuân thủ các chính sách bảo mật.
- Flexible interaction models: Cho phép lựa chọn nhiều mô hình tương tác khác nhau như conversational APIs, agent delegation hoặc truy cập dựa trên công cụ (tool-based access).
- Reduced operational overhead: Không cần quản lý vector store, các tác vụ đồng bộ dữ liệu hoặc cơ chế thực thi tuân thủ được tùy chỉnh riêng.
Các giao thức được hỗ trợ
Work IQ hỗ trợ các giao thức sau:
| Protocol | Mô tả | Các tình huống sử dụng phổ biến |
|---|---|---|
| A2A | Giao tiếp có cấu trúc giữa các agent với nhau | Hệ thống multi-agent, phân quyền và ủy nhiệm tác vụ |
| Local MCP | Truy cập ngữ cảnh dựa trên công cụ | IDEs, CLIs, AI coding assistants |
| Remote MCP | Truy cập ngữ cảnh dựa trên công cụ | IDEs, CLIs, AI coding assistants |
| REST (coming soon) | API hội thoại theo mô hình request/response | Service-hosted agents, orchestrators |
Chức năng được hỗ trợ
Trí thông minh trong công việc có thể suy luận về:
- Tin nhắn email
- Dữ liệu cuộc họp và lịch
- Tài liệu trong OneDrive và SharePoint
- Tin nhắn Microsoft Teams
- Bối cảnh con người và tổ chức
- Kết quả tìm kiếm doanh nghiệp
| A2A | API REST (sắp ra mắt) | MCP | |
|---|---|---|---|
| Sử dụng khi | Một nhân viên khác cần giao nhiệm vụ cho Work IQ và nhận kết quả. | Bạn đang xây dựng một ứng dụng hoặc dịch vụ gọi Work IQ một cách lập trình. | Trợ lý AI (Copilot, Claude, v.v.) cần sử dụng Work IQ như một công cụ hỗ trợ người dùng. |
| Người gọi | Một đặc vụ khác | Ứng dụng hoặc hệ thống phụ trợ của bạn | Một khách hàng dựa trên chương trình LLM |
| Ví dụ | “Nhân viên vận hành của chúng tôi yêu cầu Work IQ điều tra lỗi hồi quy.” | “Ứng dụng web của tôi gửi một câu hỏi đến Work IQ và hiển thị câu trả lời.” | “Người dùng đặt câu hỏi cho Copilot và hệ thống sẽ gọi Work IQ để nhận câu trả lời.” |
Ví dụ về API
Giao thức giữa các tác nhân (A2A)
Sử dụng A2A để cộng tác và phân công nhiệm vụ giữa các tác nhân, trong đó các tác nhân hoạt động tự chủ và trao đổi các nhiệm vụ có cấu trúc thay vì chỉ đơn giản là các lệnh gọi API. Work IQ hỗ trợ cả A2A phiên bản 1.0 và 0.3, được gửi qua A2A-Versiontiêu đề yêu cầu.
Cổng thông tin Work IQ
- Điểm cuối:
https://workiq.svc.cloud.microsoft/a2a/ - Đối tượng khán giả tượng trưng:
api://workiq.svc.cloud.microsoft - Phạm vi:
WorkIQAgent.Ask
Ví dụ yêu cầu đồng bộ ( SendMessage)
POST https://workiq.svc.cloud.microsoft/a2a/
Authorization: Bearer {access-token}
Content-Type: application/json
A2A-Version: 1.0
{
“jsonrpc”: “2.0”,
“id”: “
“method”: “SendMessage”,
“params”: {
“message”: {
“role”: “ROLE_USER”,
“messageId”: “
“parts”: [
{
“text”: “What meetings do I have today?”
}
],
“metadata”: {
“Location”: {
“timeZoneOffset”: -480,
“timeZone”: “America/Los_Angeles”
}
}
}
}
}
Ví dụ về câu trả lời
{
“jsonrpc”: “2.0”,
“id”: “
“result”: {
“task”: {
“id”: “
“contextId”: “ctx-1”,
“status”: {
“state”: “TASK_STATE_COMPLETED”
},
“artifacts”: [
{
“artifactId”: “
“name”: “Answer”,
“parts”: [
{
“text”: “Today you have: 9 AM standup, 11 AM review with Dana, 2 PM customer call.”
}
]
}
]
}
}
}
Cuộc hội thoại nhiều lượt
{
“jsonrpc”: “2.0”,
“id”: “
“method”: “SendMessage”,
“params”: {
“message”: {
“role”: “ROLE_USER”,
“messageId”: “
“contextId”: “ctx-1”,
“parts”: [
{
“text”: “Tell me more about the 2 PM customer call.”
}
]
}
}
}
Đặc điểm chính
- Cần có bao bì JSON-RPC (
jsonrpc,id,method,params) - Gửi yêu cầu POST tới URL cơ sở — tên phương thức nằm trong phần thân yêu cầu, không phải trong đường dẫn URL.
- Hỗ trợ đồng bộ (
SendMessage) - Thông qua nhiều lượt rẽ
contextId Locationsiêu dữ liệu cần thiết cho các truy vấn nhạy cảm về thời gian
Giao thức ngữ cảnh mô hình từ xa (MCP)
Sử dụng MCP để hiển thị ngữ cảnh làm việc của Microsoft 365 dưới dạng công cụ cho trợ lý AI chạy trong môi trường phát triển.
MCP địa phương
Cài đặt Microsoft Work IQ CLI (phiên bản xem trước) và cấu hình nó như một máy chủ MCP cục bộ.
Ví dụ cấu hình máy chủ MCP
{
“workiq”: {
“type”: “stdio”,
“command”: “workiq”,
“args”: [“mcp”]
}
}
Ví dụ về truy vấn dựa trên tác nhân
Lời nhắc
Summarize recent discussions about project risks.
Lời kêu gọi MCP theo khái niệm
{
“tool”: “workiq.search”,
“arguments”: {
“query”: “project risks”,
“source”: “teams”
}
}
Kết quả
{
“results”: [
{
“summary”: “Recent discussions highlighted timeline and dependency risks.”
}
]
}
Đặc điểm chính
- Tối ưu hóa cho IDE và CLI
- Ngữ cảnh được lấy một cách động khi cần thiết.
- Giảm thiểu việc xây dựng lời nhắc thủ công
- Máy chủ đơn với các công cụ tích hợp (sắp ra mắt)
Xác thực và bảo mật
Work IQ sử dụng phương thức xác thực ủy quyền Microsoft Entra ID.
- Các yêu cầu được thực thi trong ngữ cảnh của người dùng đã đăng nhập.
- Các giao dịch thay mặt (OBO) được hỗ trợ.
- Xác thực chỉ dành cho ứng dụng không được hỗ trợ.
- Quyền truy cập, nhãn bảo mật và chính sách tuân thủ của Microsoft 365 được thực thi tự động.
Work IQ sử dụng phương thức xác thực ủy quyền Microsoft Entra ID.
- Các yêu cầu được thực thi trong ngữ cảnh của người dùng đã đăng nhập.
- Các giao dịch thay mặt (OBO) được hỗ trợ.
- Xác thực chỉ dành cho ứng dụng không được hỗ trợ.
- Quyền truy cập, nhãn bảo mật và chính sách tuân thủ của Microsoft 365 được thực thi tự động.
So sánh Work IQ với API Chat của Copilot
Work IQ sẽ là phiên bản nâng cấp sẵn sàng cho môi trường sản xuất của API Copilot Chat. Khi Work IQ được phát hành rộng rãi (dự kiến vào tháng 5), nó sẽ trở thành phương thức được khuyến nghị và hỗ trợ đầy đủ để tích hợp với tác nhân Copilot trong các kịch bản sản xuất. Nó sẽ được hỗ trợ bởi các thỏa thuận mức dịch vụ (SLA) cấp doanh nghiệp, các hợp đồng ổn định và cam kết hỗ trợ dài hạn.
Điều này có nghĩa gì đối với bạn:
- Các dự án mới nên được xây dựng dựa trên Trí tuệ Công việc (Work IQ) ngay từ ngày đầu tiên.
- Các tích hợp hiện có sử dụng API Copilot Chat sẽ tiếp tục hoạt động. API Copilot Chat sẽ vẫn ở chế độ xem trước công khai để thử nghiệm và phát triển giai đoạn đầu, nhưng không nằm trong phạm vi SLA sản xuất.
- Việc chuyển đổi rất đơn giản – Work IQ giữ nguyên các khái niệm bạn đã biết và bổ sung thêm độ tin cậy, quản trị và đảm bảo hỗ trợ cần thiết cho các khối lượng công việc sản xuất.
Chúng tôi khuyên bạn nên lên kế hoạch chuyển sang Work IQ trước khi sản phẩm của bạn được phát hành để tận dụng tối đa sự hỗ trợ sản xuất ngay từ khi ra mắt.
CyberSoft chuyên đào tạo Chuyên Gia Lập Trình, Công Nghệ, Thiết kế, AI theo dự án doanh nghiệp. Học theo dự án thực tế, học từ số zero đi làm, học nâng cấp kỹ năng toàn diện
