DataWorks:ナレッジベースの作成

概要

Context Graph (ナレッジベース) は、DataWorks の統一ナレッジ管理モジュールです。Data Agent や AI Assistant などのインテリジェントアプリケーションに統一されたナレッジ基盤を提供します。ワークスペースのメタデータ、データソース、ビジネスドキュメントに散在する情報を、閲覧、検索、権限管理が可能なナレッジとして整理し、インテリジェントアプリケーションが Q&A、データ検索、分析の際に一貫したビジネスコンテキストを持つことを可能にします。

ナレッジベースは独立したインスタンスとして管理されます。単一のナレッジベースは、複数のインテリジェントアプリケーションで再利用でき、各アプリケーションで冗長な構築を行う必要はありません。

前提条件

ナレッジベースを使用する前に、以下の準備を完了してください：

1. DataWorks が有効化されており、ナレッジベースを作成したいテナントに入っていること。

2. ワークスペースのセマンティクスからナレッジを構築する場合、現在のアカウントが収集対象のワークスペースおよび関連するデータ資産に対する読み取り権限を持っていることを確認してください。

3. ナレッジビルドタスクを実行するためのサーバーレスリソースグループとそれに関連するプロジェクトが準備されていること。選択したリソースグループは、ビルドに必要なデータソースまたはクラウドサービスへのネットワーク接続とアクセス権限を持ち、タスクのコンピュート CU 要件 (デフォルトで 4 CU) を満たすのに十分な利用可能容量がある必要があります。

基本概念

ステップ 1：ナレッジベースの作成

ステップ 2：ソースの構成 (任意)

ステップ 3：ナレッジのビルド

対象のナレッジベースに入った後、詳細ページの右上隅にある [ナレッジのビルド] をクリックし、ビルド方法を選択します。システムは 3 つのビルド方法を提供します：

• ワークスペースセマンティックビルド：ワークスペースを選択して、ゼロからナレッジビルドタスクを作成します。

• データソースセマンティックビルド：データソースを選択し、テーブルを指定して、詳細な制御でナレッジをビルドします。

• ドキュメントナレッジビルド：DingTalk、Feishu、Lark、WeCom、Yuque からオンラインドキュメントを同期するか、ローカルファイルをアップロードして、ドキュメントベースのナレッジをビルドします。

3 つのビルド方法すべてで、[更新方法] で実行ポリシーを構成できます。[手動] を選択した場合、タスクは手動でトリガーされた場合にのみ実行されます。[定期的] を選択した場合、月次、週次、日次、または時間単位で実行サイクルと時間を設定でき、システムはタスクを自動的に実行します。

3 つのビルド方法すべてで、以下の実行環境パラメーターが必要です：

以下のセクションでは、3 つのビルド方法それぞれに固有のパラメーターについて説明します。

ステップ 4：ビルド管理

ナレッジビルドを開始した後、ビルド管理でビルドタスクを表示できます。ナレッジベース詳細ページで、[ビルド管理] タブをクリックして、タスク定義と実行インスタンスを管理します。タスクが実行されるたびに、実行インスタンスが生成されます。

• タスク定義

  各タスク定義には、タスク名、タスクタイプ、ビルド範囲、トリガー方法、実行用リソースグループ、タスクステータスが含まれます。タスク名で検索したり、タスクタイプ、トリガー方法、有効ステータスでフィルタリングしたり、タスク定義を更新したりできます。

  利用可能な操作：

  • 今すぐ実行：手動でビルドをトリガーします。

  • 編集：タスク名やトリガー方法などの構成を変更します。

  • 有効化 / 無効化：定期タスクの自動トリガーを制御します。

  • 削除：タスク定義を削除します。実行中のタスクは削除できません。

• 実行インスタンス

  実行インスタンスには、各実行のタスク名、タイプ、トリガー方法、実行ステータス、開始時刻、および操作が表示されます。実行ステータス、タスクタイプ、トリガー方法でフィルタリングできます。ナレッジベースのアップグレードタスクも実行インスタンスリストに表示され、タスクタイプはバージョンアップグレードと表示されます。利用可能な操作：

  重要

  インスタンスの実行時間は、ビルドするナレッジコンテンツのサイズによって異なります。プロセスには時間がかかる場合があります。しばらくお待ちください。

  • 表示：実行インスタンスの詳細を開きます。

  • ソースファイル：このビルドで使用された入力ファイルを表示します。

  • キャンセル：まだ終了可能なインスタンスをキャンセルします。

  • リトライ：再実行が許可されている失敗または終了したインスタンスの実行を再開します。

• 実行中のインスタンスの詳細

  実行中のインスタンスのステータスが「失敗」の場合、以下の手順を実行します：

  1. 問題の特定：実行中のインスタンスリストで、失敗したタスクの [表示] をクリックします。詳細ページで、実行グラフ内の赤色の失敗したステップを見つけます。

  2. ログの分析：失敗したステップのログを開き、以下の表を参照してエラーメッセージに基づいてトラブルシューティングを行います。

  3. 解決とリトライ：問題を修正した後、タスク定義ページに戻り、[今すぐ実行] をクリックします。

