メタデータ

メタデータとは？

定義

メタデータは他のデータを説明するための情報です。簡単に言えば、「データに関するデータ」です。これは本の目次やラベルのようなもので、データの内容、出所、用途を紹介します。データの文脈を提供することで、メタデータはナレッジベース内でのデータの迅速な検索と管理を支援します。

ナレッジベースのメタデータ定義

フィールド（Field）：メタデータフィールドは文書の特定の属性を説明するための識別項目で、各フィールドは文書のある特徴や情報を表します。例えば「author」「language」など。
フィールド値（Value）：フィールド値はそのフィールドの具体的な情報や属性です。例えば「Jack」「English」。

フィールド値カウント（Value Count）：フィールド値カウントは、あるメタデータフィールドにマークされているフィールド値の数を指し、重複項目も含みます。例えば、ここでの「3」はフィールド値カウントであり、そのフィールドに3つのユニークなフィールド値があることを示します。

値タイプ（Value Type）：値タイプはフィールド値の種類を指します。
- 現在、Difyのメタデータ機能は以下の三種類の値タイプをサポートしています：
  - 文字列（String）：テキスト値。
  - 数値（Number）：数値。
  - 時間（Time）：日付と時間。

ナレッジベースのメタデータはどのように管理するか？

ナレッジベースのメタデータフィールドの管理

ナレッジベース管理インターフェースでは、メタデータフィールドの作成、修正、削除ができます。

注意：このインターフェースで行うすべての更新はグローバル更新であり、メタデータフィールドリストへの変更はナレッジベース全体に影響し、すべての文書にマークされたメタデータを含みます。

メタデータ管理インターフェースの紹介

メタデータ管理インターフェースへのアクセス

ナレッジベース管理インターフェースで、右上の メタデータ ボタンをクリックして、メタデータ管理インターフェースに入ります。

ナレッジベースのメタデータフィールドの種類

ナレッジベースでは、メタデータフィールドはビルトインメタデータ（Built-in）とカスタムメタデータの二種類に分かれます。

Feature	ビルトインメタデータ（Built-in）	カスタムメタデータ
表示位置	ナレッジベースインターフェースのメタデータ欄の下半分。	ナレッジベースインターフェースのメタデータ欄の上半分。
有効化方法	デフォルトでは無効で、手動で有効にする必要があります。	ユーザーが必要に応じて自由に追加できます。
生成方法	有効化後、システムが自動的に関連情報を抽出してフィールド値を生成します。	ユーザーが手動で追加し、完全にユーザー定義です。
修正権限	一度生成されると、フィールドとフィールド値は修正できません。	フィールド名の削除や編集が可能で、フィールド値も修正できます。
適用範囲	有効化後、既にアップロードされた文書と新たにアップロードされるすべての文書に適用されます。	メタデータフィールドを追加した後、フィールドはナレッジベースのメタデータリストに保存されます。具体的な文書にそのフィールドを適用するには手動設定が必要です。
フィールド	システムによって事前定義され、以下を含みます： document_name (string)：ファイル名 uploader (string)：アップローダー upload_date (time)：アップロード日 last_update_date (time)：最終更新時間 source (string)：ファイルソース	初期状態では、ナレッジベースにカスタムメタデータフィールドはなく、ユーザーが手動で追加する必要があります。
フィールド値タイプ	文字列 (string)：テキスト値数値 (number)：数値時間 (time)：日付と時間	文字列 (string)：テキスト値数値 (number)：数値時間 (time)：日付と時間

メタデータフィールドの新規作成

+メタデータを追加 ボタンをクリックすると、メタデータの新規作成 ポップアップが表示されます。

フィールド値タイプ でメタデータフィールドの値タイプを選択します。
名前ボックスにフィールドの名前を入力します。

フィールド名は小文字、数字、アンダースコア（_）のみをサポートし、スペースや大文字はサポートしていません。

保存ボタンをクリックして、フィールドを保存します。

メタデータフィールドの修正

単一のメタデータフィールドの右側にある編集ボタンをクリックすると、リネーム ポップアップが表示されます。

名前ボックスでフィールド名を修正します。

このポップアップではフィールド名の修正のみをサポートし、フィールド値タイプの修正はサポートしていません。

保存ボタンをクリックして、修正後のフィールドを保存します。

修正して保存すると、そのフィールドはナレッジベース内のすべての関連文書で同期更新されます。

メタデータフィールドの削除

単一のメタデータフィールドの右側にある削除ボタンをクリックすると、そのフィールドを削除できます。

単一のフィールドを削除すると、そのフィールドおよびそのフィールドに含まれるフィールド値がナレッジベースのすべての文書から削除されます。

文書メタデータ情報の編集

文書メタデータ情報の一括編集

ナレッジベース管理インターフェースで文書のメタデータ情報を一括編集できます。

メタデータ編集ポップアップを開く

ナレッジベース管理インターフェースを開き、文書リストの左側にある白いボックスで一括操作したい文書をチェックします。チェックすると、ページの下部に操作オプションが表示されます。

Entrance of Edit Metadata

操作オプションの メタデータ をクリックすると、メタデータの編集 ポップアップが表示されます。

