从模型广场到 Agent 上下文：百炼文档能力的一次收敛
百炼平台的能力矩阵在持续扩张——文本生成、推理、视觉理解、图像视频生成、语音合成识别、全模态，模型家族数量与版本迭代速度都在上升。能力越丰富，开发者面临的信息检索面就越大：模型规格在模型广场、API 细节在参考文档、应用开发指南在帮助中心、参数调优在 Playground。
bailian-docs-llm-wiki 是官方 Skills 仓库（modelstudioai/skills）新增的一等公民：把上述所有信息收敛为一个可安装的 Agent Skill，让开发者在 Claude Code、Qwen Code、Cursor 等任意支持 Agent Skills 的环境里，用自然语言完成百炼平台的全部文档查询。
三层架构：官方数据管线的设计
| 层 | 数据来源 | 覆盖内容 |
|---|---|---|
| models/ | 控制台网关 listFoundationModels 接口直拉 | 全部模型家族的上下文窗口、QPM 限流、分档定价、官方示例代码、入参定义 |
| wiki/ | LLM 合成 | 主题页（功能领域聚合）、概念页（RAG/流式/Function Calling 等横切概念）、对比页（同类方案结构化对比） |
| raw/ | help.aliyun.com 官方文档 | 模型/应用使用指南、模型/应用 API 参考 |
架构上有三个值得开发者关注的设计：
结构化优先。models 层不是文档爬取，而是与模型广场同源的接口数据。families.jsonl（一行一家族）与 models.jsonl（一行一模型）支持字段级精确查询，models.jsonl[].family == families.jsonl[].slug 完成两表关联，groups/<slug>.json 提供家族完整明细——包括 samples（curl/Python/Node.js/Java 四语言官方调用示例）与 predictConfig（与 Playground 对齐的入参定义）。
质量兜底。wiki 合成层带质量分机制，低分页面自动绕过、回退 raw 原文，保证答案质量下限。
可信度分级。数据冲突时按 models > raw > wiki 优先级仲裁，并要求回答附引用文件路径——反幻觉约束直接写入 Skill 规则。
快速上手
npx skills add modelstudioai/skills
Node.js ≥ 18，交互式选择 bailian-docs-llm-wiki 安装，零配置——Skill 声明了激活条件，涉及百炼文档、模型、定价的提问自动触发。查询本身不消耗 API 调用；配合模型实跑需要 API Key，新用户注册即有免费额度：创建 API Key。
典型查询场景：
qwen3-max 输入输出分别多少钱？限流多少？
→ 分档价格 + QPM + 上下文窗口，附 models/groups/ 来源路径
支持 function calling、上下文 ≥ 128K 的文本模型有哪些？
→ models.jsonl 字段级筛选，模型广场 UI 不具备的跨家族查询能力
用 OpenAI 兼容接口调 qwen3-max 的 Python 示例？temperature 取值范围？
→ samples + predictConfig 字段直出
命令行用户可绕过 Agent 直接查询结构化数据（官方文档示例）：
jq -c 'select(.contextWindow>=1000000)' models.jsonl
生态协同：Skills 矩阵的数据复用
bailian-docs-llm-wiki 的价值不止于单点查询，更在于它是官方 Skills 生态的数据底座：
- bailian-model-recommend（同仓库）：读取同一份 models/ 数据做模型选型——描述业务场景，返回推荐模型与可运行示例代码，实现“查询 → 选型 → 上手”闭环
- bailian-cli（modelstudioai/cli）：面向终端工作流的
bl命令行工具，覆盖百炼全模态能力，适合把查到的模型能力接入脚本化/批量化场景
这套组合意味着开发者的完整工作流——了解平台能力、选择模型、获取示例、运行验证——可以全程不离开 Agent 环境完成：示例代码由 Coding Agent 直接运行验证，通过后集成进工程。
使用边界说明
- 本地数据为安装时快照，重跑安装命令即可更新至仓库最新数据（非实时推送）
- Skill 范围严格限定百炼平台文档与模型数据，范围外问题拒答而非猜测
- wiki 合成层可能滞后于最新文档，关键决策建议按引用路径核对 raw 原文
对于正在评估或已在使用百炼平台的团队，这个 Skill 将文档检索成本压缩到了一次对话的量级。从免费额度开始体验：百炼平台入口。
