Docs
文档目录

界面与路由速查

本章介绍控制台的导航入口和常用路由。菜单会随环境开关、账号权限及项目配置变化;下方部分深层路径继承自旧版,使用时请以当前界面为准。

2.12.0 控制台项目侧栏

图 1:2.12.0 环境中的项目侧栏。可见入口取决于环境和账号权限。

功能概述

Agentbase 控制台前端单页应用(SPA)统一挂载在 /console 基路径之下,通过结构化的 URL 路径参数(如 {organization}、{region}、{project}、{database}、{kb})精确映射三级资源树与各级子页面。

在实际使用中,研发与运维人员常遇到两类导航需求:

  1. 快速直达深层子页面:例如收到线上告警后,直接拼接项目 ID 与 Trace ID 跳转到 /console/project-default-enterprise-ai-hub-210/observability/traces 或函数执行路径查询页,省去层层点击。

  2. 查找条件性入口:如果菜单项不可见,请先检查环境配置和当前账号权限。某些入口不会显示在侧栏中;隐藏的智能体运维页面可能重定向,不能依靠直接输入地址绕过配置。

路由空间层级URL 路径前缀典型示例核心承载模块
公共与认证入口/console/*(无租户前缀)/console/login · /console/mfa · /console/verify-email登录、注册、找回密码、邀请接受、MFA 二次核验、首次登录引导(Onboarding)
开发者账号中心/console/account/*/console/account/sessions · /console/account/project-cleanup个人资料、MFA 与恢复码、会话列表、账号 30 日用量、待删项目恢复、表模式转换记录
组织治理空间/console/organization-{organization}/*/console/organization-{organization}/members组织项目列表、成员邀请与角色管理、30 日组织聚合用量、不活跃项目清理、组织级工作台
项目工作台(概览与设置)/console/project-{region}-{project}/overview/* · .../settings/*/console/project-default-enterprise-ai-hub-210/overview/api-keys平台登记(Platforms)、API Keys、Dev Keys、入门引导、30 日项目用量、项目设置
项目工作台(Build 应用后端)/console/project-{region}-{project}/{service}/*/console/project-default-enterprise-ai-hub-210/databases/database-enterprise_biz_dbAuth 认证、Databases 数据库、Storage 存储、Functions 函数、Sites 站点、Messaging 消息、Moderation 审核
项目工作台(AI 与 AgentOps)/console/project-{region}-{project}/{ai-module}/*/console/project-default-enterprise-ai-hub-210/knowledge-base/kb-kb_enterprise_support智能体工作台、上下文、记忆、知识库、词库、模型(LLM Gateway)、AI 网关、智能体运维(Observability)

核心概念与架构

Agentbase 控制台路由采用“守卫拦截(Auth Guard) → 组织上下文注入 → 项目区域与服务能力判定 → 二级/三级页签渲染”的层次化路由架构。

界面与路由速查:流程示意,不是运行截图

流程示意,不是运行截图;按箭头阅读步骤或状态之间的关系。

查看流程图大图

路由路径变量与参数替换规范表

路径变量含义与来源变量替换示例格式约束与注意事项
{organization}组织唯一 ID($id)69c6d1aa00062e6bb60位于 /console/organization-{organization},切换顶部组织下拉框时自动更新。
{region}项目所属物理区域标识default(或具体可用区代号)创建项目时选定后不可更改,与 {project} 共同组成 /console/project-{region}-{project}。
{project}项目唯一 ID($id)enterprise-ai-hub-210数据面请求头 X-Appwrite-Project 所填写的值即为此处的 {project}。
{database} / {table}数据库 ID / 数据表 IDenterprise_biz_db / customer_tickets嵌套于 /databases/database-{database}/table-{table}。
{bucket} / {file}存储桶 ID / 文件对象 IDkb_enterprise_docs / file_arch_whitepaper嵌套于 /storage/bucket-{bucket}/file-{file}。
{kb} / {document}知识库 ID / 知识文档 IDkb_enterprise_support / doc_sop_manual嵌套于 /knowledge-base/kb-{kb}/doc-{document}。

角色、入口与关联关系

1. 左侧边栏入口可见性判定规则

