快速上手:搭建第一个智能体(新手指引攻略)
欢迎来到华东师范大学 ECNU 智能体开发平台!本指南将以流程化的方式,带你从零开始完成第一个智能体的创建与使用。
📋 使用前准备
在开始之前,请确保你已准备好以下事项:
| 准备项 | 说明 |
|---|---|
| 统一身份认证账号 | 用于登录平台,必须是华东师范大学在校师生或工作人员 |
| 明确的智能体需求 | 想清楚你要创建什么类型的智能体,解决什么问题 |
| 相关资料 | 如智能体名称、功能描述、可能需要的外部 URL 等 |
🗺️ 新手使用流程图
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 步骤 1: 登录 │ -> │ 步骤 2: 创建 │ -> │ 步骤 3: 配置 │
└─────────────┘ └─────────────┘ └─────────────┘
↓
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 步骤 6: 迭代 │ <- │ 步骤 5: 测试 │ <- │ 步骤 4: 发布 │
└─────────────┘ └─────────────┘ └─────────────┘步骤 1:登录平台 🚪
目标:进入 智能体开发 平台个人空间
- 打开浏览器,访问 https://agent.ecnu.edu.cn
- 在登录页面,使用统一身份认证账号登录
- 登录成功后,进入个人空间页面
💡 提示:个人空间是你创建和管理智能体的"工作间",所有智能体都在这里集中管理。
📖 详细操作参考:登录指南
步骤 2:创建智能体 ➕
目标:创建一个新的智能体项目
- 在个人空间页面,找到并点击 "创建智能体" 按钮
- 在弹出的表单中填写以下信息:
| 字段 | 填写说明 | 示例 |
|---|---|---|
| 智能体名称 | 简单好记,不能重名 | 高校信息通小助手 |
| 智能体类型 | 对话型(问答聊天)或流程编排型(固定流程任务) | 对话型 |
| 功能介绍 | 清晰描述智能体的用途 | 为高校师生快速获取校园讲座信息、公告通知、图书馆资源等 |
| Logo(可选) | 上传喜欢的图片作为智能体头像 | - |
- 点击 "确定" 完成创建
💡 提示:新手建议从对话型智能体开始,这类智能体适合做聊天机器人、知识问答助手等,上手更简单。
📖 详细操作参考:创建指南
步骤 3:配置智能体 ⚙️
目标:完成智能体的核心配置,让智能体"聪明"起来
3.1 选择大语言模型 🧠
- 进入智能体编排页面
- 在右侧调试与预览区域,找到模型选择框
- 选择合适的模型(新手推荐选择 ecnu-plus)
- 保持默认参数设置即可
💡 提示:ecnu-plus 在常见任务上表现稳定,适合新手使用。熟悉后可根据实际需求调整模型和参数。
3.2 编写提示词 📝
- 在左侧提示词区域编写指令,告诉智能体要做什么
- 点击提示词右上角的 "自动优化" 按钮,让系统帮你规范提示词格式
提示词示例(以高校信息通小助手为例):
你是高校信息通小助手,专门为高校师生服务。当用户询问校园讲座通知、各类公告和图书馆资源等信息时,通过 Browser 插件获取对应网页内容,然后简洁清晰地回答用户。3.3 添加技能(插件) 🔌
- 点击 "插件" 添加区域
- 找到并添加 Browser 插件(可根据 URL 获取网页内容,支持网页、PDF、Excel 等格式)
- 收集整理需要用到的 URL 地址
常用 URL 收集示例:
- 校园讲座:
https://eoffice.ecnu.edu.cn/sublectures/ - 通知公告:
https://www.ecnu.edu.cn/tzgg.htm - 图书馆:
https://lib.ecnu.edu.cn/
- 将收集好的 URL 在提示词中清晰准确地描述
提示词优化示例:
# 功能 (Skills)
## 功能 1(Skill 1):信息提供者
- 提供校园内讲座相关的信息,参考讲座 url(https://eoffice.ecnu.edu.cn/sublectures/) 并给出网站引用链接。
- 传达学校发布的各类公告通知,参考通知 url(https://www.ecnu.edu.cn/tzgg.htm) 并给出网站引用链接。
- 汇总图书馆的各种资源,比如藏书目录、电子资源使用指南、借阅规则等,参考图书馆 url(https://lib.ecnu.edu.cn/) 并给出网站引用链接。⚠️ 注意:输入网址时请务必仔细核对,避免因输入错误影响智能助手获取信息。
📖 详细操作参考:配置指南
步骤 4:发布智能体 🚀
目标:将配置好的智能体发布上线
- 在智能体编排页面右上角,点击 "发布" 按钮
- 填写版本号和版本说明(方便后续管理和查看更新)
- 点击确认完成发布
💡 提示:版本号建议使用语义化版本格式,如 v1.0.0,版本说明简要描述本次发布的内容。
📖 详细操作参考:发布指南
步骤 5:测试智能体 🧪
目标:验证智能体是否按预期工作
- 发布成功后,进入概览页面的智能体访问区域
- 点击 "Web 服务" 开启按钮
- 点击 "预览" 打开对话窗口
- 输入测试问题进行验证
测试问题示例:
- "最新的讲座有哪些?"
- "学校最近有什么通知?"
- "图书馆的借阅规则是什么?"
- 检查回答是否准确清晰
- 如需分享体验,可复制 "公开访问 URL" 分享给其他人
💡 提示:如果回答不理想,不要着急,回到步骤 3 调整模型、提示词或技能配置,多试几次直到满意为止。
步骤 6:迭代优化 🔄
目标:根据测试结果持续改进智能体
如果智能体的回答不够理想,可以从以下方面进行优化:
| 问题类型 | 可能的原因 | 优化方向 |
|---|---|---|
| 回答不准确 | 提示词描述模糊 | 重新编写提示词,更清晰地描述任务 |
| 无法获取信息 | URL 错误或插件未启用 | 检查 URL 是否正确,确认 Browser 插件已添加 |
| 回答风格不符 | 缺乏风格指引 | 在提示词中添加回答风格要求,如"简洁回答"、"分点列出"等 |
| 模型能力不足 | 模型选择不当 | 尝试更换其他大语言模型 |
迭代流程:
调整配置 → 重新发布 → 再次测试 → 满意为止🎯 新手常见问题
Q1: 智能体创建后为什么不能对话?
A: 请先确保已完成发布操作,并在发布页面开启了Web 服务。
Q2: 如何让更多人使用我的智能体?
A: 在发布页面复制公开访问 URL,分享给需要的人即可。
Q3: 提示词怎么写才能让智能体更懂我?
A: 提示词要具体明确,包含角色定位、任务描述、输出格式等要素。可以善用"提示词优化"功能。
Q4: 可以创建多个智能体吗?
A: 可以的,在个人空间中可以创建和管理多个智能体。
📖 更多常见问题参考:常见问题
📚 进阶学习
完成本新手指引后,你可以继续学习以下内容:
- 提示词编写技巧 - 学习如何写出更高效的提示词
- 技能(Skill)配置 - 深入了解技能配置方法
- 工作流编排 - 学习流程编排型智能体开发
- 模型选择与参数配置 - 深入了解模型配置
🎉 开始你的智能体创作之旅
现在你已经掌握了 智能体开发平台的基本使用方法,快去创建属于你的第一个智能体吧!
如果在创作过程中遇到问题,可以查看其他详细文档或联系技术支持。祝你创作愉快!✨