工作流编辑器 - Entity Enricher 文档

工作流编辑器

在此页面端到端地构建一次扩充——示例数据、模式、模型、结果。页面中心是模式树:一个支持拖放排序、行内编辑、键盘导航和 AI 辅助修改的可视化编辑器。

概览

架构树让你无需手写 JSON 即可查看和修改增强架构。属性以交互式树形结构呈现,并按专业领域分组,一眼就能看出哪些字段属于哪个专业方向。每次更改都会记入撤销/重做历史,并在 2 秒防抖后自动保存。

主要功能

专业领域分组

属性按专业领域分组,带可折叠的分区。可开关分组。

拖放

关闭「排序」视图后,可通过拖拽在组内或跨组重新排列属性——排列顺序会保存在架构中。可视化的放置位置指示器会显示项目将落在何处。

内联编辑

点击任意属性,即可直接在树中编辑其名称、类型、描述和示例。

键盘导航

方向键用于导航以及折叠或展开,Enter 编辑,Delete 删除,Ctrl+A 全选。撤销和重做是工具栏按钮,切换模式或重新加载页面后历史记录依然保留。

搜索和筛选

文本搜索用于在大型 schema 中查找字段:优先匹配属性名称,当没有名称匹配时回退到描述和示例。嵌套匹配项仅显示通向它们的路径。

撤销 / 重做

手动编辑拥有完整的历史记录栈。AI 生成的更改会直接替换,不会添加撤销记录。

类型与值集

顶部的选项卡包含模式的命名类型。+ 按钮可创建对象(拥有自身属性的嵌套实体)或枚举(一组封闭的允许值列表,可供任意文本属性指向)。

关系图视图

位于 SCHEMA 和 JSON 旁边的 DIAGRAM 视图会将模式绘制成实体关系图——具名实体显示为带标题的卡片,嵌套对象显示为以其关系命名的普通卡片,引用 (1–1) 和链接 (1–N) 显示为虚线连线。该视图会实时跟随你的编辑,点击实体卡片即可在 SCHEMA 视图中打开它。

属性树

编辑器中的每一行代表一个 schema 属性,其关键特性一目了然:

选择属性名称类型描述
□company_name
🔍
string法定公司名称
□revenuenumber以美元计的年收入
□headquartersobject公司总部
□ citystring市镇名称
□ country
🔍
string总部所在国家/地区
□gmp_statusbooleanGMP 认证状态

嵌套属性(例如 headquarters 下的 city)会缩进显示以体现层级。放大镜图标标记搜索键——用于识别 entity 的字段。

值集(枚举)

值集将文本属性限制为一组固定的允许值 —— 例如状态、等级或分类代码。这样充实就无法返回该列表之外的任何内容,从而避免同一概念在多次运行中出现三种不同的写法。

使用值集

创建一个

在类型选项卡上按 +,选择枚举并为其命名。新选项卡会打开其成员列表。

编辑成员

添加、重命名、重新排序或删除值。当成员的含义无法从名称直接看出时,为其添加备注。

使用它

在类型下拉菜单的“值集”分组中,将任意文本属性的类型设置为该值集(或其数组)。

撤销

将属性的类型改回字符串,或删除该值集 —— 使用它的属性将重新变为普通文本属性。

只有当你能完整列出某个词汇表时,才使用值集。如果真实实体需要一个你遗漏的值,模型将被迫选择最接近的错误值,而不是报告问题 —— 因此开放式字段(名称、描述、自由文本类别)应保持为纯文本。出于同样的原因,模式生成会保守地建议值集,而它建议的所有内容都可以在此编辑。

编辑属性

点击某个属性行或按 Enter 键切换到编辑模式。在编辑模式下,你可以修改:

名称JSON 输出中的属性键。请使用 snake_case 以保持一致。
类型从 string、number、integer、boolean、array 或 object 中选择。更改类型会更新 enrichment 输出格式。
描述在 enrichment 过程中引导 AI 的上下文描述。描述越详细,结果越好。
示例两三个真实的示例值。它们有助于 AI 理解预期的格式和内容。
专业领域由哪个领域专家提供该值。决定多专业领域富集中的分组方式。
可为 Null真实实例是否确实可以缺少该值。非空字段是进入数据库的必要条件——无法填充这些字段的丰富化会被质量门禁拒绝。对数据库键(null 值无法标识任何行)和保留字段(你的输入始终提供其值)不可用。
多语言该字段是否应以多种语言进行富集。
保留是否保持原始输入值不变。适用于由你自己系统所有的值——数据库 id、内部 SKU、客户参考编号——而非 enrichment 可为你查询的公共标识符(CAS、ISBN、EAN、股票代码)。此时每次 enrichment 都必须为其提供一个值。