在项目控制台中,侧栏按“基础设施”“人工智能”和“运维部署”等分组展示。以下条件会影响入口和操作:

控制维度影响范围如何处理
环境功能开关智能体工作台、上下文、记忆、智能体运维、站点和 AI 网关等由环境配置决定是否显示;请联系环境管理员确认功能已启用。
账号权限认证、数据库、存储、函数、记忆和模型等控制台根据当前账号的读取权限决定部分菜单是否可见;操作时还会检查相应写入权限。
界面可见性配置智能体运维中的报表、评估和其他分区隐藏的智能体运维页面可能重定向,不能通过直接输入地址绕过隐藏配置。
项目与组件状态项目内的具体配置和操作即使侧栏入口可见,也应先检查项目配置、组件状态和目标资源权限。

2. 控制面路由与数据面 API 端点的区别

功能详解与操作指南

以下按公共页与账号中心、组织治理级路由、项目 Build 应用后端路由与项目 AI 及 AgentOps 路由四个部分,提供完整的路径速查表。

1. 公共认证页与账号中心路由(/console/* & /console/account/*)

分类精确浏览器路径页面名称与核心功能说明关联章节
公共认证与守卫/公开站点主机返回产品落地页;其他主机自动重定向至 /console注册与登录
/console/login · /console/register · /console/recover开发者登录(邮箱密码 / GitHub / 企业 SSO)、新账号注册、忘记密码邮件找回注册与登录
/console/invite · /console/register/invite/{slug}已注册账号接受组织邀请、新用户通过邀请专属链接注册并加入组织注册与登录
/console/mfa · /console/verify-email登录多因素认证质询页(验证器/邮箱/短信/恢复码)、强制邮箱验证拦截页注册与登录
/console/onboarding/create-organization · /console/onboarding/create-project首次注册登录后的组织创建向导与首个项目创建引导快速开始
/console/auth/magic-url · /console/auth/oauth2/success · /console/auth/oauth2/failure项目 Auth 终端用户 Magic URL 与 OAuth2 授权登录回调确认页认证概览
开发者账号中心/console/account概览:修改姓名、邮箱、密码、关联外部身份(Identities)、配置 MFA 与一次性恢复码、永久注销账号组织与账号中心
/console/account/sessions · /console/account/activitySessions:查看当前登录设备/IP 并支持登出全部会话;活动:账号级操作审计时间线组织与账号中心
/console/account/organizations组织:查看所属组织列表、创建新组织(/console/create-organization)、管理自托管成员配额组织与账号中心
/console/account/rate-limits · /console/account/quota-limitsRate / Quota limits:只读查看当前账号适用的平台请求速率限制与资源配额上限限额与配额
/console/account/usage · /console/account/meteringUsage / Metering:账号级最近 30 个 UTC 日四项核心计量聚合趋势与覆盖状态限额与配额
/console/account/project-cleanup项目清理:查看待物理清理项目列表(Pending / Purging / Purge failed),支持在物理清理开始前点击 恢复 恢复误删项目组织与账号中心
/console/account/table-mode-conversions表模式转换:追踪跨项目发起的共享表/独占表/Shared V2 表模式转换任务历史与状态项目设置

2. 组织治理级路由(前缀 /console/organization-{organization})

组织页签名称路径后缀核心操作与治理说明
Projects(项目列表)/console/organization-{organization}展示组织下全部项目卡片(含区域标签),提供 创建项目 入口
Members(成员管理)/members邀请新成员、查看 2FA 状态、按 ID/邮箱搜索、修改组织角色(Owner/Admin/Developer/Editor/Billing/Analyst)、移除成员
Usage / Metering(组织用量)/usage · /metering组织级最近 30 个 UTC 日聚合用量(自动过滤已处于删除态的项目,确保计量准确)
Project cleanup(不活跃项目清理)/project-cleanup仅组织 Owner 可操作:按不活跃天数与新项目豁免天数检索(达标满 24 小时后列出),支持单次最多勾选 50 个项目提交清理
Agent Workbench(组织级工作台)/agent-runtime组织维度的智能体运行工作台入口
Domains / Billing / Invoices/domains · /billing · /invoices · /change-plan组织级自定义域名、云端账单、发票与套餐变更管理
Settings(组织设置)/settings修改组织名称、查看成员配额、执行不可逆的 删除组织

3. 项目控制台:概览、治理与 Build 应用后端路由(前缀 /console/project-{region}-{project})

侧边栏分组模块名路径后缀与子路由层次功能覆盖说明
顶层概览概览/overview/platforms · /overview/api-keys · /overview/api-keys/{keyId} · /overview/dev-keys查看项目实时请求/存储吞吐;登记 15 类客户端 Platform;创建与轮换生产 API Key(13 类 Scope 折叠选择器)及开发 Dev Key
项目引导/get-started独立展示项目创建、连接平台和构建应用的引导
Build 应用后端Auth(认证)/auth(Users 列表)· /auth/user-{user}(概览/memberships/sessions/targets/activity/identities)· /auth/teams · /auth/templates · /auth/usage · /auth/settings · /auth/security · /auth/test终端用户生命周期、通知目标(Targets)、团队与成员角色、邮件/短信模板、密码历史与个人数据校验安全策略、OAuth2 隔离测试页
Databases(数据库)/databases · /databases/usage · /databases/database-{database}(Tables / usage / settings / sql / schema-versions / backups)· .../table-{table}(rows / columns / indexes / activity / export / moderation / settings / usage)多数据库管理、表/列/行/索引 CRUD、在线 SQL 编辑器与 SQL Proxy、版本化 Schema 快照回滚、云端备份恢复、单表写路径文本审核
Storage(存储)/storage · /storage/usage · /storage/bucket-{bucket}(Files / usage / settings / moderation / create / file-{file})存储桶权限(Bucket 级 vs File Security)、文件分片上传、File Token 临时访问令牌、图片 fail-closed 内容审核
Functions(函数)/functions · /functions/usage · /functions/create-function · /functions/templates · /functions/function-{function}(Deployments / executions / usage / domains / settings / deployment-{deployment})Git/模板/手动源码(.tar.gz)与 Java 17 预构建 JAR(artifactMode=java-jar) 部署、去重执行路径查询(支持 path/pathMatch/method 过滤)、ACS 容器组资源监控
Messaging(消息)/messaging · /messaging/topics · /messaging/providers · /messaging/message-{message} · /messaging/create-{type}部分界面未提供侧栏入口,实际可用性以当前环境为准:管理 FCM/APNS/SMTP/Twilio 等发送提供商、订阅主题(Topics)与立即/定时/草稿消息投递
Moderation(内容审核)/moderation · /moderation/logs · /moderation/logs/{log}项目级与平台级阿里云 Green 内容安全凭据配置、30 日审核调用分项统计、支持按表/桶/结果过滤的审核日志详情
Sites(站点)/sites · /sites/create-site · /sites/site-{site}(Overview / deployments / logs / domains / usage / settings)受 _APP_SITES_ENABLED 与邮箱白名单控制:托管 Next.js / SvelteKit 等站点、一键回滚(Instant rollback)与自定义域名
底部治理链路日志/logs项目级底层链路与系统追踪日志检索
计量/usage/aggregates · /usage项目级最近 30 个 UTC 日四项计量聚合趋势与数据完整性状态
设置/settings · /settings/domains · /settings/webhooks · /settings/migrations · /settings/smtp · /settings/usage列删除开关、项目表模式转换、客户端 Services 开关、Global variables 全局变量、自定义域名、Webhooks、自定义 SMTP 与数据迁移

4. 项目控制台:AI 原生能力与 AgentOps 路由(前缀 /console/project-{region}-{project})

侧栏可见名称路径后缀与子路由层次核心功能与路径说明关联章节
智能体工作台(Agent Workbench)/agent-runtime在线装配主对话模型(如 qwen-plus)、系统提示词、企业知识库、长期记忆/PowerContext、干预词库、AI Gateway 工具与 Skill 技能包,支持多轮 ReAct 流式对话调试与项目级配置持久化(/v1/agent-runtime/project/*)智能体工作台概览、模型与词库配置、会话与运行、知识库与记忆协同、工具网关与技能包
上下文(PowerContext)/powercontext托管上下文初始化校验与可视化管理(服务端支持 /v1/projects/{projectId}/powercontext/compaction 显式预览/提交上下文压缩)记忆概览与启用
记忆(Memory)/memory(涵盖概览、记忆列表与检索、用户画像 Profiles、经验与技能 Evolution、模型路由 Models、上下文 Contexts、Pipeline 配置 Configuration、审计 Audit、轨迹 Traces)基于 Shared V2 的长期记忆全生命周期管理:四类 Pipeline 草稿验证与发布、经验与技能候选版本 Diff 审批回滚、图片/PDF 异步记忆解析记忆概览与启用、召回调优与 Pipeline 配置
知识库/knowledge-base · /knowledge-base/kb-{kb}(详情根路径为文档列表;search / wiki / graph / indexes / versions / datasources / settings / doc-{document})富文档摄取、标签树与 documentTag/subProductId 过滤、混合检索测试、GraphRAG / RAPTOR / LLM Wiki 索引构建(带进度与中断控制)、版本封存发布与回滚知识库概览与词库管理、Wiki、GraphRAG、RAPTOR 与索引治理
词库(Lexicons)/knowledge-base/lexicons独立维护同义词词典(如 lex_enterprise_synonyms)与停用词词典(如 lex_support_stopwords),支持绑定至知识库与工作台知识库概览与词库管理
模型(Models)/llm-gateway · /llm-gateway/provider-{provider} · /llm-gateway/keys · /llm-gateway/keys/{key}/usage · /llm-gateway/usage管理 DashScope 等模型供应商预设、导入 Chat/Embedding/Rerank/Vision 模型目录、签发带月度预算与限流的 Gateway KeyLLM Gateway 模型管理
AI 网关(AI Gateway)/ai-gateway · /ai-gateway/gateways · /ai-gateway/models-routes · /ai-gateway/policies-credentials · /ai-gateway/tools-agents · /ai-gateway/traffic-quality管理网关实例、策略、工具和流量;可用入口以当前部署和权限为准统一 AI 网关
智能体运维(Observability / AgentOps)/observability · /observability/traces · /observability/observations · /observability/sessions · /observability/users · /observability/scores · /observability/score-settings · /observability/prompts · /observability/metrics · /observability/evals · /observability/evaluation-skills · /observability/datasets · /observability/annotations · /observability/reports/overview · /observability/reports/agents · /observability/reports/quality侧栏分区名为 AgentOps:全链路 Trace/Observation 追踪、通用/Memory/解析/知识索引质量(GraphRAG/RAPTOR/Wiki)四类评估任务、内置评估模板目录、指标分析,以及按环境配置显示的报表看板可观测性概览、评估、评分与索引质量评测

常见问题与排障

Q1:直接拼接 URL 访问某个项目子页面时返回 404 或自动跳回组织首页是什么原因?

原因与排查步骤:

  1. 检查 {region} 与 {project} 参数:项目控制台路由严格要求格式为 /console/project-{region}-{project}/...(例如 /console/project-default-enterprise-ai-hub-210/overview)。若遗漏了 project-default- 前缀或项目 ID 拼写有误,路由守卫无法解析项目上下文。

  2. 检查当前账号所属组织权限:若当前登录的开发者账号尚未被邀请加入该项目所属的组织,服务端会拒绝加载项目元数据并重定向回账号默认组织页。

Q2:为什么看不到消息或智能体运维报表入口?

不同环境的侧栏入口和分区可能不同。请先确认所处项目、账号权限以及环境功能开关;智能体运维的界面可见性也可能受管理员配置限制。隐藏的智能体运维页面可能重定向,直接输入地址不保证可访问。如需启用或确认入口,请联系环境管理员。

Q3:为什么在侧栏能点进某个模块(如 Memory 或知识库高阶索引),但页面内操作返回 412?

原因与排查步骤: Console 浏览器路由存在仅代表前端 UI 组件已加载;当点击按钮发起后端 API 调用时,服务端会实时校验实例部署级 Capability 与项目前置条件。若项目表模式非 Shared V2(针对 Memory)或底层实例未启用可选索引 Worker(针对知识库高阶索引),后端即返回稳定的 HTTP 412。请对照常见问题中的 Capability 排障矩阵逐项核查。

相关文档