スキーマエディター - Entity Enricher ドキュメント

スキーマエディタ

エンリッチメントスキーマを管理するためのビジュアルツリーエディター。ドラッグ&ドロップによる並べ替え、インライン編集、キーボードナビゲーション、AI支援による変更に対応しています。

概要

スキーマエディターでは、JSON を手作業で書くことなく、enrichment schema を表示・変更できます。プロパティは expertise domain ごとにグループ化されたインタラクティブなツリーとして表示されるため、どのフィールドがどの専門領域に属するかを一目で確認できます。すべての変更は元に戻す/やり直しの履歴で追跡され、2 秒のデバウンス後に自動保存されます。

主な機能

専門知識のグループ化

プロパティはexpertise domainごとに折りたたみ可能なセクションでグループ化されます。グループ化のオン/オフを切り替えられます。

ドラッグ&ドロップ

ドラッグしてグループ内またはグループ間でプロパティを並べ替えます。視覚的なドロップ先インジケーターが項目の配置先を示します。

インライン編集

任意のプロパティをクリックすると、その名前、型、説明、例をツリー内で直接編集できます。

キーボードナビゲーション

矢印キーで移動、Enterで編集、Deleteで削除します。完全にキーボードで操作できるワークフローです。

検索とフィルター

プロパティ名や説明を対象にテキスト検索し、大規模な schema 内のフィールドを見つけます。

元に戻す / やり直し

手動編集の完全な履歴スタックです。AI が生成した変更は、元に戻すエントリを追加せずに置き換えられます。

プロパティツリー

エディター内の各行は、主要な属性が一目で分かる 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 中に AI を導く文脈的な説明です。詳細であるほど、より良い結果が得られます。
現実的な例の値を2〜3個。AIが期待される形式や内容を理解するのに役立ちます。
専門知識この値を提供するドメインエキスパートを示します。複数のexpertise domainによるエンリッチメントでのグループ化を決定します。
Null許容nullが許容される値かどうかです。null非許容のフィールドは、空のままだとAIによる再試行が発生します。
多言語対応フィールドを複数の言語でエンリッチメントするかどうかです。
保持元の入力値を変更せずに保持するかどうかです。

キーボードショートカット

スキーマエディターは、効率的な編集のためにキーボード操作による完全なワークフローをサポートしています。

ショートカットアクション
Arrow Up / Downプロパティ間を移動します
Enter選択したプロパティの編集モードを切り替える
Delete / Backspace選択したプロパティを削除
Ctrl+Z / Cmd+Z最後の変更を元に戻す
Ctrl+Shift+Z / Cmd+Shift+Z取り消した変更をやり直します
Escape編集モードを終了するか選択を解除します

ドラッグ&ドロップによる並べ替え

プロパティを新しい位置にドラッグして並べ替えます。視覚的な挿入ラインがプロパティの配置される場所を正確に示します。専門グループ内またはグループ間でプロパティをドラッグして、ドメインの割り当てを変更できます。

expertise domain のグループ化が有効な場合、プロパティを別のグループにドロップすると、その expertise domain の割り当てが自動的に更新されます。これにより大規模な schema の再編成が直感的になります。フィールドを「Financial Analyst」から「Regulatory Expert」にドラッグするだけで、その expertise domain が適切に更新されます。

AI編集ペイン

プロパティツリーの下にあるAI編集ペインでは、自然言語を使ってschemaを変更できます。「parent_company リファレンスを追加して」のような指示を入力すると、AIが既存の構造を保ちながら変更を適用します。

AIによる提案

生成または編集のたびに、AIはクリック可能なチップとして表示される5つの改善提案を提供します。提案をクリックすると、編集入力欄に自動的に入力され、適用されます。提案は、データの完全性、品質、関係性、国際化、およびドメイン固有の拡張をカバーします。

AIによるスキーマ編集について詳しくは、AIスキーマ生成ガイドをご覧ください。

スキーマ管理

スキーマセレクターでは、schema の作成、読み込み、ピン留め、複製、削除ができます。schema は organization ごとに保存され、すべてのチームメンバーがアクセスできます。

自動保存

変更は 2 秒間の停止後に自動保存され、不要な書き込みを避けるためコンテンツハッシュによる重複排除が行われます。

スキーマをピン留め

よく使うスキーマをピン留めして、セレクターリストの先頭に表示します。

複製

任意のschemaのコピーを作成し、元のschemaに影響を与えずに変更を試すことができます。

論理削除

削除したschemaは復元できます。完全な削除は別の操作です。

次のステップ