VeyraOS 文档

Appearance

进入控制台

快速开始 ​

VeyraOS 是企业级 AI 智能体平台，支持多引擎接入、统一鉴权、私有化部署。本页带你从零完成第一次调用。

1. 登录控制台 ​

打开管理员分发的控制台地址（如 http://<服务器IP>:30000），使用分配的账号密码登录。默认情况下只需用户名 + 密码即可登录；当系统检测到账号存在异常登录尝试（连续 2 次密码错误）时，会自动要求填写图形验证码（点击图片可刷新）。

若部署开启了演示功能，管理台与终端门户的登录页（账号密码页签）下方都会显示「一键演示」按钮——无需账号密码，点击即可直接进入预置好数据的共享演示工作区，浏览智能体/实例/知识库/监控并发起对话。两端为各自独立的演示账号（管理台演示账号为平台管理员，终端门户演示账号为终端用户），共用同一演示用户组、仅能访问演示组内的数据；演示数据会被不定期清理。详见部署文档「演示账号（一键演示）」章节。

  • 系统管理员：系统最高权限角色
  • 平台管理员：除系统管理外的全部权限
  • 组管理员：用户组管理 + 本组终端用户管理
  • 运维人员：监控中心 + 智能体实例管理

终端用户从终端门户登录使用智能体，不属于管理台角色。管理台角色清单见系统管理。

终端门户（account-portal）登录页以账号密码登录为主：

  • 密码登录（默认）：输入邮箱 / 账号名（自动识别）+ 密码登录；部署开启手机能力时也支持手机号 + 密码登录。
  • 验证码登录：输入已注册的邮箱 → 拖动滑块 → 获取验证码 → 输入 6 位邮箱验证码后登录（仅登录已有账号，不能用于注册）。
  • 微信扫码登录：部署开启微信登录时，单击登录按钮下方的微信扫码登录，用微信扫码确认后直接登录；首次使用微信登录需绑定手机号（输入手机号并通过短信验证码确认，之后扫码即可直接登录）。未开启微信登录的部署不显示该入口。

部署开启演示功能时，终端门户登录页同样提供「一键演示」按钮（见上文演示说明）。

注册使用独立的注册页，注册时即设置登录凭据：

  • 个人注册 /register：输入邮箱并完成验证码验证 → 设置账号名、密码（确认输入两次）→ 勾选协议后注册，注册成功自动登录。
  • 企业注册 /register/organization：验证管理员邮箱，同样设置账号名与密码；联系电话为选填的联系信息。

在密码登录页单击「忘记密码？」可重置密码：输入注册邮箱 → 接收验证码 → 输入 6 位验证码 → 设置新密码。部署开启手机能力时也可选择短信渠道找回。

安全策略：

  • 图形验证码（条件触发）：默认登录不要求验证码；同一账号连续 2 次密码错误后，第 3 次起会要求填写图形验证码，验证码 5 分钟有效，校验后立即失效（一次性）。
  • 滑块验证（发送验证码前）：所有验证码发送入口（短信/邮箱：登录、注册、企业注册、绑定手机/邮箱、改密、忘记密码）发送前需先拖动滑块完成安全验证，验证通过后验证码自动发送；拖动未通过可重试。
  • 账号锁定：同一账号连续 5 次密码错误会被锁定 15 分钟，期间登录会提示「账号已锁定，请 X 分钟后重试」。
  • IP 限流：同一 IP 每分钟尝试超过 10 次会触发限流，每小时失败超过 50 次会临时封禁 1 小时。

登录后进入 Dashboard，可看到智能体总数、调用次数、活跃实例等概览。

2. 创建智能体 ​

2.1 创建智能体 ​

  1. 在左侧导航栏进入「智能体管理」
  2. 点击「自定义创建」卡片，填写名称、选择引擎类型（Hermes / Dify / OpenClaw / DeepSeek 等）
  3. 配置 Persona（人设）、Skills（技能）、Model（模型）等参数
  4. 点击「保存」，自动进入智能体工作台

2.2 调试并发布版本 ​

  1. 在工作台「调试」页签部署调试实例，对话验证效果
  2. 满意后在工作台「版本」页签点击「发布」，填写版本说明后提交，系统自动发布并同步到生产实例

2.3 管理运行实例 ​

  1. 在工作台「部署」页签查看生产实例的部署状态与运行配置
  2. 需要调整运行模式、沙箱等参数时，在部署配置卡点击「编辑运行配置」（保存后重启生效）
  3. 实例状态变为 RUNNING 后，可通过终端门户或 API 调用

3. 调用智能体 ​

有两种调用方式：

3.1 终端门户 ​

访问终端门户地址（如 http://<服务器IP>:30081），登录后直达对话页：默认选中上次对话的智能体并恢复最近会话；首次使用自动进入列表第一个智能体，对话页内可随时切换。适合人工交互场景。

3.2 API 调用 ​

在智能体详情页「API Keys」tab 创建 sk- 风格 API Key，用标准 OpenAI SDK 调用。详见 API 调用指导。

4. 接入 IM 渠道（可选） ​

如需将智能体接入企微/飞书等 IM 平台：

  1. 在实例详情页「渠道」tab 配置 webhook
  2. 按 IM 渠道架构 文档完成平台侧配置
  3. IM 用户 @机器人 即可触发智能体响应

5. 监控与运维 ​

  • 监控中心：链路追踪 / 用量分析 / 调用分析 / 异常告警，查看智能体运行情况
  • 操作记录：记录所有 admin 操作（创建/部署/删除等），支持审计
  • 服务日志：manager / gateway 服务日志可在线查看

下一步 ​

基于内网部署的企业级 AI 智能体平台

© 2026 VeyraOS