Agent Skills
返回列表
🤖

通义千问 OpenAI 兼容对话

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 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 的安全或平台同学