快速开始
VeyraOS 是企业级 AI 智能体平台，支持多引擎接入、统一鉴权、私有化部署。本页带你从零完成第一次调用。
1. 登录控制台
打开管理员分发的控制台地址（如 http://<服务器IP>:30000），未登录会自动跳转账号中心登录页：使用分配的账号密码登录后自动返回控制台。忘记密码时在账号中心登录页走「忘记密码」流程，按提示验证后自助重置。
- 平台员工：跨租户的平台能力，由账号中心授予的平台 scope 决定（平台超管 / 运维 / SaaS 运营）
- 租户管理员：企业组织的所有者 / 管理员，自动获得本企业全部业务管理权限
- 部门管理员：账号中心部门组的管理员，自动获得本部门及子部门的资源与成员管理权限
- 开发者：企业普通成员的默认角色，可创建与维护本人创建的资源
- 只读成员：由租户管理员显式分配，查看本空间资源但不能修改
终端用户从终端门户登录使用智能体，不属于管理台角色。管理台角色清单见系统管理。
终端门户登录页同样收口账号中心认证，支持以下方式：
- 密码登录（默认）：账号 / 邮箱 / 手机号 + 密码（按页签切换，输入密码即可登录）。
- 手机验证码登录：部署开启手机能力时显示「验证码」页签，输入手机号获取 6 位验证码登录（仅登录已有账号）。
- 忘记密码：在登录页单击「忘记密码」，通过已绑定的邮箱或手机验证码自助重置。
安全策略（条件触发）：同一账号连续密码错误后会要求填写图形验证码（一次性、限时有效）；连续错误次数过多账号会被临时锁定，页面会提示稍后重试。
新账号的注册与组织开通统一在账号中心完成（个人注册、企业注册、凭邀请码加入），管理台与终端门户均不提供本地注册入口。
登录后进入 Dashboard，可看到智能体总数、调用次数、活跃实例等概览。
2. 创建智能体
2.1 创建智能体
- 在左侧导航栏进入「智能体管理」
- 点击「自定义创建」卡片，填写名称、选择引擎类型（Hermes / DeepSeek / Dify）、选择模型
- 点击「保存」，自动进入智能体工作台；在工作台「构建」页签继续配置人设（Persona）、技能（Skills）、知识库等
2.2 调试并发布版本
- 在工作台「调试」页签部署调试实例，对话验证效果
- 满意后在工作台「版本」页签点击「发布」，填写版本说明后提交；首次发布会默认创建并触发首个实例部署，后续发布只生成新版本
- 后续版本需要应用到实例时，到「部署」页签点击「升级版本」；未部署或部署失败时也在该页签创建、部署或重试
2.3 管理运行实例
- 在工作台「部署」页签查看实例的部署状态与运行配置
- 需要调整运行模式、沙箱等参数时，在部署配置卡点击「编辑运行配置」（保存后重启生效）
- 实例状态变为
RUNNING后，可通过终端门户或 API 调用
3. 调用智能体
有两种调用方式：
3.1 终端门户
访问终端门户地址（如 http://<服务器IP>:30081），登录后直达对话页：默认选中上次对话的智能体并恢复最近会话；首次使用自动进入列表第一个智能体，对话页内可随时切换。适合人工交互场景。
3.2 API 调用
在智能体工作台「渠道」页签的 HTTP API 卡片单击生成（或实例详情页「API Key」页签）创建 sk- 风格 API Key，用标准 OpenAI SDK 调用。详见 API 调用指导。
4. 接入 IM 渠道（可选）
如需将智能体接入企微/飞书等 IM 平台：
- 在实例详情页「渠道」tab 配置 webhook
- 按 IM 渠道接入说明 完成平台侧配置
- IM 用户 @机器人 即可触发智能体响应
5. 监控与运维
- 监控中心：链路追踪 / 用量分析 / 调用分析 / 异常告警，查看智能体运行情况
- 操作记录：记录所有 admin 操作（创建/部署/删除等），支持审计
- 服务日志：manager / gateway 服务日志可在线查看