教程¶

教程提供基于真实业务目标的完整练习，用于在完成快速开始后巩固产品能力。

适用场景¶

工作区是资源、成员与权限的基本隔离边界。
AI Studio 的功能入口会随账号权限、部署模式和功能开关变化。
建议先跑通“连接数据 → 处理数据 → 建立知识库 → 使用智能体”的最短链路。

前置条件¶

确认已登录正确账号，并切换到目标工作区。
确认账号具备查看目标资源及执行对应操作的权限。
涉及外部系统时，提前准备网络连通性、最小权限账号和有效凭据。

产品入口与核心对象¶

项目	当前实现
页面入口	`/$workspaceId/` 工作区首页；账号流程根据 `AUTH_MODE` 由账户中心或内置页面承载。
服务契约	`AUTH_MODE` 支持 `sso`、`builtin` 和 `cloudsigma`；工作区 ID 会进入页面路由和后端请求上下文。
核心对象	账号会话、工作区、有效角色、功能开关、产品入口

操作流程¶

先完成快速开始，确认账号、工作区和基础数据链路可用。
选择与当前业务目标最接近的教程，并准备独立测试数据。
按照教程顺序完成配置，不跳过前置验证和权限检查。
记录关键对象标识、执行结果和失败信息，便于复现。
完成后转到对应指南，继续学习生产配置和治理要求。

状态说明¶

状态或信号	判断与处理
已登录 / 未登录	决定是否进入账户页或工作区。
工作区已选择	资源列表、权限与后续路由均以该工作区为边界。
入口可见 / 隐藏	由权限、部署产品和运行时功能开关共同决定。

结果验证¶

页面显示成功状态，且对象名称、工作区和更新时间与本次操作一致。
刷新页面后结果仍然存在；依赖该对象的下一步操作能够读取到最新配置。
如果失败，保留错误信息和请求标识，先检查权限、网络、凭据与依赖状态。

故障处理¶

现象	处理建议
登录后循环跳转	核对账户中心 URL、回调地址、Cookie 与系统时间。
工作区为空	确认账号已加入工作区且有效角色同步成功。
菜单缺失	先检查功能开关，再检查资源权限和部署版本。

生产就绪检查¶

身份与权限： 使用目标工作区中的最小权限账号，确认读、写、执行和删除权限分别满足要求。
变更与回滚： 记录对象 ID、版本、执行 ID 和变更时间；对删除、覆盖和重新索引准备回滚路径。
容量与稳定性： 先以代表性小批量验证超时、并发、配额、失败重试和下游影响，再逐步扩大范围。
可观测性： 把页面状态与服务日志、任务时间线或操作日志关联，不只依赖一次成功提示。

权限与限制¶

备注

页面以 MOI 5.0 当前产品模型为准；看不到某个入口时，先确认工作区、权限和功能开关。