通义千问 OpenAI 兼容对话
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/qianwen-ai-qianwen-ai-text。
技能介绍
要解决什么问题
很多 Agent 和脚本已经按 OpenAI Chat Completions 习惯写好了请求体、流式处理和错误处理。若要把后端换成通义千问,往往需要改 endpoint、字段名和鉴权方式,还要单独维护一套调用脚本。这个技能把「用千问做文本对话」收敛成一条可执行路径:在技能目录里用绝对路径跑 scripts/text.py,按 OpenAI 兼容语义发 messages、选模型、开流式输出,并把结果存成 JSON。
技能如何工作
- 默认执行:
python3 …/scripts/text.py支持--request/--file、--stream、--model、--output;仅用 Python 3.9+ 标准库,不必为跑脚本再pip install。 - 模型策略:用户指定
model时直接用;无明确信号时默认qwen3.7-plus,强推理/编码可走qwen3.8-max或 coder 系列;复杂选型可配合 qianwen-model-selector(表内为快照,正式决策应查官方模型页)。 - 能力范围:文本生成、多轮对话、写代码、tools / function calling;细节见
references/execution-guide.md、api-guide.md、prompt-guide.md(含 CO-STAR、CoT 等)。 - 鉴权与安全:使用
DASHSCOPE_API_KEY(或QIANWEN_API_KEY),在.env或环境变量中配置;禁止在输出里明文展示密钥,检测只能报 set/not set、valid/invalid。
边界与注意点
- 不支持 Token Plan 密钥(
sk-sp-...):脚本启动会检测并 exit 1,需使用标准按量付费密钥(sk-...)。 - Agent 若不会自动加载技能,需按
references/agent-compatibility.md在项目配置里注册。 - 找不到
python3或版本低于 3.9 时,应改走execution-guide.md中的 curl 等备选路径。 - 执行后需扫 stderr 中的
[ACTION_REQUIRED]/[UPDATE_AVAILABLE]并按技能说明处理。
使用场景
- Agent 要按 OpenAI 格式发多轮 messages,需要指定 qwen3.7-plus 并流式打印回复
- 本地脚本用 --file 加载 JSON 请求,把 completion 结果写到 --output 目录做回归对比
- 复杂任务要选 qwen3.8-max 或 coder 模型生成代码,并在请求里带上 tools 定义
- 密钥未配置时,需要用占位符 .env 引导用户去千问控制台填 DASHSCOPE_API_KEY
适合人员
- 正在把现有 OpenAI 兼容 Agent 接到千问后端的集成工程师
- 需要在 CI 或本机用单脚本发 completion、不引入额外 Python 依赖的自动化维护者
- 要按任务在 plus / max / coder 之间切换模型、并记录 JSON 响应的研发同学
- 负责密钥与合规、要求输出里绝不能出现明文 API Key 的安全或平台同学