新用户操作指导(快速上手)
面向第一次接触 VeyraOS 的新用户。按下面步骤,5 分钟即可跑通第一个场景:登录 → 找到智能体 → 开始对话。 每一步都提供跳转到对应帮助文档的链接,需要细节时点开即可。
1. 先弄清楚:你用哪个入口?
VeyraOS 提供两个入口,按账号类型区分:
| 你的账号 | 登录入口 | 你能做什么 |
|---|---|---|
| 管理员账号 | 管理台(如 console.<域名>) | 创建与发布智能体、管理用户和权限、监控平台运行、查看用量与计费 |
| 普通用户账号 | 终端门户(如 chat.<域名>) | 选择智能体、发起对话、管理会话与工作区 |
入口地址和账号由管理员或平台运营分发。登录后请及时修改初始密码(管理台账号在右上角头像菜单进入账号中心办理;终端门户账号在登录页走「忘记密码」自助重置)。 管理台角色说明见系统管理,终端门户完整能力见终端用户门户。
2. 普通用户:最快 3 步开始对话

- 打开终端门户,用分配的账号密码登录。
- 登录后直接进入你最近使用的智能体对话页;首次使用或多个智能体间切换时,点对话页左上角「切换智能体」,在弹窗中选择目标智能体。
- 进入对话页后,直接在输入框提问。首次访问某个智能体时,系统会自动为其准备运行环境,稍等片刻即可开始对话。
小提示:
- 左侧列表可新建、切换会话,历史会话会自动保存,随时可以继续。
- 输入框旁可切换模型、上传文件;回复会流式逐字显示。
- 支持手机浏览器使用,界面会自动适配。
3. 管理员:创建并发布第一个智能体
- 登录管理台,先看「首页」了解平台概览与各服务健康状态(首页概览)。
- 进入「智能体管理」,点击「自定义创建」,填写名称、选择引擎类型(Hermes / DeepSeek / Dify)与模型后保存,再在工作台「构建」页签配置人设、技能等(智能体管理)。
- 在工作台调试满意后点击「发布」,再到「部署」页创建运行实例;实例进入运行状态后即可供终端用户使用(实例深度运维)。
- 运行前可在运营控制台通过「资源池管理」规划实例运行资源,通过「模型管理 / API Key 管理」配置模型(资源池、注册模型与管理 API Key);上线后到「监控中心」查看运行状况(监控中心)。
关于权限:管理台分为平台员工、租户管理员、部门管理员、开发者与只读成员,各自的菜单与可执行操作不同,详见系统管理。
4. 开发者:通过 API 调用智能体
在智能体实例详情页「API Key」页签创建 sk- 开头的 API Key,即可用标准 OpenAI SDK 调用,无需改造客户端(API 调用指导)。
5. 帮助文档索引
| 想了解什么 | 帮助页 |
|---|---|
| 从零到第一次调用 | 入门指引 |
| 首页 / 平台概览 | 首页概览 |
| 创建 / 发布智能体 | 智能体管理 |
| 实例部署与运维 | 实例深度运维 |
| 资源池 | 资源池 |
| 知识库 | 知识库 |
| 模型与 API Key | 注册模型与管理 API Key |
| 技能工作室 | 技能工作室 |
| 资产中心 | 资产中心 |
| 运营控制台 | 运营控制台 |
| 监控中心 | 监控中心 |
| 用户 / 角色 / 分组 | 系统管理 |
| 账号设置 | 账号中心(门户) |
| 社区 | 社区 |
| API 调用指导 | API 调用指导 |
| 平台完整功能 | 完整功能目录 |
6. 遇到问题
- 忘记密码:登录页点击「忘记密码」,通过邮箱或手机验证码重置;管理员账号同样在账号中心登录页走「忘记密码」自助重置(管理台登录已统一收口账号中心)。
- 平台异常:联系平台员工。管理员可在「监控中心」查看服务健康与日志,辅助排查。