bailian-model-recommend

---
name: bailian-model-recommend
description: >-
license: Apache-2.0
---

# 百炼模型推荐

从阿里云百炼平台模型库中，根据用户场景推荐最合适的模型并提供调用示例代码。

## 适用场景

**显式选型：**
- "推荐一个模型"、"选哪个模型"、"用什么模型好"
- "帮我对比一下XX和XX模型"

**隐式选型（用户描述想做的事，隐含需要选模型）：**
- "我想做一个XX"（客服机器人、翻译工具、代码助手...）
- "帮我实现XX功能"（图片生成、语音合成、文本摘要...）
- "怎么用 AI 来做XX"、"大模型能做XX吗"
- "XX场景有什么方案"、"我想接入XX能力"

**技术选型：**
- "XX和XX哪个更适合做YY"
- "低成本/高并发/高精度 场景怎么选"

**不适用：**
- 用户已确定模型，只问怎么调用 → 直接给调用代码
- 纯粹查询模型参数/价格 → 使用 bailian-docs-llm-wiki skill

**与 bailian-docs-llm-wiki 的边界：** 当用户同时涉及模型查询和模型选择时，优先使用本 skill（本 skill 内部会读取模型数据完成推荐）。仅当用户已确定模型、只需查参数/价格/调用方式时，由 bailian-docs-llm-wiki 处理。

## 前置检查

执行推荐前确认依赖的 `bailian-docs-llm-wiki` skill 已安装且数据可用。

**检测逻辑：**

1. 检查 `bailian-docs-llm-wiki` skill 是否已安装（通过查找已安装 skill 目录中是否存在 `bailian-docs-llm-wiki/models/models.jsonl`）
2. 如果未安装，执行安装：`npx skills add modelstudioai/skills --skill bailian-docs-llm-wiki -y`

安装失败则告知用户并中止。**禁止在没有数据的情况下凭记忆推荐模型。**

## 推荐流程

### 第一步：理解需求（Agent 直接完成，不输出给用户）

从用户描述中快速提取结构化需求信息。JSON 结构定义见 [references/requirement-schema.md](references/requirement-schema.md)，推断规则见 [references/capability-codes.md](references/capability-codes.md)。

**要快：** 简单字段映射，不做复杂推理。如果需求不清晰，直接追问具体场景，不输出中间分析。

### 第二步：筛选候选

从 `models/models.jsonl` 和 `models/groups/<slug>.json` 中综合筛选匹配的模型（10~50 个），结构化字段和语义信息同时参与筛选：

1. 去除历史快照版本（如 `model-2025-04-28`），只保留主版本
2. 按模态过滤（输入/输出模态必须兼容）
3. 按能力、特性、上下文窗口、质量定位评分排序
4. 读取 group 文件的 description（group 级 + item 级），将场景关键词（如"科研"、"代码"、"长文本"、"客服"）与用户需求做语义匹配，提升匹配模型的排序
5. 同一家族最多保留少量模型，避免同质化
6. 候选不足时放宽过滤条件

数据源字段说明见 [references/data-source.md](references/data-source.md)。

### 第三步：精选推荐

从候选列表中选出 3 个推荐：

| 位置 | 策略 |
| --- | --- |
| 推荐 #1（最佳推荐） | 最符合用户预算和质量偏好的最佳模型 |
| 推荐 #2（次优选择） | 另一个档次的模型，说明与 #1 的 tradeoff |
| 推荐 #3（备选参考） | 不同视角的选择，说明场景差异 |

**排序逻辑：**

- 用户要省钱 → #1 必须是性价比最高的，不是旗舰
- 用户要最好 → #1 必须是能力最强的旗舰
- 用户无倾向 → #1 选综合匹配度最高的
- 推荐最适合场景的，不是最强的；偏好从用户表达中推断，不预设倾向

**约束：**

- 理由必须关联用户具体需求（禁止"性能强大"等空话），三条理由角度不同
- 有定价信息时结合预算权衡，帮用户做成本决策
- 避免推荐同家族多个模型，优先稳定版本
- 提供多档次选择和 tradeoff 说明，由用户自己决定

**pipeline 场景：** 相邻步骤的模型模态必须兼容，不兼容时添加提示。

### 第四步：输出推荐结果

对每个推荐模型，读取对应的 group JSON 文件（`models/groups/<slug>.json`）获取 `samples` 字段中的调用示例代码。示例代码获取方式和输出格式见 [references/samples-format.md](references/samples-format.md)。

用自然语言直接输出推荐（如"根据你的需求，我推荐以下模型..."），每个模型包含：

1. **模型名称和 ID**
2. **推荐理由** — 关联用户具体需求，附 tradeoff 对比
3. **亮点** — 关键优势标签
4. **规格信息** — 上下文窗口、最大输出、定价（如有）
5. **调用示例代码** — 从 group 文件的 samples 字段获取（优先 openai.python，同时提供 curl）

**输出约束：**

- 不暴露内部流程术语（禁止出现"Stage"、"意图画像"、"候选召回"、"精排"等词汇）
- 所有推荐基于 `bailian-docs-llm-wiki` 的实际数据，不凭记忆推荐