重要提示
你需要是边境预览计划的一部分，才能提前访问 Microsoft Agent 365。 边界将你直接与Microsoft最新的 AI 创新联系起来。 边境预览版受客户协议现有预览条款的约束。 由于这些功能仍在开发中，其可用性和功能可能会随时间而变化。
Microsoft Agent 365 SDK 使用企业级标识、可观测性、工具和治理来扩展任何代理堆栈上构建的现有 AI 代理。
使用代理 365 SDK，开发人员可以选择利用代理标识从生产力应用接收和响应通知。 SDK 还允许代理从Microsoft调用受治理和可观察的模型上下文协议（MCP）服务器。 此外，代理可以发出遥测数据，以便 IT 管理员深入了解代理功能和性能。
什么是代理 365 SDK？
Agent 365 SDK 是一个全面的软件开发工具包，可将代理扩展到现有工作流中，同时在需要时仍独立运行。 代理可以具有唯一标识，可以使用常见手势（例如，在用户通常运行的应用（如 @mentions) Teams、Word、Outlook 等）中调用，演示可观察行为、构建信任、采取可审核作以及通过安全访问工具和数据来实现这一切。
代理标识允许对管理员进行封闭的、受监视的访问控制，同时仍为代理提供它需要蓬勃发展的强大功能。 代理通过获取过程获取标识。 在开发生命周期内，开发人员可以使用代理 365 CLI 获取具有所需 MCP 服务器的 Microsoft Entra 应用蓝图，并为从该蓝图创建的所有代理实例创建模板。
通过通知，我们将代理的交互模式更接近于人。 代理可以在生产力应用（如 Teams）的上下文中响应用户，或者在 Word 中对批注做出响应。 代理还可以响应发送到代理邮箱的电子邮件，这些电子邮件将传递到代理托管的通知终结点。 代理还可以参与“获取”和“UnAcquire”等生命周期作，并选择在该时间段内为代理标识设置和清理周期。
代理 365 SDK 基于 Open Telemetry 构建并集成，可捕获每个代理活动的详细遥测数据，包括推理事件、工具使用情况和通知。 管理员能够充分了解代理如何使用 Purview 和 Defender作和与用户、系统和数据进行交互。
代理可以利用 Microsoft MCP 服务器来执行各种方案，例如发送电子邮件、在 SharePoint 中查找文档，以及响应文档中的注释，只需对代理代码进行更改即可。 管理员管理这些 MCP 服务器和日益增多的工具列表，使代理能够在生产力空间中茁壮成长。
代理 365 适用于基于 Microsoft Agent Framework、Copilot Studio、Azure AI Foundry、Semantic Kernel、OpenAI Agents SDK、Claude Code SDK 和 LangGraph 构建的代理。
代理 365 SDK 有何不同？
- 代理 365 SDK 不是代理堆栈。 它不是创建或托管代理的方式，并且与 Microsoft Agent Framework 或 Microsoft Copilot Studio 或 Microsoft Foundry 相反，没有任何业务流程协调程序或工作流管理。
- 它不会替换 Microsoft 365 代理 SDK 及其为托管、活动协议和标识提供的功能。 相反，代理 365 SDK 使用 Microsoft 365 代理 SDK 的包通过活动协议传递通知，并使用代理标识包获取代理的代理令牌（如果适用）。
- 代理 365 要求开发人员从所选代理框架中获取现有代理开始。 然后，他们可以扩展代理，以提供更多的功能，使代理在数字世界中可管理、可观察和更高效。
了解 Agent 365 中代理的蓝图
在创建代理实例之前，了解代理 365 代理蓝图的含义会很有帮助。 蓝图是代理类型的 IT 批准的预配置定义，实质上是创建所有合规代理的企业“模板”。 它定义了代理的功能、所需的 MCP 工具访问、安全性和符合性约束、审核要求、生命周期元数据以及任何链接的治理策略模板，例如 DLP、外部访问限制或日志记录规则。 激活蓝图后，它变得可口可口，这意味着管理员可以在Microsoft 365 管理中心从其中实例化新代理。 每个代理实例都继承其蓝图的规则，确保代理接触的 365 个工作负载跨邮件、日历、Teams 消息、SharePoint 访问和其他任何Microsoft一致的治理。 这会阻止“影子代理”，强制实施可观测性，并将每个代理定位在安全 Entra 支持的标识和权限模型中。
代理 365 代理 SDK 包
在包管理器中找到受支持语言的代理 365 代理 SDK 包。
适用于 Python 的 代理 365 代理 SDK 包位于 Python 包索引（PYPI）
| 打包 | Description |
|---|---|
| microsoft-agents-a365-notifications | AI 代理应用程序的通知和消息扩展。 提供用于处理Microsoft 365 应用程序中不同通道和子通道的代理通知、生命周期事件和路由的实用工具。 |
| microsoft-agents-a365-observability-core | 基于 OpenTelemetry 构建的 AI 代理的遥测、跟踪和监视组件。 为代理调用、工具执行和 LLM 推理提供结构化跨度，并提供上下文传播和可插入导出程序。 |
| microsoft-agents-a365-observability-extensions-agent-framework | Microsoft Agent Framework 的可观测性扩展。 为基于 Agent Framework 的应用程序专门提供 OpenTelemetry 跟踪集成。 |
| microsoft-agents-a365-observability-extensions-openai | OpenAI 代理 SDK 的可观测性扩展。 为基于 OpenAI 代理的应用程序提供 OpenTelemetry 跟踪集成，并为代理工作流和工具调用提供自动检测。 |
| microsoft-agents-a365-observability-extensions-langchain | LangChain 框架的可观测性扩展。 为基于 LangChain 的 AI 应用程序提供 OpenTelemetry 跟踪集成，并为链、代理和工具提供自动检测。 |
| microsoft-agents-a365-observability-extensions-semantic-kernel | 语义内核框架的可观测性扩展。 为基于语义内核的应用程序提供 OpenTelemetry 跟踪集成，并为内核函数、插件和规划器提供自动检测。 |
| microsoft-agents-a365-runtime | AI 代理应用程序的核心运行时实用工具和环境管理。 提供重要的 Power Platform API 发现、环境配置和身份验证范围解析。 |
| microsoft-agents-a365-tooling | MCP（模型上下文协议）工具服务器管理的核心工具功能在使用 Microsoft Agent 365 SDK 生成的应用程序中。 为跨不同 AI 框架发现、注册和管理工具服务器提供了基础。 |
| microsoft-agents-a365-tooling-extensions-agentframework | 用于 AI 代理开发的代理框架特定工具和服务。 提供 MCP（模型上下文协议）工具注册服务，用于将 MCP 服务器动态添加到代理框架代理。 |
| microsoft-agents-a365-tooling-extensions-openai | 适用于 AI 代理开发的 OpenAI 代理 SDK 特定工具和服务。 提供 MCP（模型上下文协议）工具注册服务，用于将 MCP 服务器动态添加到基于 OpenAI 代理的基于 SDK 的代理。 |
| microsoft-agents-a365-tooling-extensions-semantickernel | 用于 AI 代理开发的语义内核特定工具和服务。 提供 MCP（模型上下文协议）工具注册服务，用于将 MCP 服务器动态添加到基于语义内核的代理。 |
| microsoft-agents-a365-tooling-extensions-azureaifoundry | 用于 AI 代理开发的 Azure AI Foundry 特定工具和服务。 提供 MCP（模型上下文协议）工具注册服务，用于将 MCP 服务器动态添加到 Azure AI Foundry 代理。 |
代理 365 代理的高级流
下图演示了相应流。
首先，你已使用编程语言和所选的代理框架构建代理。 然后，可以使用代理 365 SDK 扩展已创建的代理，并添加在平台中运行的专用功能，例如通知、可观测性和工具服务器连接。 如果需要有关如何构建现有代理的示例，快速入门将引导你完成 Microsoft 365 Agents Toolkit for VS Code 中包含的示例代理。 有关示例，请参阅可用的代理 365 快速入门：
- 快速入门：设置并运行 JavaScript LangChain 示例代理
- 快速入门：安装和运行 Python 代理框架示例代理
- 快速入门：设置并运行 JavaScript Claude 代理 SDK 示例代理
可以使用 GitHub 示例中提供的模式来确定代理依赖哪些Microsoft MCP 服务器，配置这些连接，并集成代理 365 组件 - 可观测性、通知和工具服务器连接。
之后，生成一个代理 365 蓝图，该蓝图定义代理的表示方式并连接到平台。 完成蓝图后，请在 Agents Playground 中测试代理。 这为你提供了一个空间来验证通知、试用 MCP 交互，并在部署任何位置之前检查遥测数据。
如果一切正常，请将代理发布到租户。 在此，管理员可以在Microsoft 365 管理中心中启用和管理它。
何时需要代理 365 SDK？
需要以下条件时使用代理 365 SDK：
- 通过安全的 MCP 连接器与 Microsoft 365 数据或工具集成
- 在整个组织中管理和审核多个代理
- 提供企业级遥测和监视
- 为代理交互启用通知
- 在需要可跟踪性和生命周期管理的受监管环境中部署
代理 365 SDK 如何适应代理生态系统
| 层 | 角色 | 提供者 |
|---|---|---|
| 企业功能 | 标识、通知、可观测性、工具 | 代理 365 SDK |
| 代理逻辑 | 提示、工作流、推理 | 测试实现 |
| Orchestrator Runtime | 模型调用和工具业务流程 | 所选框架 |
内容概览
- 跨所有代理的统一标识和治理
- 现用遥测和跟踪
- 保护和管理对 Microsoft 365 工具的访问
- 跨业务流程协调程序和多云支持
- 简化现有代理的升级路径