ナレッジオブジェクトの管理 - DataWorks - Alibaba Cloud ドキュメントセンター

ナレッジオブジェクトの効果的な管理は、高品質な DataWorks ナレッジベースを維持するための鍵となります。ナレッジコンテンツを格納するこれらのオブジェクトは、AI が正確なクエリを生成するために構造化データ定義を提供するセマンティックモデルと、自然言語による Q&A のために豊富なビジネスコンテキストを提供するビジネスドキュメントの、主に 2 つのカテゴリに分かれます。このトピックでは、これらのオブジェクトの作成、メンテナンス、レビュー、公開、および一般的な問題に対するトラブルシューティング戦略など、完全なライフサイクルについて説明します。その目的は、ナレッジベースの正確性と適時性を確保し、データ分析とビジネスクエリにおける価値を最大化することです。

概要

ナレッジオブジェクトは、DataWorks ナレッジベース内でナレッジを分類・管理するための中核となる仕組みです。この仕組みの主な特徴は、単一タイプのナレッジオブジェクトを独立してビルドできることで、これにより異なるナレッジソースからの柔軟かつ効率的な更新が可能になります。

セマンティックモデル：エンティティ、メジャー、ディメンション、リレーションシップなどのセマンティック定義を含むオブジェクトです。データ検索や分析のシナリオにおいて、AI がデータテーブルの意味やフィールド (一般的なメトリックや業界用語を含む) の使い方を理解し、正確なクエリ文を生成するのを支援します。ビルドによって生成されたモデルは、ここでレビュー、編集、公開されます。定義ファイルを手動でアップロードしたり、Quick BI からインポートしたりすることもできます。
ビジネスドキュメント：ナレッジベースにアップロードされたビジネスリソースファイルです。ここでドキュメントのアップロード、閲覧、プレビュー、削除を行うことができます。アップロード後、ビルドを開始してナレッジを生成します。

ナレッジビルディングによって生成されたセマンティックモデルは、未公開バージョンとしてナレッジオブジェクトに登録され、レビューと公開を経て初めて現在のバージョンに置き換わります。ビジネスドキュメントは、ビルドされ、正常に公開されて初めて検索可能になります。ビルドタスクの開始と監視方法の詳細については、「ナレッジベースの作成」をご参照ください。

前提条件

ナレッジベースを作成し、その詳細ページが表示されている必要があります。詳細については、ナレッジベースの作成をご参照ください。
セマンティックモデルの編集、公開、アーカイブやドキュメントの削除などのメンテナンス操作には、対応するメンテナンス権限が必要です。権限システムの詳細については、権限システムをご参照ください。

セマンティックモデル

セマンティックモデルは、メタデータ、リレーションシップ、ビジネスルールの集合体であり、その中核となる目的は、データに明確で曖昧さのないビジネス上の意味を割り当てることです。通常、以下の主要な要素が含まれます。

エンティティ：「顧客」、「製品」、「注文」などの中核となるビジネスオブジェクトを表します。
メジャー：定量化可能な値を表し、通常はビジネスにおいて関心の対象となる中核的なメトリックです。例えば、「売上金額」、「利益」、「アクティブユーザー」などがあります。これらのメジャーには、通常、計算ロジックの定義が含まれます。
ディメンション：メジャーを分析するためのコンテキストと視点を提供します。例えば、「時間」、「地理的地域」、「製品カテゴリ」などがあります。ディメンションには、多くの場合、階層構造があります (例: 年 -> 四半期 -> 月)。
リレーションシップ：異なるエンティティがどのように関連付けられているかを定義します。例えば、「顧客」は複数の「注文」を持つことができます。これにより、システムは異なるデータテーブルを正しく結合する方法を理解します。

セマンティックモデルの作成

作成方法は 3 つあります。

AI による生成：ビジネス目標、データ範囲、リネージに基づいてセマンティック生成タスクを作成し、レビュー用の未公開セマンティックモデルバージョンを生成します。この機能には、[ナレッジオブジェクト] タブの [セマンティックモデルの作成] をクリックするか、[ナレッジビルディング] で [データソースによるビルド] を選択することでアクセスできます。ビジネス目標とタスク情報を指定し、設定済みのデータ範囲、および必要なシードテーブルとメトリック定義を選択し、ランタイム環境を選択して、生成タスクを送信します。セマンティック生成タスクまたはビルド管理で結果を追跡し、生成された未公開バージョンをレビューして、確認後に公開します。
手動作成：1 つ以上の YAML 定義ファイルをアップロードして、セマンティックモデルを作成します。形式が無効なファイルの場合は、エラーメッセージが表示されます。問題を修正して再アップロードしてください。
外部インポート：Quick BI からデータセットを選択し、Quick BI データを DataWorks データソースにマッピングして、セマンティックモデルをバッチ生成します。マッピングできないデータソースについては、まずマッピングまたはソース設定を追加する必要があります。