メタデータ情報の一括追加

メタデータの編集 ポップアップの下部にある +メタデータを追加 ボタンをクリックすると、操作ポップアップが表示されます。

選択した文書に既に作成されたフィールドを追加する場合：
- ドロップダウンリストから既存のフィールドを選択して、フィールドリストに追加できます。
- メタデータを検索 検索ボックスで必要なフィールドを検索し、その文書のフィールドリストに追加できます。
選択した文書に新しいフィールドを作成する場合は、ポップアップの左下にある +メタデータを新規作成 ボタンをクリックし、前述の メタデータフィールドの新規作成 セクションを参照してフィールドを作成できます。

+メタデータを新規作成 ポップアップで作成したメタデータフィールドは、自動的にナレッジベースのフィールドリストに同期されます。

既に作成されたフィールドを管理する場合は、そのポップアップの右下にある管理ボタンをクリックすると、ナレッジベースの管理インターフェースに移動します。

（オプション） フィールドを追加した後、フィールド値ボックスにそのフィールドに対応するフィールド値を入力します。

値タイプが時間の場合、フィールド値を入力する際に時間選択ツールが表示され、具体的な時間を選択できます。

保存ボタンをクリックして、操作を保存します。

メタデータ情報の一括削除と修正

メタデータの編集 ポップアップでメタデータ情報を削除・修正します：

フィールド値の追加：メタデータ値を追加したいフィールドボックス内に直接必要な値を入力します。
フィールド値のリセット：カーソルをフィールド名の左側にある青い点の上に置くと、青い点は リセット ボタンに変わります。青い点をクリックすると、フィールドボックス内の修正された内容が元のメタデータ値にリセットされます。
フィールド値の削除：
- 1つのフィールド値を削除する：削除したいフィールド値のフィールドボックス内で直接そのフィールド値を削除します。
- 複数のフィールド値を削除する：複数の値 カードの削除アイコンをクリックして、選択したすべての文書のそのメタデータフィールドの値を消去します。
単一メタデータフィールドの削除：フィールドの最右側にある削除記号をクリックして、そのフィールドを削除します。削除後、そのフィールドは横線で消され、グレーアウトします。

この操作は選択した文書のそのフィールドとフィールド値のみを削除し、フィールド自体はナレッジベースに保持されます。

保存ボタンをクリックして、操作を保存します。

一括操作の適用範囲の調整

一括操作の適用範囲の調整： メタデータの編集 ポップアップの左下にある すべての文書に適用 チェックボックスを使用して、編集モードでの変更の適用範囲を調整できます。
- いいえ（デフォルト）：このオプションをチェックしない場合、編集モードでの変更は元々そのメタデータフィールドを持っていた文書にのみ適用され、他の文書には影響しません。
- はい：このオプションをチェックする場合、編集モードでの変更はすべての選択された文書に適用されます。元々そのフィールドを持っていなかった文書には、自動的にそのフィールドが追加されます。

単一文書のメタデータ情報の編集

文書詳細インターフェースで単一文書のメタデータ情報を編集できます。

文書メタデータ編集モードへのアクセス

文書詳細インターフェースで、情報バーの上部にある ラベリングを開始 ボタンをクリックします。

文書メタデータ編集モードに入ります。

メタデータの文書追加

文書のメタデータ編集モードで、+メタデータを追加ボタンをクリックすると、操作ポップアップが表示されます。

新しいフィールドを作成してその文書にフィールド値をマークしたい場合は、ポップアップの左下にある**+ メタデータを新規作成ボタンをクリックし、前述のメタデータフィールドの新規作成**セクションを参照してフィールドを作成できます。

文書ページで作成された新しいメタデータフィールドは、自動的にナレッジベースのフィールドリストに同期されます。
ナレッジベースに既存のフィールドを使用してその文書にフィールド値をマークしたい場合は、以下のいずれかの方法で既存のフィールドを使用できます：
- ドロップダウンリストからナレッジベースの既存のフィールドを選択し、その文書のフィールドリストに追加します。
- メタデータを検索検索ボックスで必要なフィールドを検索し、その文書のフィールドリストに追加します。
ナレッジベースの既存のフィールドを管理したい場合は、ポップアップの右下にある管理ボタンをクリックして、ナレッジベースの管理インターフェースに移動します。

（オプション） フィールドを追加した後、フィールド名の右側のメタデータ欄にフィールド値を入力します。

右上の保存ボタンをクリックして、フィールド値を保存します。

文書メタデータ情報の削除と編集

文書のメタデータ編集モードで、右上の編集ボタンをクリックして、編集モードに入ります。

文書メタデータ情報を削除・編集します：
- フィールド値の削除と編集：フィールド名の右側のフィールド値ボックス内で、フィールド値を削除または修正します。
このモードではフィールド値の修正のみをサポートし、フィールド名の修正はサポートしていません。
- フィールドの削除：フィールド値ボックスの右側にある削除ボタンをクリックして、フィールドを削除します。
この操作はその文書のそのフィールドとフィールド値のみを削除し、フィールド自体はナレッジベースに保持されます。

右上の保存ボタンをクリックして、修正後のフィールド情報を保存します。