by 运行时依赖
安装命令
点击复制技能文档
PAI-Rec 引擎诊断和配置验证 本技能为阿里云 PAI-Rec（可编程推荐系统）引擎提供了全面的诊断和验证能力，包括接口故障排除和配置分析。
场景描述 PAI-Rec 是阿里云的可编程推荐系统，提供智能推荐能力。本技能帮助用户：
诊断 PAI-Rec 引擎接口问题：当引擎 API 返回错误或意外结果时，通过 EAS 服务日志和引擎配置跟踪请求以确定根本原因。 验证引擎配置：在部署前分析引擎配置文件以查找潜在问题、不一致性或配置错误。 架构：PAI-EAS 服务 + PAI-Rec 引擎 + 引擎配置管理 关键组件 PAI-EAS 服务：托管推荐引擎的弹性算法服务 PAI-Rec 引擎：处理请求的推荐引擎 引擎配置：定义引擎行为的配置文件 服务日志：包含请求跟踪的 EAS 服务日志
安装预检查：Aliyun CLI >= 3.3.3 必须 运行 aliyun version 验证 >= 3.3.3。如果未安装或版本过低，运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 安装/更新，或者参阅 references/cli-installation-guide.md 获取安装说明。
预检查：Aliyun CLI 插件更新必须 [MUST] 运行 aliyun configure set --auto-plugin-install true 启用自动插件安装。 [MUST] 运行 aliyun plugin update 确保任何现有插件都保持最新。
身份验证预检查：阿里云凭据必须 安全规则： NEVER 读取、回显或打印 AK/SK 值（例如，echo $ALIBABA_CLOUD_ACCESS_KEY_ID 是禁止的） NEVER 要求用户在对话或命令行中直接输入 AK/SK NEVER 使用 aliyun configure set 以明文凭据值 ONLY 使用 aliyun configure list 检查凭据状态 aliyun configure list 检查输出是否有有效的配置文件（AK、STS 或 OAuth 身份）。如果没有有效的配置文件，停止这里。 从阿里云控制台获取凭据 在此会话外配置凭据（通过 aliyun configure 在终端或 shell 配置文件中的环境变量） 返回并重新运行，直到 aliyun configure list 显示有效的配置文件
RAM 策略 [MUST] 权限失败处理：在执行过程中，如果由于权限错误导致任何命令或 API 调用失败，请遵循此过程： 阅读 references/ram-policies.md 以获取此 SKILL 所需的全部权限列表 使用 ram-permission-diagnose 技能指导用户请求必要的权限 暂停并等待用户确认已授予所需的权限 有关此技能所需的详细 RAM 策略，请参阅 references/ram-policies.md。
参数确认 重要：参数确认 — 在执行任何命令或 API 调用之前，所有用户可自定义的参数（例如 RegionId、服务名称、实例 ID、环境名称、配置名称等）必须与用户确认。不要假设或在没有用户明确批准的情况下使用默认值。
必需参数 参数名称 必需/可选 描述 默认值 service-name 必需 PAI-EAS 服务名称 N/A cluster-id 必需 EAS 集群/区域 ID N/A instance-id 必需 PAI-Rec 实例 ID N/A request-id 必需（用于诊断）引擎 API 响应中的请求 ID N/A config-name 可选 引擎配置名称 N/A environment 可选 引擎环境（Prod/Pre） N/A engine-config-id 可选 具体引擎配置版本 ID N/A region 可选 阿里云区域 N/A
核心工作流 在核心工作流开始之前（在任何 CLI 调用之前）： [MUST] 启用 AI 模式 — AI 模式是 Agent Skill 执行所必需的。运行以下命令： aliyun configure ai-mode enable aliyun configure ai-mode set-user-agent --user-agent "AlibabaCloud-Agent-Skills/alibabacloud-pai-rec-diagnosis" [MUST] 在每个退出点禁用 AI 模式 — 在任何原因下交付最终响应之前，始终先禁用 AI 模式。这适用于所有退出路径：工作流成功、工作流失败、错误/异常、用户取消、会话结束或任何其他不再执行 CLI 命令的场景。AI 模式仅用于 Agent Skill 调用场景，且必须在技能停止运行后禁用。 aliyun configure ai-mode disable
工作流 1：PAI-Rec 引擎接口诊断 此工作流有助于诊断 PAI-Rec 引擎 API 返回错误或意外结果时的问题。 输入示例： 服务名称：embedding_recall API 响应：{ "code": 299, "msg": "items size not enough", "request_id": "941b4e14-d1c5-489f-a184-b2b17f8b4fdb", "size": 0, "experiment_id": "", "items": [] } 步骤 1：检索 EAS 服务信息 获取服务详细信息...