用途:把 Microsoft Agent 365 可观测性接入已有智能体代码库,不破坏原有核心逻辑。支持 .NET AgentFramework、Node.js、Python 三类智能体。
主要能力:检测智能体类型与认证模式(AI Teammate 为 agentic-user;非 AI Teammate 为 obo 或 s2s);安装统一发行包(.NET:dotnet add package Microsoft.OpenTelemetry;Node.js:npm install @microsoft/opentelemetry;Python:pip install microsoft-opentelemetry,另需 Azure.Identity、msal 等 S2S 依赖);在入口接线可观测性;为消息处理器添加 BaggageBuilder 上下文或 BaggageMiddleware;实现带缓存的应用专用遥测令牌解析器(S2S 路由);添加 InvokeAgentScope、InferenceScope、ExecuteToolScope 手动埋点作用域(商店发布校验要求);更新配置文件并验证构建通过。
使用方式:由触发短语自动激活,例如“add a365 observability to this agent”“set up tracing for this agent”“enable agent 365 telemetry”。执行前需存在 .a365-workspace-detection.local.json 检测缓存;若无智能体代码则先运行 /agent365:make-ai-teammate 或 /agent365:make-a365-agent 脚手架。改动为增量且幂等,可重复运行;唯一例外是替换旧的委托遥测接线。
限制:遥测始终经 S2S 路由以应用专用令牌导出,S2S 拒绝委托(scp)令牌,OBO/Agentic User 令牌仅用于 MCP/Graph 等工作负载调用。部分技术栈(如 Node.js 的 Semantic Kernel、Google ADK,Python 的 LangChain、Claude SDK、CrewAI,.NET 的 Azure AI Foundry)缺少一等自动埋点,需手动用 InferenceScope.start 包裹每次 LLM 调用。.NET 需链式调用 IChatClient.UseOpenTelemetry() 并设置 EnableAgent365Exporter 为 true,否则导出器不生效。启用敏感数据会记录提示与补全,需考虑 PII。具体版本约束与完整包表见各语言参考文档,资料未提供价格与平台信息。