|sf-intelligence|のアーティファクト

|sf-intelligence|は、応答の一部としてリッチでインタラクティブなチャートとテーブルを提供します。保持する価値のあるインサイトを見つけたら、アーティファクトとして保存または共有することができます。アーティファクトは、そのインサイトを永続的に表現したものであり、再生成することなく、再検討、更新、コラボレーションができます。アーティファクトは作成後、クエリ、視覚化、コンテキストを保持するため、後から最新のデータを確認したり、各ユーザーのデータ権限に応じて表示内容が反映された同じアーティファクトをチームメンバーと共有したりできます。

インタラクティブなテーブルとチャート

|sf-intelligence|に質問すると、エージェントはチャート、テーブル、またはその両方を含む応答を生成することがあります。チャートとテーブルはインタラクティブであるため、新しい質問をしなくても、並べ替え、フィルター、検索、サイズ変更を直接行えます。エクスプローラーモードでは、チャートとテーブルが同期されており、一方の操作がもう一方にも反映されます。

注釈

クエリはデフォルトでローリング時間ウィンドウに設定されます(例えば、「過去30日間」は常に直近の30日間を意味します)。固定の期間が必要な場合は、「11月15日から11月22日までのデータを表示」などのように、明示的な日付を指定してください。

アーティファクトの保存

チャートまたはテーブルに保持したいインサイトが含まれている場合は、:ui:`Save`を選択してアーティファクトを作成します。アーティファクトは、基になるクエリ、可視化設定、データスナップショットを保持するため、後から表示する際に即座に読み込まれます。

アーティファクトの管理

アーティファクトハブは、アーティファクトを管理するための中心的な場所です。以下のタブが含まれます。

  • Saved:保存したすべてのアーティファクト。

  • Shared with me:リンクを通じて共有されたアーティファクト。

ハブは、高速に読み込めるようにキャッシュされたスナップショットをタイルプレビューとして表示します。タイルを選択すると、アーティファクトを展開して追加のコンテキストを参照し、フォローアップの会話を開始できます。アーティファクトハブ内で、保存済みのアーティファクトを名前で検索することもできます。

アーティファクトは、前回の表示から12時間以上経過している場合、表示時に自動更新されます。手動でいつでも更新することもできます。更新を実行すると、現在の認証情報で元のSQLクエリが再実行され、データとスナップショットの両方が更新されます。

保存されたアーティファクトについて、フォローアップの質問を行うこともできます。各フォローアップは、アーティファクトの可視化仕様、データスナップショット、元の会話コンテキストの要約を含む新しい会話スレッドを開始します。元の会話はプライベートのまま変更されません。

アーティファクトの共有

アーティファクトは、リンクをコピーして任意のコミュニケーションチャネルで送信することで共有できます。リンクを共有すると、コピーではなく、単一のアーティファクトオブジェクトへのポインターが作成されます。リンクを持つアカウントユーザーは、基となるデータにアクセスできる限り、共有されたアーティファクトを開くことができます。

受信者がリンクを開くと、次の動作が行われます。

  • アーティファクトは、受信者の認証情報を使用してSQLクエリを実行し、ロールベースのアクセス制御(RBAC)、行レベルのセキュリティ、列のマスキングを適用します。

  • アーティファクトは、受信者のアーティファクトハブの:ui:`Shared with me`タブに表示されます。

  • 受信者はアーティファクトを探索し、フォローアップの質問を行い、後から再度アクセスすることができます。

注釈

受信者は、アクセス可能なアーティファクトを再共有できます。また、共有されたアーティファクトを自分の:ui:`Saved`タブに保存することもできます。

共有されたアーティファクトに関するフォローアップの会話

受信者は、アーティファクトを作成したエージェントにアクセスできる場合、そのエージェントを使用してフォローアップの質問を行うことができます。エージェントへのアクセス権がない場合、|sf-intelligence|はフォローアップの質問が利用できない可能性や、別のエージェントでは生成される結果の品質が低下する可能性があるという警告を表示します。

フォローアップの会話は、質問した本人にのみ表示されます。情報が元の共有者に戻ることはありません。

アクセス権の取り消し

アーティファクトの共有はいつでも解除できます。共有を解除すると、リンクはすぐに無効になり、その後は誰もリンクを開けなくなります。

重要

管理者は、UIまたはSQLを使用してアーティファクトの共有を無効にすることはできません。アカウントの共有を無効にするには、セールスエンジニア、アカウントエグゼクティブ、または`Snowflakeサポート<https://community.snowflake.com/s/article/How-To-Submit-a-Support-Case-in-Snowflake-Lodge>`__にお問い合わせください。

セキュリティとアクセス制御

アーティファクトは呼び出し元権限モデルに従います。すべてのデータ操作は、実行時に現在のユーザーの権限に基づいて検証されます。

次のセキュリティ動作が適用されます。

  • 保存されたアーティファクトはユーザースコープ: 保存されたアーティファクトは各ユーザーに対してプライベートです。他のユーザーは明示的に共有された場合にのみ、閲覧できます。

  • RBACが適用: 更新や共有のたびに、クエリは閲覧者の現在のロールと認証情報に基づいて実行されます。ロールが異なる2人のユーザーには、同じアーティファクトでも異なる結果が表示される場合があります。

  • 所有権は永続的: アーティファクトは、特定のロールやエージェントではなく、ユーザーに関連付けられます。元のエージェントへのアクセスを失っても、基になるデータにアクセスできる限り、アーティファクトは保持され、更新も行えます。

アーティファクトのライフサイクル

保存されたアーティファクトは、明示的に削除するまで保持されます。|sf-intelligence|が保存されたアーティファクトを自動的に削除することはありません。

アクセス条件が変更された場合の動作を次のテーブルに示します。

条件

動作

エージェントへのアクセス権を失った場合

アーティファクトは引き続き表示および更新できます。元のエージェントでのフォローアップの質問は利用できません。

データへのアクセス権を失った場合

最後にキャッシュされたスナップショットは引き続き表示されますが、更新は行えません。

エージェントが削除または変更された場合

アーティファクトとその保存されたクエリに影響はありません。フォローアップの質問は、現在のエージェント定義を使用して行われます(利用可能な場合)。

エージェントが使用できなくなった場合、|sf-intelligence|は警告を表示します。

既知の制限

  • 単一アーティファクトのみ: 現在、アーティファクトごとに個別のタイルのみを保存および共有できます。複数タイルのコレクションはサポートされていません。

  • ユーザーレベルの共有権限なし: 現在、共有はリンクベースで、アカウント内で公開されます。共有リンクを特定のユーザーに制限することはできません。

  • フォルダーやラベルなし: 現在、アーティファクトをグループ化したり、フォルダーに整理したり、分類用のラベルを付けたりすることはできません。