AgentSpace接入Qwen模型完整操作流程
详解如何在华为云码道Agent Space中添加阿里云百炼Qwen模型。包括获取API Key、配置OpenAI兼容接口URL、设置模型ID及在智能体会话中调用验证的完整步骤,解决认证失败与路径报错问题。
在华为云码道Agent Space中使用阿里云通义千问(Qwen)系列模型,核心方法是将百炼平台的兼容接口添加为“自定义模型”。这种方式不依赖预置供应商列表的更新速度,允许开发者灵活调用 qwen-plus 等特定版本。完成配置后,即可在智能体会话中直接使用该模型进行代码生成或文本处理,且保持文字可编辑与上下文连贯。

Agent Space模型配置入口示意图
接入前需确保账号具备企业成员席位,且管理员已开放“自定义模型”权限。同时,需在阿里云百炼控制台开通服务,获取北京地域的 API Key 和业务空间 ID(WorkspaceId)。注意密钥、地域与计费方案必须严格匹配,北京地域的 Key 无法用于其他地域的地址。
1. 进入模型管理并新建配置
打开 Windows 版码道 IDE,进入 Agent Space 界面。点击页面右上方的设置图标,在弹出的菜单中选择【模型】选项卡。在模型列表页,点击【添加模型】按钮。
在添加模型对话框中,选择【自定义配置】方式。此路径适用于所有支持 OpenAI 兼容接口的服务商,不受预置列表限制。若列表中已存在相同提供商和模型 ID 的配置,系统会提示唯一性限制,此时应检查现有配置而非重复添加。

1. 进入模型管理并新建配置
2. 填写兼容协议与关键参数
在自定义配置表单中,需准确填写以下字段,确保码道能正确转发请求至阿里云百炼:
- API 格式:选择
OpenAI Chat Completions。 - 模型 URL:填入北京地域的业务空间专属域名。格式为
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1。请将{WorkspaceId}替换为实际的数字或字符串 ID。若使用共享域名,则填写https://dashscope.aliyuncs.com/compatible-mode/v1。 - 模型 ID:填入服务商提供的确切 ID,本例为
qwen-plus。 - 模型展示名称:可自定义,如“Qwen文稿助手”,便于后续识别。
- API Key:粘贴从百炼控制台获取的完整 Key。

自定义模型参数填写表单
注意,此处填写的是 Base URL,末尾不包含 /chat/completions。如果界面有【使用完整 URL】开关,请保持关闭状态,避免路径叠加导致请求失败。上下文 Token 限制等可选参数,建议查阅对应模型的官方说明后填写,不要随意夸大数值。
3. 在智能体会话中启用模型
配置保存后,返回【模型】页的【自定义】区域,确认“Qwen文稿助手”状态为开启。需注意,自定义模型通常不支持【智能问答】模式,必须在智能体环境中调用。
回到聊天区,选择【内置 > 智能体】或已创建的自定义智能体。在输入框上方或右侧的模型选择下拉列表中,找到并选中刚才配置的“Qwen文稿助手”。此时界面会显示当前正在使用的模型名称。

智能体会话中选择自定义模型
4. 发送测试请求验证连通性
在输入框中输入一个简单的文本指令,例如“请写一段Python Hello World代码”,发送请求。观察是否能正常收到回复。如果成功返回结果,说明 API Key、URL 和模型 ID 配置正确,网络链路通畅。
若提示认证失败,请检查 Key 是否完整、是否混用了不同地域的 Key;若提示模型不存在或无权限,请核对模型 ID 拼写及业务空间授权状态;若报接口路径错误,请检查 Base URL 是否正确且未多余添加后缀。每次只修正一项可疑配置,重新发送测试请求,直至连通。

发送测试请求并收到回复
确认可用后,该配置将保留在自定义模型列表中。后续只需在会话中切换模型即可直接使用,无需重复配置。如需修改参数或停用,可再次进入【模型】>【自定义】区域进行编辑。

































