AgentSpace接入Qwen模型完整操作流程

在华为云码道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 是否正确且未多余添加后缀。每次只修正一项可疑配置，重新发送测试请求，直至连通。

发送测试请求并收到回复

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