omni-admin 面向 Omni Analytics 实例的管理员,用于通过 REST API 完成日常运维配置。使用前需设置环境变量:export OMNI_BASE_URL="https://yourorg.omniapp.co" 和 export OMNI_API_KEY="your-api-key"。多数管理端点要求组织级 API Key,而非个人访问令牌。把握不准端点或参数时,可先拉取 OpenAPI 规范:curl -L "$OMNI_BASE_URL/openapi.json" -H "Authorization: Bearer $OMNI_API_KEY"。
主要能力覆盖:连接管理(列出连接、连接环境、schema 刷新计划);用户与组管理走 SCIM 2.0 端点前缀 /api/scim/v2/,支持列出、按邮箱过滤、创建、停用和删除用户,以及创建组和增删成员;用户属性管理(列出属性,并通过 SCIM PATCH 设置,如 urn:omni:params:1.0:UserAttribute:region),用户属性可与 topic 中的 access_filters 配合实现行级安全;模型角色(用户角色、组角色);文档与文件夹权限的读取与设置;计划任务(列出、创建、管理收件人);缓存重置与内容校验器。内容校验器可用于影响范围分析:在分支上移除字段后,用 ?branchId={branchId} 运行校验器查看哪些内容会损坏。此外可查看模型的 Git 配置。
适用场景包括 Omni 实例的用户/组维护、细粒度权限与行级安全配置、定时报表分发、连接与 schema 刷新运维,以及模型变更前的影响评估。相关技能可配合使用:omni-model-builder 编辑访问控制所作用的模型,omni-content-explorer 在设置权限前查找文档,omni-content-builder 在安排交付前创建仪表板,omni-embed 管理嵌入用户与用户属性。限制方面:文档未提供具体收费、价格、平台支持范围或性能数据,这些细节暂未提供;使用时须以实际 OpenAPI 规范和实例权限为准。