Microsoft Agent 365 SDK 将你已经拥有并运行的代理连接到 Microsoft Agent 365。 用于代码层级访问代理身份、受控的 Work IQ 工具或通知等功能。
SDK的定位
集成模型展示了内置集成、注册表同步与开发者集成的 Agent 365 SDK 场景之间的边界。
内置 Agent 365 集成的平台上的代理，以及通过注册同步导入的代理，已经可以显示在 Agent 365 清单中。 SDK集成可以提供平台路径无法提供的功能，比如Work IQ工具或通知。 平台集成会不断演变，因此在更改集成前请确认当前的平台指南。 参见 “选择你的集成选项”。
Agent 365 功能如何协同工作
Agent 365 开发者集成提供四项功能。 Agent 365 SDK 提供身份、工具和通知功能。 Microsoft OpenTelemetry 提供可观测性：
| 能力 | Description |
|---|---|
| 身份 | 使用Microsoft Entra支持的代理身份以实现安全认证和对工具和数据的受控访问。 需要自己用户账户和邮箱的代理仅对参与 Frontier 预览计划的租户开放。 |
| 可观察性 | 使用独立的 Microsoft OpenTelemetry 发行版，发送产生审计的可追溯交互、推理事件和工具使用情况的遥测数据。 |
| 工具 | 调用受管控的 Work IQ 模型上下文协议（MCP）服务器，以在管理员控制下访问 Microsoft 365 工作负载，如邮件、日历、Word、SharePoint 和 Teams。 |
| 通知 | 像人类参与者一样，在 Microsoft 365 应用中接收并回复来自 Teams、Outlook、Word 评论和电子邮件的消息。 该功能需要代理的用户账户，仅对参与 Frontier 预览计划的租户开放。 |
Important
不要使用 已淘汰的Agent 365 Observability SDK 来进行新的可观测性集成。 使用Microsoft OpenTelemetry发行版。 继续使用 Agent 365 SDK 包来管理身份、工具链和通知。
选择符合代理需求的能力，而不是采用整个 SDK 全部接口。 身份、工具和通知都以代理身份蓝图作为其 Entra 基础。 通知也需要代理用户账户。 Microsoft OpenTelemetry 可以使用代理身份蓝图或标准的 Microsoft Entra 应用注册。
该SDK以按语言划分的软件包形式提供，适用于Python、JavaScript和.NET。 安装与你所选功能对应的软件包，然后配置相应的身份、权限和运行时集成。 有关可用的软件包，请参见 Agent 365 SDK 套件。 单独安装 Microsoft OpenTelemetry 以实现新的可观测性集成。
比较 Microsoft Agent 365 SDK 与 Microsoft 365 智能体 SDK
Microsoft Agent 365 SDK 和 Microsoft 365 智能体 SDK 是不同的产品。
| Microsoft Agent 365 SDK（此 SDK） | Microsoft 365 智能体 SDK |
|---|---|
|
无法生成代理。 扩展已存在的代理，添加身份、工具和通知。 使用Microsoft OpenTelemetry来增加可观测性。 |
构建对话代理的框架。 处理跨渠道（如 Teams 和 Microsoft Copilot）的消息传递，并管理对话状态。 |
这些 SDK 是协同工作的。 你可以用 Microsoft 365 智能体 SDK 构建代理，使用 Agent 365 SDK 用于身份、工具和通知，并使用 Microsoft OpenTelemetry 进行可观测性管理。
它是什么以及不是什么
你继续拥有让代理运作的三层：
| 层 | Description |
|---|---|
| 型号 | 你的代理人调用的语言模型或推理引擎。 SDK不会调用或选择模型。 |
| 框架或运行时 | LangChain、Microsoft Agent Framework、语义内核、OpenAI Agents SDK、Claude Agent SDK 或自定义代码。 SDK不构建代理、规划或编排步骤，也不执行工具。 |
| Host | 无论代理目前运行在哪里，比如Azure、AWS、Google Cloud或本地部署。 SDK不会托管或部署你的代理。 |
Microsoft Agent 365 SDK 运行于这些层级。 它不构建、托管、部署、编排或执行代理。
Note
Microsoft Agent 365 SDK 会注册受管控的 MCP 服务器，这样你的 Agent 就能访问 Microsoft 365 工作负载，但你的运行时仍然执行工具调用。
入职流程
整合分为四个阶段：
| 阶段 | Description |
|---|---|
| 1. 注册 | 在 Microsoft Entra 中创建代理身份蓝图和代理身份。 |
| 2. 扩展 | 添加你的客服所需的功能。 可以使用 Agent 365 SDK for Work IQ 工具或通知，并使用 Microsoft OpenTelemetry 进行可观测性。 |
| 3. 验证 | 像之前一样运行代理，确认其身份、遥测数据、工具访问和消息处理。 |
| 4. 操作 | 使用Agent 365控件来管理和审计连接的agent。 |
您可以手动完成这些步骤，也可以使用支持的编码助理提供的 Agent 365技能 。 Skills 会引导完成设置，进行必要的修改，并验证结果。
请求如何流转
单次互动可以同时使用这四种功能。 当某人在 Word 批注中 @mentions 你的代理时：
- 通知会将提及传达给你的坐席。
- 身份和认证决定代理是以自身身份行事、代表已登录用户行事，还是通过代理用户账户行事。 所选模式、权限、同意和令牌主体定义了可用的数据和操作。
- 工具赋予代理对其所需Microsoft 365数据的受控访问权。
- 可观测性记录调用、工具调用和模型推理。
你的代理随后在评论区回复。
Agent 365 SDK 套件
在支持语言的包管理器中找到 Agent 365 SDK 包。
Important
下表中的可观测性包已被弃用。 不要将它们用于新的集成项。 在迁移现有集成之前，请使用 Microsoft OpenTelemetry Distro，或者先查看 已弃用的 Agent 365 Observability SDK 文档。
你可以在Python包索引（PYPI）中找到Python的Agent 365 SDK包。
| Package | Description |
|---|---|
| microsoft-agents-a365-notifications | AI 代理应用程序的通知和消息扩展。 提供用于处理Microsoft 365应用程序中不同通道和子通道的代理通知、生命周期事件和路由的实用工具。 |
| microsoft-agents-a365-observability-core | 已弃用：基于OpenTelemetry构建的AI代理的遗留遥测、追踪和监控组件。 提供用于代理调用、工具执行和 LLM 推理的结构化区间，同时实现上下文传播和可插入的导出模块。 建议使用Microsoft OpenTelemetry Distro。 |
| microsoft-agents-a365-observability-extensions-agent-framework | 已弃用：针对Microsoft Agent Framework的遗留可观察性扩展。 为基于 Agent Framework 的应用程序专门提供 OpenTelemetry 跟踪集成。 建议使用Microsoft OpenTelemetry Distro。 |
| microsoft-agents-a365-observability-extensions-openai | 已弃用：OpenAI Agents SDK 的遗留可观测性扩展。 为基于 OpenAI 代理的应用程序提供 OpenTelemetry 跟踪集成，并为代理工作流和工具调用提供自动检测。 建议改用Microsoft OpenTelemetry Distro。 |
| microsoft-agents-a365-observability-extensions-langchain | 已弃用：LangChain框架的遗留可观测性扩展。 为基于 LangChain 的 AI 应用程序提供 OpenTelemetry 跟踪集成，并为链、代理和工具提供自动检测。 建议使用Microsoft OpenTelemetry Distro。 |
| microsoft-agents-a365-observability-extensions-semantic-kernel | 已弃用：语义内核框架的遗留可观察性扩展。 为基于语义内核的应用程序提供OpenTelemetry跟踪集成，并为内核函数、插件和规划器提供自动化工具。 建议改用Microsoft OpenTelemetry Distro。 |
| microsoft-agents-a365-runtime | AI 代理应用程序的核心运行时实用工具和环境管理。 提供重要的 Power Platform API 发现、环境配置和身份验证范围解析。 |
| microsoft-agents-a365-tooling | 使用 Microsoft Agent 365 SDK 构建的应用程序中，MCP（模型上下文协议）工具服务器管理的核心工具功能。 为跨不同 AI 框架发现、注册和管理工具服务器提供了基础。 |
| microsoft-agents-a365-tooling-extensions-agentframework | 用于 AI 代理开发的代理框架特定工具和服务。 提供 MCP（模型上下文协议）工具注册服务，用于将 MCP 服务器动态添加到代理框架代理。 |
| microsoft-agents-a365-tooling-extensions-openai | 适用于 AI 代理开发的 OpenAI 代理 SDK 特定工具和服务。 提供 MCP（模型上下文协议）工具注册服务，用于将 MCP 服务器动态添加到基于 OpenAI Agents SDK 的代理。 |
| microsoft-agents-a365-tooling-extensions-semantickernel | 用于AI代理开发的语义内核特定工具和服务。 提供 MCP（模型上下文协议）工具注册服务，用于将 MCP 服务器动态添加到基于语义内核的代理。 |
| microsoft-agents-a365-tooling-extensions-azureaifoundry | Azure AI Foundry AI 代理开发的特定工具和服务。 提供 MCP（模型上下文协议）工具注册服务，用于将 MCP 服务器动态添加到Azure AI Foundry代理。 |