効果的なGenieスペースをキュレートする

プレビュー

Genieスペースをキュレートする目的は、ビジネスユーザーが自然言語で質問し、データに基づいて正確で一貫した回答を受け取ることができる環境を作成することです。 Genie Space は、洗練されたクエリを生成し、一般的な世界の知識を理解する高度なモデルを使用します。

ほとんどのビジネス上の質問はドメイン固有であるため、スペースキュレーターの役割は、その一般的な世界の知識と、特定のドメインまたは特定の企業で使用される専門言語との間のギャップを埋めることです。キュレーターはメタデータと指示を使用して、 genieビジネスユーザーの質問を正確に解釈して応答できるようにします。この記事では、成功するスペースを開発するためのベストプラクティスと原則について概説します。

新規スペース定義のベストプラクティス

次のセクションでは、効果的なスペースを作成するための推奨事項のプラクティスについて説明します。

小さく始める

Genieスペースのキュレーションは反復的なプロセスです。新しいスペースを作成するときは、できるだけ小さく始めて、最小限の指示と限られた質問に答える必要があります。その後、フィードバックやモニタリングに基づいて繰り返しながら追加できます。このアプローチにより、スペースの作成と保守が効率化され、実際のユーザーのニーズに応じてスペースを効果的にキュレーションできます。

小さなGenieスペースを作成するには、次のガイドラインに従ってください。

集中力を保つ: スペースで処理したい質問に答えるために必要なテーブルのみを含めます。テーブル数は5台以下を目標にしてください。選択が集中すればするほど、より良い結果が得られます。スペースを少量のデータに絞り込むことが理想的であるため、含まれるテーブルの列数を制限します。
イテレーションを計画する: スペースの最小限のセットアップから始め、重要なテーブルと基本的な手順に焦点を当てます。より詳細なガイダンスや例を追加して、時間をかけて空間を洗練させていきます。最初は完璧を目指すのではなく、その通りです。
適切に注釈が付けられたテーブルに基づいて構築します。genie genie Unity Catalog列名と説明を使用して応答を生成します。明確な列名と説明は、高品質の応答を生成するのに役立ちます。列の説明には正確なコンテキスト情報を提供する必要があります。あいまいな詳細や不必要な詳細は避けてください。 AI によって生成された説明の正確性と明確性を検査し、手動で提供する内容と一致する場合にのみ使用してください。

ドメイン専門家にスペースを定義してもらいましょう

効果的なスペースクリエーターは、データとそこから得られる知見を理解する必要があります。 SQLに堪能なデータアナリストは通常、スペースを管理する知識とスキルを持っています。

スペースの目的を定義しましょう

スペースの特定のオーディエンスと目的を特定することで、使用するデータ、手順、テスト問題を決定するのに役立ちます。スペースは、さまざまなドメインにわたる一般的な質問ではなく、特定のトピックや対象ユーザー向けの質問に答える必要があります。

テストと調整を行いましょう

あなたはスペースの最初のユーザーである必要があります。新しいスペースを作成したら、質問を始めましょう。質問に応じて生成された SQL を注意深く調べます。 genieデータ、質問、またはビジネス用語を誤って解釈した場合は、生成されたSQLを編集するか、その他の具体的な指示を提供することで介入できます。信頼できる応答が得られるまで、テストと編集を続けます。

質問を確認したら、その質問をベンチマーク質問として追加し、スペースの全体的な精度を体系的にテストして採点するために使用できます。バリエーションとさまざまな質問の言い回しを使用して、 genieの応答をテストできます。「Genieスペースでのベンチマークの使用」を参照してください。

誤った応答の修正に関するアイデアについては、トラブルシューティングを参照してください。

ユーザーテストを実施しましょう

テストを通じて応答品質を確認した後、ビジネスユーザーを募集してGenie Space を試してもらいます。次のガイドラインを使用して、スムーズなユーザー体験を提供し、継続的な改善のためのフィードバックを収集します。

