用途：通过 Omni CLI 管理 Omni Analytics 实例，覆盖连接、用户、用户组、用户属性、权限、定时任务和 schema 刷新等管理操作。多数管理端点需要组织级 API Key，而非个人访问令牌。
主要能力：连接管理（列出连接、schema 刷新计划、连接环境、dbt 提交签名密钥轮换）；用户与用户组管理（基于 SCIM 2.0 的增删改查、按邮箱过滤、停用用户）；用户属性（列出系统与自定义属性、创建/更新/删除定义、通过 SCIM 为用户设置属性值，可与 topic 的 access_filters 配合实现行级安全）；模型角色与调用者访问（用 omni whoami whoami --model-id 读取 rolesByModel 权限，判断分支、共享模型合并、工作簿创作等能力）；文档与文件夹权限（查看有效权限、添加直接授权、Access Boost）；定时任务（列出、创建、管理收件人）。
使用方式：先确认 Omni CLI 已安装，用 omni config show 查看配置、omni config use <profile-name> 切换配置，用 omni whoami whoami 确认认证与权限。若返回 401，请用户运行 ! omni config login <profile> 完成 OAuth 2.1 浏览器流程；无浏览器环境不要自行执行 config login。无 CLI 配置但环境提供凭据时，可显式传入：omni <command> --base-url "$OMNI_BASE_URL" --token "$OMNI_API_TOKEN"。用 omni <命令> --help 发现命令，用 --schema 查看参数、请求体结构与响应形状，用 -o json 或 -o human 控制输出格式。
适用场景：需要以命令行方式批量或脚本化地管理 Omni 实例的组织、权限与调度配置。
限制：创建操作遇冲突时应先查找并核对状态；写后应读取具体资源验证。角色名由服务端校验且实例相关，无法通过 --schema 或列表命令发现，未知值返回 422。删除用户属性定义会连带删除所有用户值，并可能影响嵌入 SSO 登录、模型 SQL 和连接环境选择，需先搜索模型并与用户确认。数字值以字符串存储，超过 2^53-1 的 JSON 数字会被静默舍入。schedules update 是全量替换而非补丁，未提供的可选属性会重置为默认值，且读取形状与写入形状不一致。Access Boost 会放宽访问控制，须先确认意图并优先使用最小范围。SCIM API 仅接受组织级 API Key，用户级 PAT/OAuth 会被拒绝。部分功能有 CLI 版本要求（如签名密钥轮换需 CLI ≥ 1.1.2，用户属性创建需 CLI ≥ 1.4.0）。