控制台快速上手
控制台快速上手
Section titled “控制台快速上手”codingas.com 控制台是网关的可视化管理后台,基于 React + Ant Design 构建,支持中文 / English 界面切换。本文导览 12 个功能模块,帮助管理员与开发者快速定位操作入口。
访问网关地址(如 http://localhost:8080)进入登录页。默认 local profile 预置示例账号:
| 角色 | 用户名 | 密码 | 权限 |
|---|---|---|---|
| 管理员 | admin | admin | 全部功能 |
| 普通用户 | (示例数据) | (示例数据) | 受限视图 |
生产环境请务必修改默认密码。认证体系详见 用户与认证。
1. 仪表盘(Dashboard)
Section titled “1. 仪表盘(Dashboard)”- AdminView:管理员视图,展示全局用量、渠道健康、熔断状态概览
- UserView:普通用户视图,展示个人 API Key、用量统计
2. 快速开始(Quickstart)
Section titled “2. 快速开始(Quickstart)”面向开发者的自助入口,四步完成首次调用:
- 模型卡片浏览:按关键词搜索模型
- API Key 选择 / 创建:选择已有 Key 或新建
- 代码片段生成:自动生成 cURL / Python / Node / Java 示例,支持 OpenAI / Anthropic 双协议
- Playground 试玩:在线调试,支持流式,显示 Token 用量与耗时
按能力标签(vision / functionCalling)筛选模型在 模型目录(Catalog) 模块进行。
详见 Playground 体验。
3. 应用管理(Applications)
Section titled “3. 应用管理(Applications)”应用是权限与行为的聚合根,承载 API Key 归属与渠道可见性。
- 创建 / 编辑应用(code / name / description)
- 管理应用下的 API Key
- 配置应用授权的渠道及应用级转移优先级
详见 应用管理。
4. 渠道管理(Channels)
Section titled “4. 渠道管理(Channels)”渠道是上游接入的核心,功能最丰富的模块:
- 创建向导:引导式新建渠道
- 复制渠道:一键复制渠道(本体 + 端点 + 模型实例 + 可选凭证)
- 详情抽屉:查看 / 编辑渠道全貌
- 分组列表 / 表格视图:按 Provider 分组或平铺
- 熔断器:一键强制熔断 / 恢复端点
- 连通性测试:验证渠道可用性
- 凭证管理:上游 API Key 的增删与轮换
- 端点管理:配置协议端点
- 模型映射:上游模型名与网关模型名的映射
- 批量导入 / 导出:批量管理渠道(导出为 YAML,不含凭证明文)
原 Provider 独立页面已并入渠道管理(控制台
/providers路由会重定向到/channels),供应商元数据在创建渠道时选择。
详见 渠道管理。
5. 模型管理(Models)
Section titled “5. 模型管理(Models)”维护网关对外暴露的模型清单:创建 / 编辑模型、关联渠道、复制模型(继承规格快速生成新模型)、解锁与状态管理;已废弃模型带 DEPRECATED 标签(由模型生命周期自动探测标记)。
详见 模型与定价。
6. 用户管理(Users)
Section titled “6. 用户管理(Users)”管理员管理用户账号与角色(ADMIN / USER)、启用 / 停用账号、重置密码,并为用户分配 API Key。
详见 用户与认证。
7. 调用方密钥(ApiKeys)
Section titled “7. 调用方密钥(ApiKeys)”调用方 API Key 的集中管理:创建 / 查询 / 删除,Key 绑定用户与应用(模型可见范围由应用渠道授权决定)。
详见 调用方密钥管理。
8. 模型目录(Catalog)
Section titled “8. 模型目录(Catalog)”浏览供应商、套餐与模型定价目录,对应 PlanCatalogController 查询能力,支持按能力标签(vision / functionCalling)筛选模型。
9. 容灾大盘(Resilience)
Section titled “9. 容灾大盘(Resilience)”端点级熔断器状态大盘(CLOSED / OPEN / HALF_OPEN),查看容灾事件与故障转移记录。
详见 容灾与高可用。
10. 审计日志(AuditLogs)
Section titled “10. 审计日志(AuditLogs)”管理端写操作(创建 / 更新 / 删除)的审计记录查询:操作人、动作、资源、来源 IP 与结果,支持分页检索与按时间清理。
11. Token 限额(TokenLimits)
Section titled “11. Token 限额(TokenLimits)”用户 / 供应商 / 模型维度的 Token 限额规则管理:创建规则、设置周期与超限动作、重置用量。
详见 Token 计量与配额。
12. 系统设置(Settings)
Section titled “12. 系统设置(Settings)”系统级配置键值(system_settings 表)的查看与修改,如探测周期、废弃检测阈值等运行参数。
典型操作路径
Section titled “典型操作路径”| 目标 | 路径 |
|---|---|
| 首次调用模型 | Quickstart → 选模型 → 建 Key → 复制代码 |
| 接入新上游 | Channels → 创建向导 → 配置凭证 / 端点 / 模型映射 → 连通性测试 |
| 给应用授权渠道 | Applications → 选应用 → 渠道管理 → 勾选渠道并设优先级 |
| 排查调用失败 | Resilience → 看熔断状态 → 查容灾事件 → 结合 traceId 查日志 |
| 限制某用户用量 | TokenLimits → 创建限额规则(用户 / 供应商 / 模型维度) |
控制台所有写操作均通过 管理 API 实现,本文档不逐项截图,请以实际界面为准。