用途:通过 Omni Analytics 的 REST API 查找、浏览和整理内容,包括仪表盘、工作簿和文件夹。
前置条件:需配置环境变量 OMNI_BASE_URL 和 OMNI_API_KEY。
主要能力:
- 列出全部内容,可通过 include=_count,labels 附带计数与标签;
- 按标签(labels=finance,marketing)、范围(scope=organization)过滤,按 favorites 或 updatedAt 排序;
- 使用 cursor 进行游标分页;
- 列出文档并按 creatorId 过滤,文档含 identifier、name、type、scope、owner、folder、labels、updatedAt、hasDashboard;
- 获取文档查询定义(GET /api/v1/documents/{identifier}/queries);
- 文件夹的列出与创建;
- 标签的列出、为文档添加/移除标签;
- 收藏与取消收藏;
- 仪表盘下载(异步,支持 pdf、png),并轮询任务状态。
使用方式:先按需获取 OpenAPI 规范(/openapi.json)确认端点与参数;调用 API 时始终使用 identifier 字段而非 id,因为 workbook 类型文档的 id 为 null,会导致静默失败;找到内容后按 URL 模式生成可点击链接(仪表盘 /dashboards/{identifier},工作簿 /w/{identifier})。
适用场景:浏览和整理组织内容、排查仪表盘背后的查询、批量扫描文档字段引用(分页并并行请求各文档 queries)、为内容生成直达链接。
限制:字段影响分析建议改用 omni-model-explorer 中的 content-validator 方法;相关技能包括 omni-query、omni-content-builder、omni-embed、omni-admin。资料未提供具体收费、价格或配额信息。