# Omni Agent Skills：为AI智能体打造的企业级分析工具集

> Omni Agent Skills是一套面向Claude Code、Cursor、OpenAI Codex等AI编程助手的技能集合，帮助AI智能体更好地理解和执行Omni Analytics工作流，涵盖模型探索、查询、仪表板构建、语义建模等多个场景。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-06T13:44:55.000Z
- 最近活动: 2026-04-06T13:53:45.093Z
- 热度: 145.8
- 关键词: Omni Analytics, AI智能体, Claude Code, Cursor, 商业智能, 语义建模, 数据查询, 仪表板, Snowflake, skills.sh
- 页面链接: https://www.zingnex.cn/forum/thread/omni-agent-skills-ai
- Canonical: https://www.zingnex.cn/forum/thread/omni-agent-skills-ai
- Markdown 来源: ingested_event

---

## 引言：当AI智能体遇见商业智能

在商业智能（BI）领域，Omni Analytics以其独特的语义层架构和强大的数据建模能力脱颖而出。然而，对于AI智能体来说，理解和操作复杂的BI工具并非易事。Omni Agent Skills项目正是为了解决这一问题而生——它提供了一套完整的技能集合，让AI智能体能够像专业数据分析师一样使用Omni平台。

本文将深入介绍Omni Agent Skills的架构设计、核心技能、安装配置方法以及实际应用场景，帮助读者理解如何通过AI智能体提升数据分析效率。

## 什么是Omni Agent Skills

Omni Agent Skills是Omni Analytics官方维护的一套AI智能体技能，支持Claude Code、Cursor、OpenAI Codex、Snowflake Cortex Code等主流AI编程助手。这些技能不是简单的斜杠命令或一次性提示词，而是一旦安装就能在智能体环境中持续可用的能力模块。

项目的核心目标是将受管控的Omni工作流直接引入智能体环境，通过一个统一的安装目标，覆盖模型探索、查询、仪表板创建、语义建模、AI优化、管理操作和嵌入工作等多个场景。

这套技能集合包含9个生产级技能、3个专业智能体和3个Cursor规则文件，为Omni工作流提供单一可信来源，并支持跨主流智能体平台使用。

## 核心技能详解

Omni Agent Skills提供了9个生产级技能，每个技能都针对特定的Omni工作流场景：

### 模型探索与构建

**omni-model-explorer**技能用于发现和检查模型、主题、视图、字段、维度、度量和关系。当用户询问"我们的Omni模型中有哪些主题可用？"时，智能体可以自动加载此技能并回答。

**omni-model-builder**技能支持以YAML格式创建和编辑视图、主题、维度、度量和关系。这使得智能体能够帮助用户进行语义建模工作，例如"在users视图中添加一个客户层级的新维度"。

### 数据查询与内容管理

**omni-query**技能允许智能体针对Omni的语义层运行查询并解释结果。用户可以用自然语言提问，如"运行一个查询，显示按月份划分的收入"，智能体会自动构建并执行相应的查询。

**omni-content-explorer**技能帮助查找、浏览和组织仪表板、工作簿和文件夹。当用户需要找到特定的销售绩效仪表板时，这个技能就派上用场。

**omni-content-builder**技能支持以编程方式创建、更新和管理文档和仪表板，包括生命周期管理、图块、筛选器和布局。

### AI优化与评估

**omni-ai-optimizer**技能专门用于优化Omni模型，使其更好地支持Blobby（Omni的AI助手）。这包括改善AI上下文、优化字段描述等。

**omni-ai-eval**技能用于评估AI查询生成的准确性，可以运行测试提示、比较结果并按维度评分。这对于确保AI生成查询的质量至关重要。

### 管理与集成

**omni-admin**技能管理连接、用户、组、权限、计划和模式刷新等管理操作。这需要组织API密钥才能执行某些工作流。

**omni-embed**技能支持将Omni仪表板嵌入外部应用程序，包括URL签名、主题设置和postMessage事件处理。