键盘快捷键

Schema 编辑器支持完全由键盘驱动的工作流,以实现高效编辑:

快捷键操作
Arrow Up / Down在属性之间导航(按住 Shift 可扩展选择)
Arrow Left / Right折叠或展开所选对象
Home / End跳转到第一个或最后一个属性
Enter切换所选属性的编辑模式
Delete / Backspace移除所选属性
Ctrl+A / Cmd+A选择所有属性
Escape退出编辑模式或清除选择

拖放重新排序

手动调整顺序需要关闭已排序开关。编辑器默认按字母顺序列出属性,此时拖动被禁用——一个可能被视图设置悄悄覆盖的手工顺序并没有多大意义。取消勾选“已排序”后会切换到模式自身的排列并启用拖动;一条视觉插入线会精确显示属性将落在何处,最终顺序会随模式一起保存。你可以在同一专长分组内拖动,也可以跨分组拖动以更改领域归属。

启用专业领域分组后,将某个属性拖入不同的分组会自动更新其专业领域归属。这让重组大型架构变得直观——只需将某个字段从“财务分析师”拖到“监管专家”,其专业领域即会相应更新。

AI 编辑面板

在属性树下方,AI 编辑窗格让您可以使用自然语言修改模式。输入诸如“添加 parent_company 引用”之类的指令,AI 便会在保留您现有结构的同时应用更改。

AI 建议

每次生成或编辑后,AI 会提供 5 条改进建议,以可点击的标签形式显示。点击某条建议即可自动填入编辑输入框并应用。建议涵盖数据完整性、质量、关系、国际化以及特定领域的增强。

AI schema 生成指南中了解有关 AI schema 编辑的更多信息。

歧义徽章

在父级对象的上下文中解读属性名:它可能指向多少种不同的含义?恰好一种就是明确的。有两种或更多,该属性就会带上有歧义徽章——若各种解读大体重合、仅在边缘情况下有别,则显示为琥珀色;若会得出实质性不同的数据,则显示为红色。将鼠标悬停在徽章上,可查看该名称可能的各种冲突解读,以及锁定其中唯一一种含义的改写描述。若某个名称在父级中没有任何内容可作答,同样会被标记:此时提示框会列出曾考虑并排除的解读,修正方式是重命名或删除——没有任何描述能凭空赋予实体它并不具备的属性。

重新检查按钮

工具栏中的盾牌图标会分析尚无标注的属性,一旦全部标注完成,就会切换为完整的重新分析。每次运行都是一次小额计费的 AI 调用。

此处的补救方式是使用描述

对于已保存的架构,徽章只会建议改写描述,而绝不会建议重命名:架构已经上线,因此在描述中锁定含义可以保持数据契约不变。仅仅复述名称的描述毫无意义,此时该属性会被视作没有描述来评判。

过时的标注

重命名属性或编辑其描述会移除该属性的标注——因为判定是基于两者共同得出的。编辑器会高亮这些属性并提供重新检查。

按模式切换

可从溢出菜单为某个模式禁用检查——徽章和警告将消失;对从未分析过的模式重新启用时,会自动运行检查。

完整机制——两种判定结果、各自背后的解读,以及为何在架构创建前应通过重命名修复、而在其上线后则应通过描述修复——请参阅歧义检查指南。

Schema 管理

Schema 选择器让你可以创建、加载、置顶、复制和删除 schema。schema 按 organization 保存,所有团队成员均可访问。

自动保存

更改会在暂停 2 秒后自动保存,并使用内容哈希去重以避免不必要的写入。

置顶模式

将常用模式置顶,使其保持在选择器列表的顶部。

复制

创建任意架构的副本,以在不影响原架构的情况下试验更改。

软删除

已删除的 schema 可以恢复。永久删除是单独的操作。

后续步骤