用途:对现有 Agent 365 智能体代码做“报告优先”的校验,回答“若现在运行,span 能否到达 A365 后端并具备 MAC Activity 资格”,面向故障排查。
主要能力:检查导出器已配置但未真正启用;gen_ai.agent.id 误填 Blueprint ID 而非运行时 Agent Identity;只有通用 HTTP/OpenAI span 而缺少 A365 语义操作;委托(OBO)遥测缺少 S2S 路由标志或把 OBO/Agentic User 令牌喂给导出器;缺少令牌解析器或 S2S 令牌形态错误;本地 Blueprint ID 过期、缺少权限或租户内实例未注册;以及把 MAC 上报预期与原始摄取成功混淆。
使用方式:按阶段执行。先展示任务清单,再检测技术栈与 A365 工件(如 a365.config.json、.env、package.json、requirements.txt、*.csproj 等),随后运行静态校验器。插件源方式:node ${CLAUDE_PLUGIN_ROOT}/hooks/stop/validate-a365-code-validator.js;无法展开变量时用绝对路径;开放标准安装用 node .agents/skills/a365-code-validator/references/a365-code-validator.js。解析 JSON 输出并按 critical/high/medium/low 分级。之后检查身份绑定与语义 span,必要时用只读 Graph 命令核对 Blueprint 权限:a365 query-entra blueprint-scopes、a365 query-entra inheritance(可加 --agent-name 与 --tenant-id)。
适用场景:Agent 365 智能体遥测缺失、Agent Activity 为空、导出器标志或 span 类型异常等事件响应。
限制:校验阶段不修改源码;报告须支持安全,不打印内部集群/数据库名、Kusto 查询、私有端点或路由模板、关联 ID 及真实租户/智能体 ID。校验器不得安装或更新 CLI、发起交互式登录、运行 a365 setup permissions 或发出 Graph 写请求;缺少前置条件时报告“未检查”并给出命令。Blueprint 权限继承的表述需谨慎,不宣称应用角色绝不能继承。资料未提供具体收费、价格与平台支持信息。