**omni-to-snowflake-semantic-view**技能可以将Omni Analytics主题转换为Snowflake语义视图YAML定义，实现跨平台语义层共享。

## 专业智能体：深度多步工作流

除了单个技能，Omni Agent Skills还提供了3个专业智能体，用于更复杂的多步工作流：

### omni-analyst智能体

omni-analyst是一个专注于探索模型、运行查询和提供洞察的智能体。当用户需要深度数据分析时，可以显式调用此智能体：

```
@omni-analyst 本季度按收入排名的前10个产品是什么？
```

这个智能体会自动加载相关技能，理解业务上下文，并生成有价值的分析结果。

### omni-modeler智能体

omni-modeler专注于构建语义模型、编写YAML和AI优化。例如：

```
@omni-modeler 在users视图中添加客户生命周期价值指标
```

这个智能体不仅理解Omni的建模语法，还能根据最佳实践提供优化建议。

### omni-admin-agent智能体

omni-admin-agent处理用户、权限、计划和连接等管理任务：

```
@omni-admin-agent 为营销团队设置执行仪表板的每周PDF交付
```

## 多平台安装指南

Omni Agent Skills支持多种AI编程助手平台，每种平台有特定的安装方法：

### Claude Code安装

**通过插件市场安装（推荐）**：

```
/plugin marketplace add exploreomni/omni-agent-skills
/plugin install omni-analytics@omni-analytics
```

**通过Git URL安装**：

```
/plugin marketplace add https://github.com/exploreomni/omni-agent-skills.git
/plugin install omni-analytics@omni-analytics
```

### Cursor安装

Cursor支持完整的插件安装以及额外的.mdc规则文件：

```
/add-plugin https://github.com/exploreomni/omni-agent-skills.git
```

Cursor会自动加载rules/目录中的规则文件，包括API约定、YAML约定和术语映射。

### skills.sh兼容代理安装

对于OpenAI Codex、GitHub Copilot、Gemini CLI等skills.sh兼容的代理：

```bash
# 预览可用技能
npx skills add exploreomni/omni-agent-skills --list

# 安装完整集合
npx skills add exploreomni/omni-agent-skills

# 安装单个技能
npx skills add https://github.com/exploreomni/omni-agent-skills --skill omni-query

# 全局安装
npx skills add exploreomni/omni-agent-skills --global

# 检查更新
npx skills check
npx skills update
```

### Snowflake Cortex Code安装

Cortex Code可以直接加载技能文件夹作为自定义技能：

```bash
# 安装所有技能到当前项目
mkdir -p .cortex/skills
cp -R skills/* .cortex/skills/

# 安装单个技能
mkdir -p .cortex/skills
cp -R skills/omni-query .cortex/skills/
```

在Snowsight工作区中，也可以直接上传技能文件夹。

## Omni CLI配置与认证

在使用Omni Agent Skills之前，需要配置Omni CLI工具：

### 安装Omni CLI

```bash
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/exploreomni/cli/main/install.sh | sh
```

这会下载最新版本，验证SHA-256校验和，并将omni二进制文件安装到/usr/local/bin（如果没有写入权限则安装到~/.local/bin）。

### 配置认证

**交互式配置（推荐）**：

```bash
omni config init
```

**环境变量配置**：

```bash
export OMNI_BASE_URL="https://yourorg.omniapp.co"
export OMNI_API_TOKEN="your-api-key"
```

API密钥可以在Omni的设置中创建：组织管理员使用Settings > API Keys，个人用户使用User Profile > Manage Account > Generate Token。

注意：某些管理工作流（如模式刷新、权限管理、计划设置）需要组织API密钥。

## Cursor规则文件详解

Omni Agent Skills为Cursor提供了3个.mdc规则文件，这些文件会被Cursor自动加载：

### omni-api-conventions.mdc

定义了API调用的约定，包括认证头、基础URL模式、错误处理和分页机制。这确保智能体生成的API调用符合Omni的最佳实践。

### omni-yaml-conventions.mdc

规定了YAML文件的类型、字段语法以及维度和度量模式。Omni的语义模型使用YAML定义，这些规则帮助智能体生成正确的模型代码。

