Auto Ontology 管理与建模技能用于检查和修改 Auto Ontology 的语义层，同时避免把“API 调用成功”误当成“业务含义正确”或“已持久发布”。机器可读的输入、输出、状态、门禁与交接信息位于 runtime-contract.yaml。
用途与工作流选择：在动手前先选择聚焦的工作流。常规检查或元数据编辑继续使用 write-api.md；涉及概念、关系、度量、单位、粒度或策略时使用 modeling.md；涉及模型提升或可复用分析结果时使用 publication.md。
主要能力：MCP 工具只读，可用于语义发现，例如 search_terms、get_term、get_term_columns、get_term_sql_attributes、describe_table；若 MCP 不可用，可通过 REST 接口 GET /api/terms、GET /api/terms/{term_id}、GET /api/exploration/tables/{table_id}/details 查询。创建、补丁、导入与编译重置通过 Next.js /api/... 网关执行。术语到列的映射可用 MCP get_term_columns 或 GET /api/terms/{term_id}/column-attributes；术语到派生 SQL 用 MCP get_term_sql_attributes；表到术语与 SQL 属性用 MCP describe_table 或 GET /api/exploration/tables/{table_id}/details；两个术语之间的语义跳转链用 GET /api/exploration/terms/{term_id}/path/{other_term_id}；语义图用 GET /api/exploration/graph 与 GET /api/exploration/semantic-graph。这些是语义关系路径，不是生成来源、源修订、认证历史或版本沿袭。
使用方式：前置条件是使用正在运行且已认证的 Auto Ontology 部署；若部署或语义层未就绪，使用 nvidia-ontology-setup。脚本使用 API Token 认证（x-api-key 或 Authorization: Bearer），Token 在 UI 的用户菜单 → API Tokens 中生成；Token 以其所有者身份行事，查看者的 Token 无法执行管理员操作；创建和撤销 Token 需要已登录会话，Token 不能生成另一个 Token。除非另有说明，写入操作需要 catalog:edit；403 表示所有者角色缺少该权限，而不是路径错误。操作时先通过 MCP 或 REST 发现当前含义；含义变化时解析语义契约，记录源绑定、身份、总体、关系基数、度量表达式、单位、粒度、分母、时间、有效性与反例，详见 modeling.md；向用户说明拟议变更（术语重命名、新 SQL 属性、导入等），不要静默重写术语表；在创建或更新前校验 SQL：POST /api/sql-attributes/validate，解析失败是 HTTP 422，而非 valid: false；应用与请求匹配的最小写入；编译不是隐藏副作用，检查 GET /api/semantic-compilation/status，不要把 POST /api/semantic-compilation/reset 当作清理手段，它是异步的破坏性重建，会重建每个数据库的编译层，返回 202，且需要 semanticCompilation:manage；验证持久化变更而非仅请求成功，模型导入需要范围备份与精确再导出比对，详见 publication.md；随后用 MCP check_answerable / ask_question（或 REST POST /api/question-entity-coverage 与 POST /api/chat/completions）做正向与负向行为检查。
批量导入/导出：POST /api/model/export 导出目录与语义层的 YAML，权限 modelInterchange:export，请求体可在 databases 中设置目录数据库 ID（空表示全部）以及 format（auto_ontology 或 ossie）。POST /api/model/import 接收 multipart YAML，支持原生 Auto Ontology（data_layer / semantic_layer）或 Apache Ossie（版本、名称、根级数据集）；查询替换默认 true，嵌入默认 true，权限 modelInterchange:import；可能替换现有数据，在 replace=true 前需与用户确认，先在隔离环境应用，并使用 publication.md 中的精确回读工作流。
适用场景：定义与修改术语、关系、度量、单位、粒度与策略，进行语义层检查，导入导出模型，提升或发布模型，以及分析受治理结果。
限制：MCP 只读；Auto Ontology 没有通用的结果行回写端点，受治理结果行需要已批准的源写入器；当前模型导入与认证 API 不能证明原子性提升，需遵循发布门禁，在无法精确回读时失败关闭。写入失败时，检查已认证所有者的权限，区分 HTTP 422 解析失败与校验结果，并在更改模型或重置编译前检查编译状态。另见 write-api.md、modeling.md、publication.md、nvidia-ontology-query（如何调用 Auto Ontology 并验证查询结果）、nvidia-ontology-setup（部署未就绪）以及 mcp/auto_ontology_mcp/tools.py（实时读工具允许列表）。