本文回答了关于Agent 365 SDK的常见问题:它的功能和功能不存在、何时需要、可用功能、身份如何工作,以及如何验证集成。
范围与定位
我可以用 Agent 365 SDK 构建代理吗?
No. SDK 不是一个代理构建框架。 用你选定的框架构建代理,然后用 Agent 365 SDK 将其导入 Agent 365。 参见 “何时使用Agent 365 SDK”。
SDK 是调用语言模型还是协调步骤?
No. 你的代理继续自己调用模型,编排则留在你的框架或运行时。 参见 Agent 365 SDK和代理生态系统。
SDK是托管还是部署我的代理?
No. 你的经纪人今天会跑到哪里就跑哪儿。 参见《 Agent 365 SDK 有何不同?》。
SDK会执行我代理的工具调用吗?
No. SDK寄存器用于管理模型上下文协议(MCP)服务器;执行会留在运行时。 参见 Agent 365 SDK和代理生态系统。
SDK 能取代我的代理框架吗?
No. 保留你的模型、框架或运行时,并保留主机。 SDK与它们并行运行,增加了身份识别、可观察性、工具和通知功能。 关于层层边界,请参见 Agent 365 SDK 概述。
Agent 365 SDK 与 Microsoft 365 智能体 SDK 有何不同?
Microsoft 365 智能体 SDK构建对话代理,处理通道连接和会话状态。 Agent 365 SDK 是对你已经构建的代理的扩展。 两者协同工作。 参见 Agent 365 SDK概述。
SDK 支持哪些语言?
Python、JavaScript 和 .NET。 参见 Agent 365 SDK 包。
选择集成机制
我需要SDK吗?
并非总是如此。 如果内置集成或注册表同步已经满足代理所需的功能,你可能就不需要 SDK。 参见 “选择你的集成选项”。
内置集成什么时候才算足够?
当平台路径已经提供了你场景所需的Agent 365功能时, Copilot Studio 和 Azure AI Foundry 可以属于这一类,但支持取决于代理的构建、认证和托管方式。 拥有或部署代码本身并不一定需要SDK。 参见 Compare Agent 365整合机制。
注册表同步和SDK集成有什么区别?
注册同步通过平台级配置将来自连接代理平台(如 Google Vertex AI 和 Amazon Bedrock)的代理带入 Agent 365。 SDK 集成是针对你用代理 SDK 或框架构建的代理,它能提供代码层级的控制。 参见 Compare Agent 365整合机制。
我的代理运行在Azure之外。 我还能用SDK吗?
Yes. SDK 不会改变你的代理运行位置。 它支持托管在 Azure、AWS、Google Cloud 或本地端的代理。 参见 Agent 365 代理开发生命周期。
能力
我必须同时采用这四项能力吗?
没有,但它们有先修课程。 代理身份蓝图支撑着身份、工具和通知功能,通知还需要代理用户账户,而该账户仅对参与Frontier预览计划的租户开放。 可观测性也适用于标准的 Microsoft Entra 应用注册。 除此之外,可以按任意顺序添加功能。 参见 “验证通知”。
我应该从哪个能力开始?
我的遥测数据去哪儿了?
代理跨度出现在 Microsoft Defender、Microsoft Purview 和 Microsoft 365 管理中心 中。
有两种情况会让遥测看起来像消失了,尽管摄取会返回HTTP 200。
如果租户中没有用户分配了 Microsoft 365 E7 或 Microsoft Agent 365 许可证,整个请求将被放弃。
如果跑道根无有效invoke_agent跨度,Defender 高级狩猎中仍可查询跨度,但不出现在这三种曲面中。
查看 你的数据显示在哪里 ,以及 限制和丢弃条件。
什么是工作 IQ?
Work IQ 是一组受管控的 MCP 服务器,将 Microsoft 365 工作负载(如邮件、日历、Word、SharePoint 和 Teams)暴露给你的代理,由管理员控制。 Work IQ MCP 处于预览阶段,需要 智能 Microsoft 365 Copilot 副驾驶® 许可证。 参见 “验证工具”。
支持哪些通知源?
Identity
我的经纪人需要自己的身份吗?
每个Agent 365集成都需要一个身份模型,但这并不总是意味着给Agent单独的用户账户。 代理可以使用 S2S 作为代理身份,OBO 代表登录用户,或 Agentic-User 通过自己的Microsoft Entra用户账户行动。 选择与代理工作、权限和所需 Microsoft 365 资源匹配的模式。 参见 代理身份。
代理身份蓝图和代理身份有什么区别?
蓝图是可复用的模板,用于存储某种代理的凭证和声明权限。 代理身份是个体代理认证的账户。 一份蓝图可以创建许多代理身份。 参见 身份对象 和 S2S,蓝图衍生代理身份。
我的代理人的资质存储在哪里?
在蓝图上,而不是特工身份上。 由于被攻破的蓝图会影响所有由其创建的代理,因此将蓝图数量视为安全边界的决策。 参见 代理身份。
我应该制作多少份蓝图?
根据需要,保持凭证和权限的界限分开。 仅组的代理身份,可以安全地共享蓝图的凭证和继承权限。 参见 身份基础 和 S2S,蓝图衍生代理身份。
我应使用哪个权限模型?
服务对服务工作的应用权限,代理以自身权限进行操作。 委托权限用于工作,代理处理已登录用户的权限和上下文。 参见 代理身份。
我的代理需要Microsoft 365许可证吗?
只有当它拥有代理的用户账户,并且需要Teams、Exchange或SharePoint等服务时才会这样做。 拥有自己用户账户的代理仅对 Frontier 预览计划中的租户开放。 租户级许可仍然适用于其他功能:除非租户中至少有一名用户分配了 Microsoft 365 E7 或 Microsoft Agent 365 许可证,否则遥测服务将被取消;而 Work IQ MCP 则需要 智能 Microsoft 365 Copilot 副驾驶® 许可证。 参见 代理用户账户、 验证身份、 验证可观察性和 验证工具。
为什么我的经纪人邮箱还没收到?
资源配置可能会延迟授权分配。 请参阅 Agent 365 SDK 验证检查表 以了解预期时序。
什么是赞助商?
设置与技能
什么是365号特工技能?
一种让编码助理,比如 GitHub Copilot CLI,帮你完成集成步骤的方法。 参见 365号特工技能。
是什么取代了 instructions.md 设置的工作流程?
Agent 365 Skills 取代了该工作流程。 改用技能。
如果你的编码助手暴露了内部的“验证与诊断”功能,你可以让它验证 Agent 365 的集成;它在内部 a365-code-validator也被称为。
可用性取决于助理和已安装的技能包。 参见 365号特工技能。
我必须用技能吗?
No. 你可以手动完成每一步。 技能适合标准配置和可重复的入职流程;手动设置适合非标准环境和故障排除。 查看 何时使用技能。
一个技能多次运行安全吗?
Yes. 技能是累积且幂零的,因此完成的步骤会被跳过而非重复。 参见 安全性与重复性。
一个技能似乎跳过了一步。 这是个问题吗?
通常不会。 技能可以跳过已经配置好的任务。 如果你想确认,可以重新运行具体技能,并明确说明结果。 参见 安全性与重复性。
我可以在部署到云端之前先测试一下吗?
在AI队友路线上,是的。
该 test-local 技能会让你的探员与本地测试线束Agents Playground一起进行烟雾测试。
Agents Playground 是通过代理消息终端连接的,所以不适用于标准代理。
参见《特工游乐场》中的七项技能与测试特工。
Validation
我怎么确认集成是否有效?
按照 Agent 365 SDK验证清单操作。
我的经纪人整合后表现不同。 出了什么问题?
SDK 是扩展你的代理,而不是替换它的任何部分。 部署前调查任何行为变化:生成代码、依赖冲突、配置和SDK兼容性都是可能的原因。 从 验证现有行为开始。