### omni-terminology.mdc

将商业智能术语映射到Omni特定的词汇表。例如，解释"主题"（Topic）在Omni中的具体含义，以及它与"视图"（View）的关系。

注意：这些规则文件在Cursor中自动加载，但在Claude Code、Cortex Code和skills.sh兼容代理中不会作为插件规则加载。在这些工具中，它们应被视为共享参考材料。

## 实际使用场景示例

以下是一些使用Omni Agent Skills的实际场景：

### 自然语言查询

用户可以直接用自然语言提问，智能体自动加载omni-query技能，构建并执行查询，返回结果。这种方式大大降低了数据分析的门槛，非技术用户也能轻松获取数据洞察。

### 模型探索

通过omni-model-explorer技能，智能体可以列出所有可用主题及其描述，帮助用户快速了解数据模型的结构和内容。这对于新加入团队的成员尤其有价值。

### 语义建模

omni-model-builder技能让智能体能够生成YAML代码并应用更改，实现语义层的自动化构建。这包括添加新维度、创建计算度量、定义关系等。

### 仪表板创建

使用omni-content-builder技能，智能体可以创建包含适当图块的仪表板，设置筛选器和布局，实现从数据到可视化的端到端自动化。

### AI优化

omni-ai-optimizer技能分析模型并提供优化建议，改善AI上下文和字段描述，使Blobby等AI助手能更好地理解和使用模型。

### 权限管理

omni-admin技能处理用户、组和权限的配置，确保数据访问的安全性和合规性。这对于企业级部署至关重要。

### 嵌入集成

omni-embed技能生成带签名的嵌入URL，支持将Omni仪表板集成到外部应用程序中，扩展BI能力的触达范围。

### 跨平台语义层共享

omni-to-snowflake-semantic-view技能实现Omni与Snowflake之间的语义层互操作，保护企业在语义建模上的投资。

## 团队协作配置

为了让整个团队自动使用Omni Agent Skills，可以在项目的.claude/settings.json中添加配置：

```json
{
  "extraKnownMarketplaces": {
    "omni-analytics": {
      "source": {
        "source": "github",
        "repo": "exploreomni/omni-agent-skills"
      }
    }
  },
  "enabledPlugins": ["omni-analytics@omni-analytics"]
}
```

当团队成员信任仓库文件夹时，Claude Code会自动安装市场和插件。

### 自动更新配置

启用自动更新可以通过运行`/plugin`命令，进入Marketplaces，选择市场并启用自动更新。或者通过`/plugin`菜单手动更新。

## 项目架构与文件组织

Omni Agent Skills的代码库组织清晰，便于理解和扩展。项目包含Claude Code和Cursor的插件配置、技能目录、智能体定义、Cursor规则文件和静态资源。这种模块化的架构使得用户可以根据需要选择安装特定的技能或智能体。

## 相关资源与文档

Omni Agent Skills项目提供了丰富的文档资源，包括Omni REST API参考、建模文档、AI优化指南、MCP服务器文档，以及Claude Code和Cursor的插件文档。此外，skills.sh平台提供了技能共享的标准化方法。

## 贡献与开源许可

Omni Agent Skills是一个开源项目，采用Apache 2.0许可证。项目欢迎社区贡献，开发者可以通过GitHub提交Issue或Pull Request。作为Omni Analytics代理技能的单一可信来源，社区的参与对于项目的持续发展至关重要。

## 结语：AI赋能的商业智能未来

Omni Agent Skills代表了商业智能与AI智能体结合的前沿方向。通过将Omni强大的语义层能力与AI智能体的自然语言理解能力相结合，企业可以大幅降低数据分析的门槛，让更多非技术用户也能从数据中获取洞察。

随着AI技术的不断进步，我们可以预见，未来的BI工具将更加智能化、对话化。Omni Agent Skills为这一趋势奠定了基础，为数据驱动的决策提供了更强大的工具支持。无论是数据分析师、业务用户还是开发者，都能从中受益，实现更高效、更智能的数据工作流。