彼らの仕事は部屋を洗練するのを助けることであるという期待を植え付けます。
そのスペースが答えを出そうとしている特定のトピックや質問にテストを集中させるように依頼します。
間違った回答を受け取った場合は、チャットに追加の指示と説明を追加して回答を絞り込むようにユーザーに促します。正しい応答が提供された場合は、将来のインタラクションで同様のエラーを最小限に抑えるために、最終的なクエリに賛成票を投じる必要があります。
組み込みのフィードバックメカニズムを使用して、応答に賛成票を投じるか、反対票を投じるようにユーザーに伝えます。
ユーザーに招待して、追加のフィードバックや未解決の質問をスペースの作成者と直接共有してもらいます。作成者と編集者は、フィードバックを使用して、指示、例、信頼できるアセットを改良できます。

トレーニング資料や、部屋のテストとフィードバックの提供に関するガイドラインが記載された文書を提供することを検討してください。ビジネスユーザーがスペースをテストすると、ユーザーが尋ねた質問が [履歴 ] タブに表示されます。質問とデータを正しく解釈して正確な回答を提供するのに役立つ指示を引き続き追加 genie 。スペースを監視する方法の詳細については、「履歴とフィードバックの確認」を参照してください。Genie

注：

ビジネスユーザーがスペースにアクセスするには、元のワークスペースのメンバーである必要があります。スペースを操作するための適切な権限を付与する方法については、「必要な権限」を参照してください。

トラブルシューティング

次のセクションでは、一般的な問題を解決する方法について説明します。

誤解されるビジネス用語

ほとんどの企業やドメインには、ビジネス固有のイベントについて伝えるために使用する特定の略語があります。たとえば、年を指す場合、常に会計年度を意味し、この会計年度は 1 月ではなく 2 月または 3 月に始まる場合があります。 genieこれらの質問に自然かつ正確に答えられるようにするには、ビジネス用語をgenieが理解できる単語や概念に明示的にマッピングする指示を含めます。「指示を提供する」を参照してください。

誤ったテーブルや列の使用法

genieが間違ったテーブルからデータを取得しようとしたり、間違った列で分析を実行しようとしたりする場合は、次のいずれかの方法でデータを調整できます。

明確で正確な説明を提供する: テーブルと関連するメタデータをチェックして、そこで使用されている用語が、送信された質問のユーザーの用語と一致していることを確認します。そうでない場合は、説明を絞り込むか、表で使用されている用語を質問で使用されている用語にマッピングする指示を追加します。
SQLサンプルクエリの追加 :genie 特定の質問に応答する方法を学習するためにが使用できるサンプルクエリを提供します。「指示を提供する」を参照してください。
スペースからテーブルまたは列を削除します。一部のテーブルには重複する列または概念が含まれている場合があり、その結果、 genie応答にどのデータを使用するかを判断することが困難になります。可能であれば、不要なテーブルや列、または重複するテーブルや列を削除します。必要な列のみを含むビューを作成することもできます。

エラーのフィルタリング

生成されたクエリには、多くの場合、特定の値に従って結果をフィルタリングするための WHERE 句が含まれています。 genie実際のデータを表示できないため、間違った値をフィルターするように WHERE 句を設定する可能性があります。たとえば、テーブルで "CA" などの省略形が使用されている場合、"California" という名前を一致させようとする場合があります。

このような状況では、次のいずれかの方法を試してください。

列値のセットが適度に小さい場合は、各列の説明に対して有効な文字列を列挙します。特にスペースや数字が含まれている場合は、文字列値を引用符で囲みます。場合によっては、一般的な列挙型では、すべての州の値をリストする代わりに、「3 文字の国の ISO コードを使用してください」と言うだけで十分です。

正しくない結合

Unity Catalogで外部キー参照が定義されていない場合、スペースでは異なるテーブルをどのように結合すればよいかがわからない可能性があります。

次のソリューションを 1 つ以上実装してみてください。

可能な場合は、 Unity Catalogで外部キー参照を定義します。 CONSTRAINT 句を参照してください。
標準的な方法でテーブルを結合するクエリの例を提供します。
テーブルの外部キー関係がUnity Catalogで指定されていない場合は、手順にそれを文書化します。

これらのいずれでも問題が解決しない場合は、テーブルをビューに事前に結合し、代わりにそれをスペースの入力として使用します。この戦略は、自己結合などのより複雑な結合シナリオに役立ちます。

メトリクス計算の問題

