セマンティックレイヤーのエンティティの説明のカスタマイズ

更新セットを介してインスタンス間でカスタマイズを転送できるように、セマンティックテーブル構成テーブルにカスタムエンティティの説明を作成します。

始める前に

必要なロール:sn_query_gen.admin 以上

このタスクについて

クエリ生成セマンティックレイヤーでは、自然言語の記述を使用して、各テーブルが何を表しているかを AI が理解できるようにします。デフォルトでは、説明はフィールドラベル [sys_documentation] テーブルから自動的に導出されますが、これらの説明を、テーブルのビジネス目的をより適切に説明するカスタムの説明で上書きできます。カスタムの説明をクリアすると、[フィールドラベル] の値に戻ります。

この手順では、セマンティックテーブル構成テーブルを使用します。この方法で行われたカスタマイズは、更新セットを介してインスタンス間で転送でき、エンティティテーブルで直接設定された説明を上書きできます。より単純な単一インスタンステストの場合は、代わりにエンティティ [sn_query_gen_entity] テーブルで [セマンティック説明] フィールドを直接編集できます。

注:

エンティティラベルとエンティティレベルの使用手順は、エンティティ [sn_query_gen_entity] テーブルでのみ設定できます。セマンティックテーブル構成テーブルは、エンティティの説明のみをサポートしています。

手順

1. 移動先 クエリ生成 > セマンティックテーブル構成.
2. テーブルのレコードを開くか、レコードが存在しない場合は作成します。

   新しいレコードを作成する場合は、[ テーブル名] をテーブル名に設定し、[ セマンティック生成の有効化] をオンにします。詳細については、「セマンティックデータレイヤーへのテーブルの追加」を参照してください。

3. [ エンティティセマンティック説明] フィールドに、カスタムの説明を入力します。

   最大 4,000 文字。テーブルが表す内容、使用者、ビジネス目的を説明する説明を分かりやすいビジネス言語で記述します。

4. [Update (更新)] を選択します。
   カスタムの説明は、セマンティックレイヤーのエンティティレコードに自動的に同期されます。

タスクの結果

カスタムエンティティの説明はアクティブで、このテーブルのクエリを処理するときに クエリ生成 によって使用されます。このカスタマイズはセマンティックテーブル構成テーブルに格納されるため、更新セットに含めたり、他のインスタンスに転送したりできます。詳細については、「System update sets」を参照してください。

エンティティの説明

次の例は、自動生成された説明とカスタムの説明の違いを示しています。

表 : 1. エンティティの説明の例

テーブル	自動生成 (不満)	カスタム (良好)
インシデント	インシデントテーブル	IT インシデント、機能停止、サービス中断、IT サポートチケット
alm_ai_digital_asset	AI デジタル資産のレコードを追跡します。	AI コントロールタワー (AICT) ガバナンスフレームワーク内のすべての AI 関連デジタル資産のベースインベントリテーブル。各レコードは、ガバナンス、コンプライアンス、ライフサイクル管理のために追跡される AI アーティファクト (モデル、プロンプト、データセット、スキル、エージェント、ツール) を表します。ガバナンスチーム、製品マネージャー、AI プラットフォームオーナーは、このテーブルを使用して、AI インベントリの一元的な監視、監査の準備状況、およびトレーサビリティを行います。

次のタスク

クエリ生成のテーブルについて質問し、正しいテーブルが選択されていることを確認して、カスタムの説明をテストします。