用途：优化 Omni 语义模型，使 Omni Agent（Blobby）返回准确、有上下文的答案。建议先用 omni-model-explorer 查看现有 AI 上下文。
前提：需安装 Omni CLI（https://github.com/exploreomni/cli#readme），并具备 Modeler 或 Connection Admin 权限。用 command -v omni 检查安装，omni config show 查看配置，omni config use <profile-name> 切换，omni whoami 确认身份。认证用 API key 或 OAuth；若返回 401，请用户运行 ! omni config login <profile>，不要在无头/CI 会话中自行运行。
主要能力：通过 YAML API 写入 ai_context、ai_fields、synonyms、sample_queries 及 AI 专用 topic 扩展。上下文优先级为 Omni 预置、模型/主题/视图的 ai_context、主题描述、主题名与 base_view、字段属性；空间不足时按 all_values→sql→sample_values→description→group_label→label→aggregate_type→data_type→synonyms 顺序裁剪，ai_context 不裁剪。
用法要点：先建分支再写，用 omni models yaml-create <modelId> --body '{...}' 并传 branchId；主题级请求优先用主题级 ai_context/ai_fields/sample_queries，字段级 synonyms 仅用于单字段别名。ai_context 支持 {{omni_attributes.<name>}}、omni_llm（smartest/standard/fastest）、omni_agent（analyze/build/simple_summarize）与 @{constant_name} 常量。ai_fields 支持通配符、- 否定与 tag: 选择器。ai_chat_topics 控制主题可见性。sample_queries 建议在 workbook 中构建后保存。
限制：上下文是引导而非指令，行为非确定性，模型级 ai_context 不保证覆盖主题级；ai_context 目标 1-2 句，过长会挤占字段元数据甚至导致请求失败；字段 ai_context 不支持属性替换。资料未提供收费、价格与平台信息。