メトリクスをコンピュートしてロールアップする方法は、任意に複雑になる可能性があり、スペースでは理解できない多くのビジネス詳細が含まれる場合があります。これにより、誤ったレポートが発生する可能性があります。

次のソリューションを 1 つ以上実装してみてください。

メトリクスがベーステーブルから集計されている場合は、各ロールアップ値を計算するSQLクエリの例を提供します。
メトリクスがコンピュート前に作成されており、集計テーブルに配置されている場合は、テーブルのコメントでこれを説明してください。そのテーブル内のメトリクスをさらにロールアップできる場合は、各メトリクスに有効な集計を指定します。
生成しようとしているSQL非常に複雑な場合は、スペースのメトリックをすでに集計したビューを作成してみてください。

指示を無視する

コメントでテーブルと列を説明し、一般的な指示を提供した場合でも、スペースでそれらが正しく使用されていない可能性があります。

次の方法の 1 つ以上を試してください。

テーブルを正しく使用するクエリの例を提供します。クエリの例は、データの使用方法をスペースに教えるのに特に効果的です。
テーブルからビューを作成し、データをより簡単に表示します。
指示を確認し、無関係なテーブルや指示を削除してスペースを集中させてみてください。
新しいチャットを開始してみてください。以前のやり取りは、特定のチャットでのgenieの応答に影響を与える可能性がありますが、新しいチャットを開始すると、新しい指示をテストするための空白の開始点が得られます。

パフォーマンスの問題

genie非常に長いクエリやテキスト応答を生成する必要がある場合、応答に長い時間がかかったり、思考フェーズでタイムアウトになったりすることがあります。

パフォーマンスを向上させるために、次のアクションを 1 つ以上試してください。

信頼できるアセットまたはビューを使用して、複雑なクエリをカプセル化します。 AI/BI Genieスペースで信頼できる資産を使用する」を参照してください。
可能な限り、サンプル SQL クエリの長さを短くしてください。
genie遅い応答や失敗する応答を生成し始めた場合は、新しいチャットを開始してください。

ミッションクリティカルな質問に対する信頼性の低い回答

信頼できるアセットを使用して、ユーザーが尋ねると予想される特定の質問に対して検証済みの回答を提供します。 AI/BI Genieスペースで信頼できる資産を使用する」を参照してください。

トークン制限の警告

トークンは、 genieが言語を処理および理解するために使用するテキストの基本単位です。 Genieスペースに命令またはメタデータとして含まれるテキストは、トークンに変換されます。スペース内のトークンの数が制限に近づいている場合、製品は警告で通知します。 genie は、スマートコンテキストフィルタリングを適用して、メタデータを表すトークンと、 Genieスペースに含まれる一部の種類の命令を選択します。制限を超えた場合でも、スペースは質問に対する回答を生成し続ける必要があります。

Genieスペースがトークンの制限に近づいた場合、genieは、質問に最も関連性の高いテーブルスキーマと指示の部分のみを優先に含めることができます。これにより、重要なコンテキストが除外された場合、応答の品質が低下する可能性があります。トークン数を減らすために、次のプラクティスを検討してください。

不要な列を削除する: テーブル内の不要な列は、トークンの使用に大きく影響する可能性があります。ビューを作成して、生のテーブルから冗長なフィールドや重要でないフィールドを除外します。
列の説明を合理化します。列の説明は重要ですが、列名によってすでに伝えられている情報を重複させないようにしてください。たとえば、列の名前がaccount_nameの場合、「アカウントの名前」のような説明は冗長になる可能性があるため省略できます。
指示を簡略化する: 指示が明確で簡潔であることを確認してください。不必要な言葉は避けてください。
サンプル SQL ステートメントの整理: さまざまなタイプの質問に対応するために、さまざまなサンプル SQL ステートメントを含めますが、重複する例や冗長な例は削除します。

アカウントが Geo 間処理に対応していない

Genieは、Databricksが管理する指定サービスです。指定サービスでは、Databricks Geos を使用してデータ所在地を管理します。一部の地域では、ワークスペースと同じ Geo でデータを処理できません。ワークスペースがこれらのリージョンのいずれかにある場合は、アカウント管理者がクロスジオ処理を有効にする必要があります。