作成方法が使用できない場合は、まず現在のナレッジベースがその方法をサポートしているかどうかを確認し、次に権限を確認してください。

セマンティックモデルの詳細とメンテナンス

セマンティックモデルの詳細ページには、3 つのタブがあります。

詳細：モデルの概要、構造、統計を表示します。
グラフ：モデル内のオブジェクトリレーションシップを表示します。
定義：現在のバージョンの読み取り専用 YAML 定義を表示します。複数のファイルが存在する場合は、それらを切り替えることができます。

メンテナンス権限を持つユーザーは、以下の操作を実行できます。

編集：フォームまたは YAML を使用してモデルを変更します。無効な YAML は、まず YAML ビューで修正する必要があります。編集するたびに、新しいバージョンが生成されます。ナレッジビルドが成功した後、コンテンツが正確であるかレビューし、その後にバージョンを公開します。編集したコンテンツは、公開されて初めて有効になります。
公開：現在の未公開バージョンを利用可能なバージョンとして設定します。未公開バージョンは、現在公開されているバージョンを自動的に置き換えることはありません。公開する前にレビューしてください。
バージョン履歴：過去のバージョンを表示し、2 つのバージョン間の差分を比較して、YAML 差分をダウンロードします。
アーカイブ：アーカイブ後、モデルはアクティブな管理リストに表示されなくなり、編集または公開できなくなります。

上記の操作を実行するには、モデルが操作可能な状態であり、かつ現在のユーザーが対応する権限を持っている必要があります。操作が使用できない場合は、まずモデルのステータスを確認し、次に権限を確認してください。

セマンティック生成タスク

セマンティック生成タスクは、ビルド管理で一元的に管理できます。タスクの実行、実行履歴と生成結果の表示、メンテナンス権限を持つタスクの変更、タスクの削除を行うことができます。セマンティック生成タスクを削除した後、そのタスクを再度実行することはできませんが、すでに生成されたセマンティックモデルは削除されません。

ビジネスドキュメント

ドキュメントの閲覧と管理

ビジネスドキュメントは、ユーザーがアップロードしたビジネスリソースを含むフォルダで整理されています。ドキュメントの検索、フォルダの展開、ファイルの選択、プレビューを行うことができます。必要な権限を持つユーザーは、ドキュメントを削除できます。削除後、リストを更新して結果を確認してください。

アップロードとビルド

サポートされているファイル形式とアップロード制限については、「ナレッジベースの作成」の「手動アップロード」セクションをご参照ください。

詳細ページの上部にある [ナレッジビルド] をクリックし、[手動アップロード] を選択します。ビジネスドキュメントがまだ何もない状態からアップロードを開始することもできます。
ファイルまたはフォルダをドラッグアンドドロップするか、[ファイルのアップロード] または [フォルダのアップロード] をクリックします。
ファイルリストを確認し、サポート対象外、制限超過、またはシステムファイルと判定されたファイルを処理します。
[ランタイムワークスペース]、[ランタイムリソースグループ]、[LLM] を選択します。
[ナレッジビルド] をクリックします。送信が成功すると、ページは自動的に [ビルド管理] にリダイレクトされ、実行中のインスタンスでこのビルドタスクの実行ステータスを追跡できます。

アップロードが完了しても、ファイルが検索可能になるわけではありません。ファイルは、ビルドと公開が正常に完了して初めて有効になります。ファイルを置き換えたり削除したりした後は、変更を有効にするためにナレッジベースを再ビルドする必要があります。

ドキュメント解析品質の向上

明確な見出しとセクションを使用し、スキャンした PDF と画像が判読可能であることを確認してください。
Excel ファイルの最初の行には、明確で一意の列名を使用してください。コンテンツの量が多い場合は、トピックごとにファイルを分割してください。
アップロードする前に、パスワード、キー、個人情報、および未承認の情報を削除してください。

よくある質問

Q：セマンティックモデルを編集または公開できないのはなぜですか?

A：現在のバージョンがアーカイブされている、影響チェックが進行中である、メンテナンス権限がない、バージョンに編集可能な定義ファイルがない、などが主な理由です。
Q：アップロードしたファイルがビルドされなかったのはなぜですか?

A：ファイル拡張子、ファイルサイズ、アップロードごとのファイル数を確認してください。システムファイル、サポート対象外の形式、制限を超過したファイルは、無視されるか、対応が必要なものとしてマークされます。サポートされているファイル形式とアップロード制限については、「ナレッジベースの作成」をご参照ください。
Q：アップロードが成功した後、ファイルが見つからないのはなぜですか?

A：アップロードとビルドは、それぞれ別のステップです。ビルドを開始し、タスクが正常に公開されたことを確認してください。
Q：ファイルを削除した後も関連コンテンツが見つかるのはなぜですか?

A：ファイルを削除した後、関連するナレッジを現在の検索バージョンから削除するには、再度ビルドを完了させる必要があります。