在此页面端到端地构建一次扩充——示例数据、模式、模型、结果。页面中心是模式树:一个支持拖放排序、行内编辑、键盘导航和 AI 辅助修改的可视化编辑器。
架构树让你无需手写 JSON 即可查看和修改增强架构。属性以交互式树形结构呈现,并按专业领域分组,一眼就能看出哪些字段属于哪个专业方向。每次更改都会记入撤销/重做历史,并在 2 秒防抖后自动保存。
属性按专业领域分组,带可折叠的分区。可开关分组。
关闭「排序」视图后,可通过拖拽在组内或跨组重新排列属性——排列顺序会保存在架构中。可视化的放置位置指示器会显示项目将落在何处。
点击任意属性,即可直接在树中编辑其名称、类型、描述和示例。
方向键用于导航以及折叠或展开,Enter 编辑,Delete 删除,Ctrl+A 全选。撤销和重做是工具栏按钮,切换模式或重新加载页面后历史记录依然保留。
文本搜索用于在大型 schema 中查找字段:优先匹配属性名称,当没有名称匹配时回退到描述和示例。嵌套匹配项仅显示通向它们的路径。
手动编辑拥有完整的历史记录栈。AI 生成的更改会直接替换,不会添加撤销记录。
顶部的选项卡包含模式的命名类型。+ 按钮可创建对象(拥有自身属性的嵌套实体)或枚举(一组封闭的允许值列表,可供任意文本属性指向)。
位于 SCHEMA 和 JSON 旁边的 DIAGRAM 视图会将模式绘制成实体关系图——具名实体显示为带标题的卡片,嵌套对象显示为以其关系命名的普通卡片,引用 (1–1) 和链接 (1–N) 显示为虚线连线。该视图会实时跟随你的编辑,点击实体卡片即可在 SCHEMA 视图中打开它。
编辑器中的每一行代表一个 schema 属性,其关键特性一目了然:
嵌套属性(例如 headquarters 下的 city)会缩进显示以体现层级。放大镜图标标记搜索键——用于识别 entity 的字段。
值集将文本属性限制为一组固定的允许值 —— 例如状态、等级或分类代码。这样充实就无法返回该列表之外的任何内容,从而避免同一概念在多次运行中出现三种不同的写法。
在类型选项卡上按 +,选择枚举并为其命名。新选项卡会打开其成员列表。
添加、重命名、重新排序或删除值。当成员的含义无法从名称直接看出时,为其添加备注。
在类型下拉菜单的“值集”分组中,将任意文本属性的类型设置为该值集(或其数组)。
将属性的类型改回字符串,或删除该值集 —— 使用它的属性将重新变为普通文本属性。
只有当你能完整列出某个词汇表时,才使用值集。如果真实实体需要一个你遗漏的值,模型将被迫选择最接近的错误值,而不是报告问题 —— 因此开放式字段(名称、描述、自由文本类别)应保持为纯文本。出于同样的原因,模式生成会保守地建议值集,而它建议的所有内容都可以在此编辑。
点击某个属性行或按 Enter 键切换到编辑模式。在编辑模式下,你可以修改:
Schema 编辑器支持完全由键盘驱动的工作流,以实现高效编辑:
| 快捷键 | 操作 |
|---|---|
| Arrow Up / Down | 在属性之间导航(按住 Shift 可扩展选择) |
| Arrow Left / Right | 折叠或展开所选对象 |
| Home / End | 跳转到第一个或最后一个属性 |
| Enter | 切换所选属性的编辑模式 |
| Delete / Backspace | 移除所选属性 |
| Ctrl+A / Cmd+A | 选择所有属性 |
| Escape | 退出编辑模式或清除选择 |
手动调整顺序需要关闭已排序开关。编辑器默认按字母顺序列出属性,此时拖动被禁用——一个可能被视图设置悄悄覆盖的手工顺序并没有多大意义。取消勾选“已排序”后会切换到模式自身的排列并启用拖动;一条视觉插入线会精确显示属性将落在何处,最终顺序会随模式一起保存。你可以在同一专长分组内拖动,也可以跨分组拖动以更改领域归属。
启用专业领域分组后,将某个属性拖入不同的分组会自动更新其专业领域归属。这让重组大型架构变得直观——只需将某个字段从“财务分析师”拖到“监管专家”,其专业领域即会相应更新。
在属性树下方,AI 编辑窗格让您可以使用自然语言修改模式。输入诸如“添加 parent_company 引用”之类的指令,AI 便会在保留您现有结构的同时应用更改。
每次生成或编辑后,AI 会提供 5 条改进建议,以可点击的标签形式显示。点击某条建议即可自动填入编辑输入框并应用。建议涵盖数据完整性、质量、关系、国际化以及特定领域的增强。
在 AI schema 生成指南中了解有关 AI schema 编辑的更多信息。
在父级对象的上下文中解读属性名:它可能指向多少种不同的含义?恰好一种就是明确的。有两种或更多,该属性就会带上有歧义徽章——若各种解读大体重合、仅在边缘情况下有别,则显示为琥珀色;若会得出实质性不同的数据,则显示为红色。将鼠标悬停在徽章上,可查看该名称可能的各种冲突解读,以及锁定其中唯一一种含义的改写描述。若某个名称在父级中没有任何内容可作答,同样会被标记:此时提示框会列出曾考虑并排除的解读,修正方式是重命名或删除——没有任何描述能凭空赋予实体它并不具备的属性。
工具栏中的盾牌图标会分析尚无标注的属性,一旦全部标注完成,就会切换为完整的重新分析。每次运行都是一次小额计费的 AI 调用。
对于已保存的架构,徽章只会建议改写描述,而绝不会建议重命名:架构已经上线,因此在描述中锁定含义可以保持数据契约不变。仅仅复述名称的描述毫无意义,此时该属性会被视作没有描述来评判。
重命名属性或编辑其描述会移除该属性的标注——因为判定是基于两者共同得出的。编辑器会高亮这些属性并提供重新检查。
可从溢出菜单为某个模式禁用检查——徽章和警告将消失;对从未分析过的模式重新启用时,会自动运行检查。
完整机制——两种判定结果、各自背后的解读,以及为何在架构创建前应通过重命名修复、而在其上线后则应通过描述修复——请参阅歧义检查指南。
Schema 选择器让你可以创建、加载、置顶、复制和删除 schema。schema 按 organization 保存,所有团队成员均可访问。
更改会在暂停 2 秒后自动保存,并使用内容哈希去重以避免不必要的写入。
将常用模式置顶,使其保持在选择器列表的顶部。
创建任意架构的副本,以在不影响原架构的情况下试验更改。
已删除的 schema 可以恢复。永久删除是单独的操作。