ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Qwen-AgentWorld 部署指南:TaoToken 统一 Key 接入,5 分钟跑通 Agent 工作流

Qwen-AgentWorld 部署指南:TaoToken 统一 Key 接入,5 分钟跑通 Agent 工作流 1. 为什么要在本地跑 Qwen-AgentWorldQwen-AgentWorld 是通义千问开源的语言世界模型它的定位很特别不是让模型去当 Agent而是让模型扮演 Agent 所处的环境。你给它一条动作指令比如执行某条终端命令、点击某个网页元素它预测出环境接下来会变成什么样。对做 Agent 训练和评测的人来说这意味着不用真的开虚拟机、连真机、搭一整套沙箱就能拿到接近真实的交互反馈。它覆盖七个交互领域文本侧有 MCP、Search、Terminal、SWEGUI 侧有 Web、OS、Android。旗舰版 397B 在 AgentWorldBench 上整体得分超过 GPT-5.4轻量版 35B-A3B 也能在 256K 上下文下跑多轮模拟对本地部署比较友好。适合谁想快速验证 Agent 工作流、做强化学习环境模拟、或者单纯想看看世界模型输出长什么样的开发者。这篇不聊论文只解决一件事把 Qwen-AgentWorld 在本地跑起来并且用 TaoToken 的统一 Key 把模型调用通道接好5 分钟内完成一次真实对话验证。整个过程分两条线一条是模型服务本身怎么起另一条是 Agent 框架侧怎么通过统一 API 通道去调它。2. TaoToken 前置准备统一 Key 与通道在动手之前先把调用通道理清楚。Qwen-AgentWorld 本地起服务后默认暴露的是 OpenAI 兼容接口形如http://localhost:8000/v1。但实际做 Agent 工作流时你往往不止调一个模型可能主推理用一个大模型环境模拟用 Qwen-AgentWorld裁判打分再换一个。每个都单独配 base_url 和 key配置会散得到处都是。TaoToken 在这里的作用是提供一个统一的 Key 和 API 通道把模型调用收敛到一个入口。你只需要在配置里写一次 base_url 和 api_key切换模型时改 model 字段就行。对 Agent 这种多模型协作的场景配置集中管理能省掉大量来回改环境变量的时间。先拿到 Key。打开控制台创建 API Key地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。创建后复制保存后面 config.toml 和 settings.json 都要用。API 基础地址统一用 https://taotoken.net/api 注意这个地址不带任何查询参数直接作为 base_url 填入即可。注意本地起的 Qwen-AgentWorld 服务和 TaoToken 通道是两件事。前者是你自己机器上的推理服务后者是模型调用的统一入口。如果你的 Agent 框架需要同时访问本地模拟器和远端模型两个地址都要配别混成一个。如果你更想先直观感受一下模型对话效果不急着写配置可以直接在模型对话页面试几条 prompt地址 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。确认通道通了再回到本地部署排障会轻松很多。3. 可复制配置config.toml 与 settings.json这一节给两份骨架配置一份给 Agent 框架主配置一份给模型调用侧。字段名按常见约定写你按自己框架的实际 schema 微调即可。先看config.toml放在项目根目录# config.toml - Qwen-AgentWorld Agent 工作流主配置 [agent] name qwen-agentworld-demo max_turns 8 timeout_seconds 120 [model] # 统一走 TaoToken 通道 provider openai-compatible base_url https://taotoken.net/api api_key sk-你的TaoTokenKey model qwen-agentworld-35b-a3b temperature 0.6 top_p 0.95 top_k 20 max_tokens 32768 [world_model] # 本地 Qwen-AgentWorld 推理服务 enabled true base_url http://localhost:8000/v1 api_key EMPTY model Qwen/Qwen-AgentWorld-35B-A3B context_length 262144 domain terminal # 可选 mcp/search/terminal/swe/web/os/android [logging] level info output ./logs/agent.log再看settings.json给需要 JSON 配置的框架或脚本用{ llm: { base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, default_model: qwen-agentworld-35b-a3b, fallback_model: qwen-agentworld-397b-a17b }, world_model: { base_url: http://localhost:8000/v1, api_key: EMPTY, model: Qwen/Qwen-AgentWorld-35B-A3B, sampling: { temperature: 0.6, top_p: 0.95, top_k: 20 } }, runtime: { max_context: 262144, min_context: 131072, output_tokens: 32768 } }几个参数值得单独说。temperature0.6、top_p0.95、top_k20是官方推荐采样组合世界模型对格式和事实一致性敏感温度别调太高。context_length建议至少保持 128K模型默认 256K多轮模拟时上下文被截断会直接影响预测质量。domain字段决定用哪套系统提示七个领域各有专用 prompt切换领域时改这里。提示api_key写EMPTY是本地服务的常见占位不是让你填真实 Key。本地服务不校验鉴权时任何非空字符串都能过。真正需要鉴权的是 TaoToken 通道那一侧。4. 启动服务与一次对话验证配置写完分两步走先把本地世界模型服务拉起来再跑一次对话验证通道。启动本地服务用 SGLang 或 vLLM 都行。以 SGLang 为例pip install sglang python -m sglang.launch_server \ --model-path Qwen/Qwen-AgentWorld-35B-A3B \ --port 8000 \ --tp-size 4 \ --context-length 262144 \ --reasoning-parser qwen3--tp-size 4表示用 4 张卡做张量并行单卡或卡数不同就改这个值。启动后服务监听http://localhost:8000/v1和配置里的 world_model.base_url 对上。服务起来后写一个最小验证脚本同时验证本地世界模型和 TaoToken 通道from openai import OpenAI # 通道一本地 Qwen-AgentWorld 世界模型 world_client OpenAI(base_urlhttp://localhost:8000/v1, api_keyEMPTY) messages [ { role: system, content: You are a language world model simulating a Linux terminal environment. Given the users command, predict the terminal output. }, { role: user, content: Action: execute_bash\nCommand: pwd } ] resp world_client.chat.completions.create( modelQwen/Qwen-AgentWorld-35B-A3B, messagesmessages, max_tokens32768, temperature0.6, ) print(世界模型输出) print(resp.choices[0].message.content) # 通道二TaoToken 统一 Key token_client OpenAI( base_urlhttps://taotoken.net/api, api_keysk-你的TaoTokenKey, ) resp2 token_client.chat.completions.create( modelqwen-agentworld-35b-a3b, messages[{role: user, content: 用一句话说明什么是语言世界模型}], max_tokens256, ) print(TaoToken 通道输出) print(resp2.choices[0].message.content)跑通后你会看到两段输出。世界模型那段应该返回类似/home/user的路径预测说明它正确模拟了pwd命令在终端环境下的结果。TaoToken 那段返回一句解释说明统一 Key 通道正常。如果只想验证模型能力、不想起本地服务也可以直接在模型对话页面发同样的 prompt地址 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 对比一下输出格式是否一致。5. 本篇常见错排查部署过程里踩坑集中在几个地方逐个说。服务起不来报显存不足。35B-A3B 是 MoE 架构激活参数 3B但权重总量还是 35B 级别。--tp-size设小了会 OOM4 卡起步比较稳。如果卡不够考虑量化版本或换更小的规格。请求返回 404 或 model not found。检查 model 字段拼写。本地服务用完整路径Qwen/Qwen-AgentWorld-35B-A3BTaoToken 通道用模型标识qwen-agentworld-35b-a3b两者不一样别写混。输出格式乱、不像环境预测。大概率是系统提示没配对。七个领域各有专用 prompt在仓库prompts/目录下。domain字段要和实际任务一致用 Terminal 的 prompt 去跑 Web 任务输出自然不对。多轮对话到后面质量下降。上下文被截断了。确认context_length至少 128Kmax_tokens给到 32768。长轨迹任务适当调大输出长度但注意别超过服务端限制。TaoToken 通道返回鉴权错误。检查 api_key 是否完整复制base_url 是否写成https://taotoken.net/api注意不要带多余路径或查询参数。如果 Key 刚创建确认没有复制到首尾空格。本地服务和通道都通但 Agent 框架报连接超时。看框架的 timeout 配置。世界模型单次预测可能跑几十秒timeout_seconds给到 120 以上比较安全。6. 接下来怎么走跑通一次对话只是起点。真正做 Agent 工作流你会需要多轮模拟、领域切换、以及把世界模型接到强化学习循环里。这时候配置的集中管理就体现出价值了模型调用统一走 TaoToken 通道本地模拟器单独配切换模型只改一个字段。如果你打算长期做编码类 Agent 或跑多轮工具调用可以了解一下 Coding Plan地址 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 它针对长上下文、多轮调用的场景做了通道侧优化。接入细节和参数说明在接入文档里地址 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置字段有疑问时对着查比试错快。最后留一个实操建议把config.toml里的domain做成命令行参数跑不同领域任务时不用改文件。世界模型的系统提示切换成本很低但配错领域导致的输出异常很难一眼看出来用参数显式指定能少走弯路。
返回列表