用途：优化 Omni 语义模型，使 Omni 的 AI 助手 Blobby 能生成准确且具备业务上下文的查询。建议先用 omni-model-explorer 查看现有 AI 上下文再修改。
前置条件：设置 export OMNI_BASE_URL="https://yourorg.omniapp.co" 与 export OMNI_API_KEY="your-api-key"，并具备 Modeler 或 Connection Admin 权限。不确定接口时可用 curl -L "$OMNI_BASE_URL/openapi.json" -H "Authorization: Bearer $OMNI_API_KEY" 获取 OpenAPI 规范核对端点与参数。
Blobby 依据 topic 结构、字段标签与描述、synonyms、ai_context、ai_fields、sample_queries 及隐藏字段生成查询，影响优先级为 ai_context > ai_fields > sample_queries > synonyms > 字段描述。
主要能力：通过 YAML API（POST $OMNI_BASE_URL/api/v1/models/{modelId}/yaml，指定 fileName、yaml、mode、commitMessage）写入配置。ai_context 用于术语映射、数据细节说明、行为指导与角色设定；ai_fields 用通配、否定、tag 等操作符裁剪可见字段；sample_queries 以示例问题加正确查询教 Blobby；可用 extends 创建 AI 专用 topic 变体；还可为维度与度量添加 synonyms 和更清晰的 description。
适用场景：模型较大、字段命名晦涩、用户常问业务术语或需要统一分析口径时。
限制：资料未提供价格、计费、平台范围或效果保证；实际权限、字段与端点须以组织环境及 OpenAPI 规范为准。