openJiuwen 快速入门：从零开始搭建你的第一个 AI 智能体
无论是否有编程基础，你都可以在 openJiuwen 平台快速搭建专属的 AI 智能体。本教程以"智能助手"为例，带你从模型配置到智能体创建，体验完整的开发流程。
一、准备阶段
1. 获取大模型 API Key
智能体的运行依赖大模型服务，你可以从主流大模型服务提供商获取 API 服务，也可以选择本地搭建。本教程以 DeepSeek 为例，演示如何获取和配置大模型服务。
了解 DeepSeek API
访问 DeepSeek API 文档，了解基本信息。
重要信息：DeepSeek API 使用与 OpenAI 兼容的 API 格式，这意味着你可以像使用 OpenAI 一样轻松接入。
🔑 关键配置参数
| 基础服务地址 | https://api.deepseek.com | API 的访问地址 |
| API 密钥 | 申请 API Key | 需要先注册账号并申请 |
💡 模型选择
DeepSeek 提供两种模型模式（当前版本：DeepSeek-V3.2）：
- deepseek-chat：标准对话模式，适合常规问答场景
- deepseek-reasoner：深度思考模式，适合需要复杂推理的任务
2. 在 openJiuwen 中配置模型
步骤 1：进入模型管理
在 openJiuwen 平台的模型管理界面，点击 “添加模型” 按钮。
步骤 2：填写模型信息
在模型配置界面中，依次填入以下信息：
| 模型名称 | 系统显示名称，可自定义 | DeepSeek V3.2 |
| 模型 ID | 模型的调用标识符 | deepseek-chat 或 deepseek-reasoner |
| API 密钥 | 在提供商平台申请的密钥 | 前往申请 |
| 基础服务地址 | API 的访问地址 | https://api.deepseek.com |
| 描述 | 模型的详细说明（可选） | DeepSeek V3.2 对话模型 |
步骤 3：测试模型连接
配置完成后，openJiuwen 提供了便捷的一键测试功能：
💡 提示：如果测试失败，请检查 API 密钥是否正确、网络连接是否正常，以及账户余额是否充足。
二、搭建智能体
模型配置完成后，我们就可以开始创建智能体了！
步骤 1：创建智能体
进入智能体开发界面，点击 “创建智能体” 按钮。
步骤 2：填写基本信息
在智能体配置向导中，填写以下信息：
- 智能体名称：给你的智能体起一个有意义的名字，例如 鸿蒙开发助手
- 功能描述：简要说明智能体的用途和能力
填写完成后，向下滑动页面至底部，点击 “确认并继续”。
步骤 3：配置智能体
进入智能体开发界面后，你会看到三个主要区域：
📝 左侧：系统提示词配置
这里是定义智能体"人格"和行为的地方。你可以根据需求自由设定提示词，例如：
# 角色
你是一个专业、友好的鸿蒙开发助手
# 任务目标
请耐心、准确地回答用户提出的问题，并在必要时提供详细的解释和建议。
# 行为准则
– 回答简洁明了
– 保持礼貌友善
– 遇到不确定的问题时，诚实告知
⚙️ 中间：智能体编排配置
选择刚才配置好的模型（如 DeepSeek V3.2），设置相关参数。
🎯 右侧：调试预览区域
这是实时测试区域。在对话框中输入问题，点击 “发送” 按钮，智能体会立即给出回答。你可以通过多轮对话测试智能体的表现。
步骤 4：保存并发布
测试满意后，点击页面上方的 “提交版本” 按钮：
在弹出的版本提交对话框中，填写版本说明（如 v1.0 初始版本），然后点击确认。
大功告成！
返回智能体列表，你就能看到刚刚创建的智能体了。点击即可开始使用！
三、下一步探索
恭喜你完成了第一个智能体的搭建！接下来你可以：
- 🔧 添加工具能力：为智能体接入 API、数据库等外部工具
- 🤝 多智能体协作：创建多个智能体并让它们协同工作
- 🎨 优化提示词：不断调试提示词，提升智能体的表现
- 📊 接入知识库：为智能体添加专业领域知识
- 🚀 发布应用：将智能体部署为可供他人使用的应用
关于 openJiuwen
openJiuwen 社区聚焦 AI Agent 通用平台能力，致力于构建易用、灵活且稳定的开源智能体平台，推动商用级 Agentic AI 技术广泛应用与落地。
基于该开源项目，开发者可以：
- ✨ 快速构建能处理各种复杂任务的智能体
- 🤖 实现多智能体协同交互
- 🏢 高效搭建企业级 AI Agent 系统
- 🎯 零编程基础也能上手使用
相关资源
- 官网：https://www.openjiuwen.com
- 代码仓库：https://atomgit.com/openJiuwen
- 文档中心：
- MacOS 系统安装指南
- 完整文档
核心组件仓库
openJiuwen 项目核心组件：
-
Agent Studio（智能体工作室）：https://atomgit.com/openJiuwen/agent-studio 可视化智能体开发平台，提供拖拽式编排能力
-
Agent Core（智能体核心）：https://atomgit.com/openJiuwen/agent-core 智能体核心引擎，提供Agent开发、运行、调优与演进相关的全套SDK能力
加入社区
🎉 欢迎加入 openJiuwen 开源社区，与全球开发者一起探索 AI Agent 的无限可能！
有问题或建议？欢迎在 代码仓库 提交 Issue 或参与讨论。
