AgentSpace接入通义千问模型操作步骤

在华为云码道 Agent Space 中接入阿里云百炼的通义千问模型，可以让智能体具备更强大的语言处理能力。通过自定义模型配置，你可以灵活选择如 qwen-plus 等特定版本，并在 Windows 版码道 IDE 中直接调用。这种方法无需修改底层代码，只需在界面中完成参数映射即可生效。

Agent Space 中成功接入通义千问模型后的对话界面示意

1. 准备同一地域的密钥与模型信息

接入前，需确保阿里云百炼服务已开通，并获取北京地域对应业务空间的 API Key。确认该空间拥有调用 qwen-plus 模型的权限。若使用其他地域或专属方案，必须使用配套的密钥、地址和模型 ID，保持三者地域一致。

同时，检查码道侧账户权限。自定义模型功能通常要求企业成员身份及启用席位，部分套餐需管理员开启“成员自定义模型”权限。若设置入口不可见，请先联系管理员核实账户配置，而非尝试更换模型名称解决。

2. 打开模型页面并选择自定义配置

登录码道 IDE，进入 Agent Space 页面。点击右上角的设置图标，在左侧菜单中选择【模型】。点击【添加模型】按钮，在弹出的对话框中选择【自定义配置】。

本教程采用手动填写参数的路径，以便清晰展示地址协议和字段含义。虽然部分提供商支持快捷添加，但为避免自动回填错误，建议统一使用【自定义配置】方式。

在 Agent Space 页面右上角点击设置图标并选择模型

3. 按百炼兼容接口填写参数

在添加模型对话框中，准确填写以下信息：

注意区分“模型展示名称”与“模型 ID”。展示名称仅用于在码道列表中识别，而模型 ID 才是实际调用接口的标识。切勿将百炼网页端的显示名称直接填入 ID 字段。上下文窗口 Tokens 等可选参数，请依据模型官方说明填写，避免随意设置过大数值导致错误。

填写 OpenAI 兼容格式、Base URL 及模型 ID

4. 核对模型 URL 的地址形式

本例中的模型 URL 为 Base URL，末尾停留在 /compatible-mode/v1，未追加 /chat/completions。码道默认将该字段视为基础地址。若当前版本界面提供【使用完整 URL】开关，请保持关闭状态。

阿里云百炼同时提供通用兼容域名和业务空间专属域名。若使用专属域名，需从百炼控制台获取实际地址，严禁保留示例中的占位符。确保填写的域名与所选 API Key 的地域及服务类型完全匹配。

4. 核对模型 URL 的地址形式

5. 确认添加并在对话中选中千问 Plus

核对所有参数后，点击【确认】。返回【模型】列表，在【自定义】区域应能看到“千问Plus”，且状态默认为开启。

进入聊天界面，选择【内置 > 智能体】或你创建的自定义智能体。在右侧模型选择列表中，找到并选中“千问Plus”。需注意，自定义模型通常仅在智能体模式下可用，若在普通【智能问答】中未显示，并非添加失败，而是受限于调用模式。

6. 用一条简短请求检查接入

发送一条简单的文本问题，例如“你好”，暂不涉及文件修改或复杂任务。观察是否正常返回回复。

若出现错误，根据提示排查：

• 401 错误：检查 API Key 是否正确，以及密钥地域是否与 URL 地域一致。
• 地址错误：重新核对 Base URL 格式及【使用完整 URL】开关状态。
• 模型不存在：回到百炼控制台，确认 qwen-plus 在当前空间是否已开通调用权限。

完成一次成功调用后，方可进行更复杂的开发任务。通过分步确认添加、选择和调用，可确保接入过程稳定可靠。

6. 用一条简短请求检查接入