用途:面向阿里云 PAI-Rec(可编程推荐系统)引擎,提供接口问题诊断与引擎配置校验两类能力。架构涉及 PAI-EAS 服务、PAI-Rec 引擎、引擎配置管理与服务日志。
主要能力:一是接口诊断,当引擎 API 返回错误或异常结果时,通过 request_id 检索 EAS 服务日志,结合引擎配置与实验覆盖配置定位原因;二是配置校验,分析引擎配置文件的结构与引用一致性,发现潜在问题。
使用方式:需 Aliyun CLI >= 3.3.3,可用 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 安装或更新;执行 aliyun configure set --auto-plugin-install true 与 aliyun plugin update。凭证须在会话外配置,仅用 aliyun configure list 检查状态,禁止读取或回显 AK/SK。诊断流程包括:describe-service 获取服务信息与 CONFIG_NAME,从响应取 request_id,用 describe-service-log 配合 --keyword <request-id> 与 --page-size 500 检索日志(禁止本地过滤,检索业务日志时不要传时间范围),再用 list-engine-configs 与 get-engine-config 获取配置,必要时按 experiment_id 查询实验组与实验配置。配置校验流程为列出配置版本、获取配置详情、运行 scripts/validate.py 做 Schema 与引用规则校验。所有云 API 命令须带 --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-rec-diagnosis/{session-id},并先创建会话工作目录。
限制:所有参数须与用户确认,不得擅自使用默认值;配置可能含明文凭证,展示前须经 sanitize_config.py 脱敏;诊断结论只能基于日志与配置证据,不主动给出修复建议;权限不足时需按 references/ram-policies.md 申请权限。具体脚本细节与完整参数以官方资料为准。