新用户操作指导（快速上手）
面向第一次接触 VeyraOS 的新用户。按下面步骤，5 分钟即可跑通第一个场景：登录 → 找到智能体 → 开始对话。 每一步都提供跳转到对应帮助文档的链接，需要细节时点开即可。
1. 先弄清楚：你用哪个入口？
VeyraOS 提供两个入口，按账号类型区分：
| 你的账号 | 登录入口 | 你能做什么 |
|---|---|---|
| 管理员账号 | 管理台（如 admin.<域名>） | 创建与发布智能体、管理用户和权限、监控平台运行、查看用量与计费 |
| 普通用户账号 | 终端门户（如 chat.<域名>） | 选择智能体、发起对话、管理会话与工作区 |
入口地址和账号由管理员或平台运营分发。登录后请及时在「账户设置」中修改初始密码。 管理台角色说明见系统管理，终端门户完整能力见终端用户门户。
2. 普通用户：最快 3 步开始对话
- 打开终端门户，用分配的账号密码登录。
- 在智能体列表中选择你需要的智能体（例如「企业办公通用智能体」「门店助手」）。
- 进入对话页后，直接在输入框提问。首次访问某个智能体时，系统会自动为其准备运行环境，稍等片刻即可开始对话。
小提示：
- 左侧列表可新建、切换会话，历史会话会自动保存，随时可以继续。
- 输入框旁可切换模型、上传文件；回复会流式逐字显示。
- 支持手机浏览器使用，界面会自动适配。
3. 管理员：创建并发布第一个智能体
- 登录管理台，先看「首页」了解平台概览与各服务健康状态（首页概览）。
- 进入「智能体管理」，点击「自定义创建」，填写名称、选择引擎类型（Hermes / DeepSeek 等），配置人设、技能、模型后保存（智能体管理）。
- 在工作台调试满意后点击「发布」，再到「部署」页创建运行实例；实例进入运行状态后即可供终端用户使用（实例深度运维）。
- 运行前可通过「资源池」指定实例运行资源，通过「模型组与 API Key」配置模型（资源池、模型组与 API Key）；上线后到「监控中心」查看运行状况（监控中心）。
关于权限：管理员分为系统管理员、平台管理员、组管理员、运维人员，各自的菜单与可执行操作不同，详见系统管理。
4. 开发者：通过 API 调用智能体
在智能体实例详情页「API Keys」页签创建 sk- 开头的 API Key，即可用标准 OpenAI SDK 调用，无需改造客户端（API 调用指导）。
5. 帮助文档索引
| 想了解什么 | 帮助页 |
|---|---|
| 从零到第一次调用 | 入门指引 |
| 首页 / 平台概览 | 首页概览 |
| 创建 / 发布智能体 | 智能体管理 |
| 实例部署与运维 | 实例深度运维 |
| 资源池 | 资源池 |
| 知识库 | 知识库 |
| 模型组与 API Key | 模型组与 API Key |
| 技能工作室 | 技能工作室 |
| 资产中心 | 资产中心 |
| SaaS 运营 | SaaS 运营 |
| 监控中心 | 监控中心 |
| 用户 / 角色 / 分组 | 系统管理 |
| 终端门户账号设置 | 账号中心（门户） |
| 管理台账户设置 | 账户设置（管理台） |
| 社区 | 社区 |
| API 调用指导 | API 调用指导 |
| 平台完整功能 | 完整功能目录 |
6. 遇到问题
- 忘记密码：登录页点击「忘记密码」，通过邮箱或手机验证码重置；管理员账号请找平台管理员重置。
- 平台异常：联系平台管理员。管理员可在「监控中心」查看服务健康与日志，辅助排查。