問題を修正した後、タスク定義で再度 [今すぐ実行] をクリックします。

ステップ 5：ナレッジベースの使用

ビルドタスクが成功すると、ナレッジベースが利用可能になります。以下の操作がサポートされています：

• Wiki の閲覧、知識グラフと推論パスの表示。

• 統一ナレッジ検索の使用。

• Data Agent と AI Assistant でのナレッジベースの使用。

詳細については、「ナレッジベースの使用」をご参照ください。

ビルド中に生成された意味理解モデルとビジネスドキュメントは、ナレッジオブジェクトで表示、レビュー、デプロイできます。詳細については、「ナレッジオブジェクトの管理」をご参照ください。

ステップ 6：設定と権限の構成

ナレッジベースを構成した後、日常的な管理のために複数の管理者を割り当てることができます。また、ナレッジベースをユーザー、AI Assistant インスタンス、または Data Agent インスタンスと共有して、エージェントコンテキストにナレッジ推論機能を提供することもできます。

コンテンツ言語

ナレッジベースのコンテンツは、簡体字中国語と英語をサポートしています。各ナレッジベースは 1 つのコンテンツ言語のみを維持します。

• 最初のビルド時に、システムは DataWorks コンソールの右上隅の言語設定に基づいてナレッジベースのコンテンツ言語を決定します。[要確認：最初のビルドで言語がロックされ、変更できないというルールが変更されていないかどうか]

• 言語が決定された後、後続のすべてのビルドは同じ言語を使用します。コンソール言語を切り替えても、コンソールインターフェイスが変更されるだけで、既存のナレッジの言語は変更されません。

• 既存のナレッジベースのコンテンツ言語を直接変更することはサポートされていません。異なる言語を使用するには、ナレッジベースを作成し、対象のページ言語で最初のビルドを開始します。

• 物理的なテーブル名、カラム名、SQL ステートメント、コード、ID、元のタグ、参照証拠は翻訳されません。したがって、英語のナレッジベースには、ソースデータからの中国語の文字が含まれる場合があります。

レガシーナレッジベースのアップグレード

Wiki と知識グラフを使用する前に、レガシーナレッジベースをアップグレードする必要があります。アップグレードは、ナレッジベースの所有者または管理者が開始できます。一般メンバーはナレッジベースを表示し、利用可能な機能を使用できますが、アップグレードは実行できません。

1. ナレッジベースリストを開き、[アップグレード可能] とマークされたレガシーナレッジベースを見つけて、そのマークをクリックします。

2. アップグレードの説明を読み、アップグレードに使用するリソースグループとリソースグループプロジェクトを選択します。

3. [アップグレードの確認] をクリックします。アップグレードタスクが作成された後、[ビルド管理] の [実行中のインスタンス] で進捗と結果を表示できます。タスクタイプはバージョンアップグレードと表示されます。

アップグレードは、現在のナレッジベースのすべてのベースラインデータに基づいて Wiki と知識グラフを生成し、少量のトークン消費が発生します。アップグレード中は他のナレッジビルドタスクを開始しないでください。ビルドタスクが現在実行中の場合は、それをキャンセルするか、終了するのを待ってからページを更新してアップグレードを開始してください。アップグレードは履歴ナレッジソースを削除しません。アップグレードに失敗しても、既存のナレッジベースデータや通常の使用には影響しません。既存の AI Assistant ユーザー向けのローカルナレッジベースについては、「ローカルナレッジベース (既存の AI Assistant ユーザー向け)」をご参照ください。

ローカルナレッジベース (既存の AI Assistant ユーザー向け)

ナレッジベースは、AI Assistant から独立したモジュールとして分離されました。既存の AI Assistant ユーザーの場合、以前に AI Assistant で作成されたナレッジベースは、インターフェイスにローカルナレッジベースとして表示され、引き続き使用可能です。ナレッジベースモジュールが AI Assistant に埋め込まれている場合、ローカルナレッジベースはナレッジベースリストの個人ナレッジベースセクションに表示されます。ローカルナレッジベースをクリックすると、AI Assistant のナレッジベース管理ページに移動できます。

• ローカルナレッジベースでサポートされる操作：再生成、エクスポート、クリアなど、既存のローカルナレッジベースの機能は引き続き利用可能です。

• ナレッジベースモジュールとの違い

  項目	ローカルナレッジベース (レガシー)	ナレッジベースモジュール
  エントリ	AI Assistant インスタンス詳細ページの [ナレッジベース] タブ	コンソールの左側ナビゲーションウィンドウの [ナレッジベース]
  作成がサポートされているか	新しく作成された AI Assistant サービスインスタンスでは、ローカルナレッジベースは生成されなくなりました。	サポート
  所有権	単一の AI Assistant サービスインスタンスに属する	複数のインテリジェントアプリケーションで再利用できる独立したインスタンス
  ナレッジベースのタイプ	タイプの区別なし	個人ナレッジベースとエンタープライズナレッジベースをサポート
  共有方法	現在のインスタンス内でのみ使用	[共有] を通じてユーザー、Data Agent、または AI Assistant サービスへのアクセス権付与をサポート

