在 AI 应用开发中，将第三方大语言模型接入一站式开发平台是实现功能落地的关键环节。本文以华为云 ModelArts 的通义千问 Qwen3-235B 模型为例，详细记录其接入 openJiuwen 平台，并关联智能体、配置工作流的完整实践流程。
一、获取 ModelArts API Key（模型认证凭证）
接入第三方模型的首要前提是获取平台身份认证密钥，需在华为云 ModelArts 控制台完成操作：
进入 ModelArts Studio 的 "API Key 管理" 页面，当前页面显示 "当前暂无 API Key"，需点击页面中央的 "创建 API Key" 按钮生成密钥。需注意，页面顶部提示大模型服务依赖 OBS、SWR 等服务，虽需后续授权，但 API Key 创建可直接执行。
点击 "创建 API Key" 后，系统弹出密钥展示窗口，此密钥仅会显示一次------ 必须立即复制并存储至安全位置（如加密文档），若丢失需重新创建。复制完成后点击 "我已保存，确认关闭" 完成密钥获取。
二、获取通义千问模型的接口信息（配置核心参数）
要完成模型接入，需先在 ModelArts 中获取通义千问的接口调用信息：
进入 ModelArts "在线推理" 页面，在免费服务列表中选择目标模型（如 "Qwen3-235B-A22B-32K"），点击模型右侧的 "调用说明" 按钮，获取接口配置的核心参数。
在 "调用说明" 弹窗中，需记录两个关键信息：
- API 地址 ：
https://api.modelarts-maas.com/v1/chat/completions（模型服务的请求端点） - model 参数 ：
qwen3-235B-a22b（调用模型的唯一标识，需与服务端一致）这两个信息是后续 openJiuwen 模型配置的核心依据。
三、在 openJiuwen 中添加通义千问模型（完成模型接入）
打开 openJiuwen 平台，进入模型管理模块完成模型配置：
在 openJiuwen 的 "模型管理" 页面，当前显示 "暂无模型数据"，点击 "+ 添加第一个模型" 按钮进入配置表单。
在 "添加新模型" 表单中，逐项填写配置信息：
- 模型基础信息 ：
- 模型名称：填写 "通义千问 Qwen3-235B"（用于平台内区分模型）；
- 模型 ID：填写 "Qwen3-235B-A22B-32K"（需与 ModelArts 的 model 参数一致，确保调用标识匹配）；
- API 协议：选择 "OpenAI"（通义千问适配 OpenAI 接口协议，决定请求格式与解析规则）；
- API 密钥：粘贴此前从 ModelArts 获取的 API Key（模型服务的身份凭证）；
- 基础服务地址：填写
https://api.modelarts-maas.com/v1（接口地址的根路径，匹配通义千问的服务域名）； - 描述：补充模型功能（如 "通义千问 Qwen3-235B-A22B-32K 大语言模型，具备长文本处理、多轮对话等能力"）。
- 模型参数配置 ：
- 超时时间设置为 60 秒（大语言模型处理请求耗时较长，预留充足响应时间）。
填写完成后点击 "添加模型"，完成通义千问在 openJiuwen 的接入配置。
四、测试模型可用性（验证接入有效性）
模型配置完成后，需通过测试确认其能否正常响应请求：
在模型测试页面，输入提示词 "写一个简单的 Python Hello World 程序"，点击 "开始测试"。测试结果显示 "测试成功"，说明模型已能正常接收并响应请求。
为进一步验证模型能力，输入提示词 "请解释一下人工智能的基本概念"，测试结果中模型返回了结构化的解释（含核心概念、关键技术分支），证明模型的语义理解与内容生成能力已正常生效。
五、智能体开发关联通义千问模型（实现业务场景落地）
模型接入并验证后，需将其关联至智能体，以支撑实际业务功能：
进入 openJiuwen 的 "智能体开发" 页面，在 "编排配置" 模块的 "模型" 下拉框中，选择已接入的 "通义千问 Qwen3-235B" 模型，完成智能体与模型的绑定。同时，可在 "系统提示词配置" 中定义智能体的角色（如 "提案合规校验器"），让模型按指定逻辑工作。
六、工作流编排配置（实现流程化调用）
为实现更复杂的业务流程，可将关联模型的智能体配置到工作流中：
在 openJiuwen 的 "工作流编排" 模块，搭建 "开始→大模型（通义千问）→结束" 的流程：将 "大模型" 节点的模型选择为 "通义千问 Qwen3-235B"，配置输入输出参数，实现请求的流程化传递与响应输出。
流程总结
本次实践从获取 API Key 到工作流配置，共完成 6 个核心步骤 ------ 关键在于 "参数匹配" 与 "协议适配"：通义千问的 OpenAI 协议适配性，让 openJiuwen 无需额外开发即可快速接入；而严格匹配 ModelArts 的接口参数，确保了模型调用的准确性。
完成全流程后，通义千问模型已能通过 openJiuwen 的智能体、工作流模块支撑实际业务，为后续的 AI 应用开发提供了基础能力支持。
相关资源：
官网：https://www.openJiuwen.com?utm_source=csdn
代码仓库：https://atomgit.com/openJiuwen?utm_source=csdn
openJiuwen 项目核心组件
Agent Studio（智能体工作室）：https://atomgit.com/openJiuwen/agent-studio?utm source=csdn
可视化智能体开发平台，提供拖拽式编排能力
Agent Core（智能体核心）：https://atomgit.com/openJiuwen/agent-core?utm source=csdn
智能体核心引擎，提供Agent开发、运行、调优与演进相关的全套SDK能力