From 0d1a9dd188e9abf39a1bbf0d43d061d6f0e05f92 Mon Sep 17 00:00:00 2001 From: yumoqing Date: Sat, 5 Sep 2026 23:33:21 +0800 Subject: [PATCH] =?UTF-8?q?docs(skill):=20=E7=AB=AF=E7=82=B9=E5=8D=8F?= =?UTF-8?q?=E8=AE=AE=E6=84=9F=E7=9F=A5404=E6=A0=B9=E5=9B=A0=E9=93=BE+?= =?UTF-8?q?=E6=9C=BA=E5=88=B6=E4=BF=AE=E5=A4=8D=E6=B8=85=E5=8D=95=E5=85=A5?= =?UTF-8?q?=E6=8A=80=E8=83=BD=E2=80=94=E2=80=94compatible-mode=E4=B8=8Eapi?= =?UTF-8?q?/v1=E4=B8=8D=E5=8F=AF=E4=BA=92=E6=8D=A2/=E8=B4=A6=E5=8F=B7?= =?UTF-8?q?=E7=BB=91=E5=AE=9A=E8=87=AA=E6=A3=80/=E6=9F=A5=E8=AF=A2?= =?UTF-8?q?=E6=A8=A1=E6=9D=BF=E6=8E=92=E9=99=A4/base=5Furl=E7=A6=81?= =?UTF-8?q?=E8=A3=B8=E5=9F=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../common/model-auto-config/SKILL.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md b/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md index d1a5174..50d8216 100644 --- a/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md +++ b/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md @@ -91,6 +91,33 @@ tools: [fetch_model_doc, extract_llm_api_spec, apply_llm_config, apply_model_pri - 模板渲染失败**不要**手工拼模板内容找用户确认方案——修正规格（补 request_example）重新 extract→apply 即可，全链幂等；旧坏模板会被自动弃用重建 +## 端点协议感知（2026-09-05 404 实测教训） + +**症状**：dashscope_async 原生模型 test_model_call 报「异步任务提交失败 HTTP 404」， +但模板渲染正常。 + +**根因链**（三个环，缺一环都不 404）： +1. 供应商同时挂两类端点：`compatible-mode/v1`（openai_compat 对话用）与 + `api/v1`（原生异步生成用），路径前缀不同、**不可互换** +2. 账号「选用端点」只绑了 compatible-mode → 原生模型运行时被拼到 + `compatible-mode/v1/services/aigc/...` → 404 +3. 查询模板 path 带了 `/api/v1` 前缀，与端点 base_url 重复拼接 → 双前缀 404 + +**机制修复**（已内置，无需人工）： +- 端点落库带 `protocol` 标签；裸域 base_url（无路径段）自动拦截不入目录 +- `_pick_candidate` 协议感知：模型模板 protocol 与端点标签匹配才可用； + 有匹配端点时**只选匹配项**（不匹配/未标注的都排除） +- apply 自检：活跃账号未绑本协议端点 → 自动补绑并报 `account_notes` +- 运行时 `_join_url` 拼接去重：path 带 base_url 已有前缀时不重复拼 +- 提交模板复用查询排除 `%-query-%`/`%-download-%`（步骤模板同库同协议同能力， + 不排除会被误选为提交模板 → 提交打到查询 path → 404） + +**给内部 agent 的规则**： +- base_url 必须取文档示例 URL 除接口路径外的**完整前缀**（含 /api/v1 等路径段）， + 裸域必 404；提取提示词已强调，若仍提成裸域用 overrides.base_url 纠正 +- 报 404 先看 apply 返回的 `account_notes`（账号绑定问题）与端点标签 + （供应商端点问题），不要重跑模板——模板渲染崩与端点 404 是两类病 + ## 定价（2026-09-05 新模式：一模型一方案，无 model 维度，无 filters） llm_model 的 price_input/price_output/cost_input/cost_output 四字段已删除。