• 新しく作成された AI Assistant サービスインスタンスとの違い：新しく作成された AI Assistant サービスインスタンスでは、ローカルナレッジベースは生成されなくなりました。つまり、AI Assistant サービス内でナレッジベースを作成することはできなくなりました。ナレッジベースを作成するには、Context Graph (ナレッジベース) モジュールに移動して一元的に作成および管理し、必要に応じて AI Assistant サービスまたは Data Agent で使用します。既存のナレッジベースで Wiki と知識グラフを使用するには、「既存のナレッジベースのアップグレード」をご参照ください。

よくある質問

• Q：ソース管理またはナレッジビルドのボタンがクリックできないのはなぜですか？

  A：ご利用のアカウントには読み取り専用または共有使用権限しかない可能性があります。ナレッジベースの所有者または管理者に連絡して、権限を確認してください。

• Q：構成管理ですべてのセクションが表示されないのはなぜですか？

  A：システムは、管理権限を持つセクションのみを表示します。たとえば、基本情報を編集する権限があっても、必ずしも共有範囲を管理できるとは限りません。

• Q：ビルドページに利用可能なワークスペースやデータソースがないのはなぜですか？

  A：ソースがナレッジベースに追加されていません。まずソース管理で追加してから、ページに戻ってください。利用可能なオプションが更新されます。

• Q：DingTalk または Lark のソース検証が失敗した場合はどうすればよいですか？

  A：アプリケーションの認証情報、読み取り専用権限、ドキュメントのメンバー権限、ドキュメント範囲、およびリソースグループのネットワークアクセス構成を確認してください。これらの設定を確認した後、[再検証] をクリックしてください。

• Q：ナレッジベースがアップグレードできない場合はどうすればよいですか？

  A：[アップグレード可能] タグが表示されない場合、ナレッジベースはすでにアップグレードされているか、ご利用のアカウントが所有者または管理者ではないか、ナレッジベースのバージョン情報が一時的に利用できない可能性があります。リストを更新し、アカウントの権限を確認してください。タグが表示されていてもアップグレードを送信できない場合、通常は同じナレッジベースでビルドタスクが実行中です。タスクをキャンセルするか、終了するのを待ってから、ページを手動で更新して再試行してください。アップグレードに失敗しても、既存のナレッジベースデータや通常の使用には影響しません。

• Q：タスクの削除が失敗するのはなぜですか？

  A：タスクがまだ実行中であるか、削除処理中であるか、他のタスクに依存している可能性があります。アクティブなインスタンスを終了し、依存関係を削除してから、削除を再試行してください。

• Q：AI Assistant サービスでナレッジベースを作成できないのはなぜですか？

  A：ナレッジベースは、一元管理のために独立したモジュールに分離されました。新しく作成された AI Assistant サービスインスタンスでは、ローカルナレッジベースは生成されなくなりました。Context Graph (ナレッジベース) モジュールでナレッジベースを作成してください。作成後、AI Assistant サービスと Data Agent で使用できます。

• Q：既存のローカルナレッジベースはまだ使用できますか？

  A：はい。既存のユーザーが以前に AI Assistant サービスで作成したナレッジベースは、インターフェイスにローカルナレッジベースとして表示されます。元の使用に影響を与えることなく、再生成、エクスポート、クリアが可能です。

• Q：管理者と共有権限の違いは何ですか？

  A：管理者は、ナレッジベースの構成、アップロード、ビルドができます。[共有] を通じてアクセス権を付与されたユーザー、Data Agent インスタンス、または AI Assistant サービスインスタンスは、ナレッジを検索または Q&A に使用することしかできず、ナレッジベースを変更することはできません。

推奨事項

• 最初のビルドの前にソース範囲を計画し、無関係なワークスペースのスキャンを避けてください。

• ナレッジベースに明確な所有者を割り当て、バックアップ管理者を構成してください。

• 高いセマンティック品質が必要なナレッジベースでは、データプロファイリングを有効にし、SQL サンプリングとトークン消費を監視してください。

• ビルドが成功した後、実行中のインスタンス、知識グラフのカバレッジ、ナレッジ検索の結果を合わせて確認し、ユーザビリティを検証してください。

• 未公開バージョンの意味理解モデルは、現在デプロイされているバージョンを自動的に置き換えません。デプロイする前にレビューしてください。

• タスクを無効にすると後続のトリガーが一時停止され、タスクを削除するとタスク定義が削除されます。2 つの操作を混同しないでください。

• ソーステーブルとカラムのコメント、データ標準、所有者、リネージ、データ品質ルールを充実させて、自動ビルドの品質を向上させてください。コアメトリック、機密カラム、主要なクエリは手動でレビューしてください。

• 期限切れの資料やテストアセットを定期的にクリーンアップして、検索ノイズを減らしてください。

• 最小権限の原則に従い、ユーザーがナレッジベースにアクセスする必要がなくなった場合は、速やかにアクセス権を取り消してください。