SnowsightのCortexコード¶
概要¶
Cortexコードは、 Snowsight 内のいくつかの機能エリアでエージェント体験を提供します。これは、 Snowsight インターフェースに深く統合され、差分ビューなどの機能を提供することで、 SQL 開発、データ探索、アカウント管理などのタスクを実行するデータアナリスト、エンジニア、管理者を支援するように設計されています。
Cortexコードは、インテリジェントなオーケストレーションを使用して、リクエストに基づいてマルチステップのタスクを計画し実行します。さらに、Snowflake環境から内部ツールと関連するコンテキストを選択してタスクを完了し、各応答が正確であることを確認します。
アシスタントはエージェントワークフローに従い、あなたの意図を解釈し、アクションの計画を作成し、セッション全体でコンテキストを維持しながらステップを実行します。
Cortexコードは、ロール、権限、スキーマ、 SQL 構文を理解し、コードの生成または変更時にSnowflakeのベストプラクティスを適用します。
Snowsight でCortexコードを使用するには、次のステップに従います。
右下隅のCortexコードアイコン
を選択します。Cortexコードパネルが Snowsight の右側に表示されます。メッセージボックスに質問を入力し、送信アイコンを選択するか、Enter を押して送信します。Cortexコードは、パネルに応答を提供します。
Cortexコードからの応答に SQL ステートメントが含まれる場合、ステートメントを実行するか、クリップボードにコピーできます。
アクセス制御の要件¶
Cortexコードへのアクセスに使用される ロール には、以下の データベースロールが付与されている必要があります。
データベースロール |
メモ |
|---|---|
SNOWFLAKE.COPILOT_USER |
すべてのユーザーがCortexコードにアクセスするために必要です。 |
SNOWFLAKE.CORTEX_USER または SNOWFLAKE.CORTEX_AGENT_USER |
これらのデータベースロールの少なくとも1つが必要です。 SNOWFLAKE.CORTEX_AGENT_USER はエージェントワークフローに追加機能を提供します。 |
データベースロールの付与の手順については、 GRANT DATABASE ROLE をご参照ください。
ロールとアクセス制御の一般情報については、 アクセス制御の概要 をご参照ください。
注釈
アカウントが以前にSnowflake Copilot(レガシー)をオプトアウト(または無効化)した場合、Cortexコードも無効になります。アカウントでこの機能を有効にするには、アカウントチームにお問い合わせください。
ユースケースおよび利点¶
Snowsight のCortexコードはインテリジェントエージェントとして動作し、自然言語の指示を実行可能なアクションに翻訳することで、より効率的に作業を支援します。ワークスペースのコンテキストとSnowflakeアカウントの構成を認識することで、 Snowsight から移動することなく、開発、探索、および管理タスクを支援します。
Cortexコードは、 Snowsight 内で以下の主要な機能エリアをサポートしています。
ワークスペースのエージェントコーディング¶
Cortexコードは、ワークスペース内に統合された会話型コーディングアシスタントとして動作します。インタラクティブなコード生成、変更、レビュー、説明をサポートしています。
コード生成と開発: SQL クエリを生成、新しいファイルを作成、データパイプラインと分析ワークフローのロジックを構築します。
コードの修正と最適化: ワークスペースで直接 SQL を調整し、ロジックまたは構文エラーを特定し、パフォーマンス、読みやすさ、またはコストの最適化を提案します。
レビューの変更: 適用する前に、差分ビューを使用して AI が提案した変更をプレビューします。差分ビューでは、挿入と削除が強調表示され、ユーザーはコードを制御できます。
コードの説明: 既存の SQL の説明をリクエストして理解またはコラボレーションを支援します。
フォローアップの質問をする: 明確な質問をするか、生成されたコードや結果についてのさらなる分析をリクエストすることで、会話を続けます。
強調表示された SQL からのクイックアクション: SQL ファイル内で、テキストを強調表示して、 Quick Edit、 Format、 Add to Chat および Explain などのクイックアクションを開きます
** SQL エラーを修正:** SQL ステートメントが失敗した場合は、結果グリッドの Fix ボタンをクリックすると、エラーの修正が提案されます。
インテリジェントな製品とドキュメントの検出¶
Cortexコードは、HorizonカタログとSnowflakeドキュメントのコンテキストを使用して、ワークスペースを離れることなくデータアセットと参照情報を見つけることができます。
自然言語スキーマ検索: 正確なオブジェクト名を知ることなく、平易な言語クエリを使用してテーブルや列などのデータベースオブジェクトを検索します。
統合されたQ&A: Snowflakeの機能、 SQL 構文、または公式ドキュメントに基づくベストプラクティスに関する回答を取得します。
Snowflake Marketplace検出: プロンプトがSnowflake Marketplaceを参照している場合、CortexコードはSnowflake Marketplaceからのリストを検索して返します。
利用可能な場合、応答には、タグ、マスキングポリシー、系統などの関連コンテキストが含まれ、発見されたデータアセットを検証するのに役立ちます。
アカウント管理の簡素化¶
Cortexコードは、ガバナンス、セキュリティ、コスト管理に関するコンテキスト情報を提供することで、アカウント管理をサポートします。
ガバナンスとセキュリティ: ユーザーとロールのアクセス、データ所有権、および個人を特定できる情報(PII)が含まれたテーブルを取得します。
コスト管理: アカウント使用状況とクレジット消費をクエリし、コストの高いウェアハウスやクエリを特定します。
サポートされているモデルとリージョン¶
Cortexコードは以下のモデルをサポートしています。これらのモデルは、アカウントにアクセスがある限り使用できます。詳細については、 モデルアクセスの制御 をご参照ください。
推奨:Claude Opus 4.5(
claude-opus-4-5)Claude Sonnet 4.5(
claude-sonnet-4-5)Claude Sonnet 4.0(
claude-4-sonnet)
リストされたモデルは すべての地域 で利用できない場合がありますが、Cortexクロスリージョン推論を使用すれば、任意のクラウドやリージョンでもCortexコードを使用できます。これには、モデルが利用できないクラウドやリージョンが含まれます。詳細については、 クロスリージョン推論 をご参照ください。
重要
選択したモデルがリージョンで利用できない場合、クロスリージョン推論が必要になります。 モデル可用性エラーで推論が失敗した場合は、クロスリージョン推論を構成します。
AWSUS :Claude Sonnet 4+は最高の品質を提供します。
AWS_US用のCortexクロスリージョン推論を設定してClaude Sonnet 4.xモデルにアクセスします。AWSEU :
AWS_EU用Cortexクロスリージョン推論を設定してClaudeモデルにアクセスします。AWSAPJ :
AWS_APJ用Cortexクロスリージョン推論を設定してClaudeモデルにアクセスします。任意のリージョン:
ANY_REGION用Cortexクロスリージョン推論を設定してすべてのモデルにアクセスします。
クロスリージョン推論を有効にするには、 ACCOUNTADMIN は次を実行する必要があります:
ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'AWS_US';
AWS_US を適切な地域識別子(AWS_US、 AWS_EU、 AWS_APJ、 ANY_REGION)に置換します。
注釈
モデルへのアクセスは、組織によって制限されることもあります。クロスリージョン推論を有効にしてもモデルにアクセスできない場合は、アカウントの AI モデルアクセス設定でモデルが有効になっていることを確認してください。詳細については モデルアクセスの制御 をご参照ください。
Cortexコードでは、ユーザーは SNOWFLAKE.COPILOT_USER データベースロールおよび SNOWFLAKE.CORTEX_USER または SNOWFLAKE.CORTEX_AGENT_USER データベースロールのいずれかを持っている必要があります。
注釈
アカウントが以前にSnowflake Copilot(レガシー)をオプトアウト(または無効化)した場合、Cortexコードも無効になります。アカウントでこの機能を有効にするには、アカウントチームにお問い合わせください。
ウェブ検索¶
ACCOUNTADMIN ロールでCortexコード CLI を構成してウェブを検索し、結果を使用して回答を生成し、タスクを計画します。アカウントでウェブ検索を適切に有効にするには、以下の手順に従います。
Navigate to AI/ML > Agents.
Settings を選択します。
以下に示すように、 Web search の横にあるトグルを選択してこの機能を有効にします。
Snowflakeは `Snowflakeプライバシー通知<https://www.snowflake.com/en/legal/privacy/privacy-policy/#2>`_(§2)に従って入力を処理します。ウェブ検索は、競合するウェブ検索サービスを再配布または作成する目的で使用することはできません。
プロンプトの例¶
自然言語のプロンプトを使ってCortexコードを操作することができます。プロンプトで、正確な結果を生成するために必要なコンテキスト(データベース、スキーマ、操作するオブジェクトなど)を入力します。環境全体で最も信頼性の高い結果を得るには、完全修飾オブジェクト名を使用します。
以下の例は、コード生成、最適化、管理上洞察をリクエストする一般的な方法を示しています。
アクセスと権限
ユースケース |
プロンプトの例 |
|---|---|
アクセス検出 |
「どのデータベースにアクセスできますか?」 |
セキュリティ監査 |
「PII があるすべてのテーブルを検索する。」 |
データ検出
ユースケース |
プロンプトの例 |
|---|---|
タグ検出 |
「ANALYTICS_DB で PII = TRUE とタグ付けされたすべてのテーブルを一覧表示」 |
系統およびタグ付け |
「RAW_DB.ORDERS から下流のダッシュボードまでの系列を表示。」 |
メタデータ検索 |
「顧客離脱とサブスクリプションステータスに関連するテーブルはどこにありますか?」 |
SQL 開発および最適化
ユースケース |
プロンプトの例 |
|---|---|
論理説明 |
「この SQL スクリプトはなにを実行しますか?」 |
生成 |
「上位10位の顧客に対して、収益と7日移動平均によるクエリを記述します。」 |
クエリの改良 |
「トップ実行者のクエリを更新して、上位100件を表示する」 |
パフォーマンスの最適化 |
「このクエリが遅い理由を説明し、最適化してください。」 |
データ統合 |
「SAMPLESDATA.SALES テーブルのeコマースサイトの30日間の売上の統合データを生成。」 |
インフラストラクチャとコスト管理
ユースケース |
プロンプトの例 |
|---|---|
リソースモニター |
「最も多くのクレジットを使用している5つのサービスタイプはどれですか?可視化とコストを削減する方法を表示してください。」 |
機械学習およびエンジニアリングパイプライン
ユースケース |
プロンプトの例 |
|---|---|
ノートブック(EDA および機械学習) |
「データ処理にpandas、 EDA と可視化にmatplotlib、seaborn、前処理、モデルトレーニング(ロジスティック回帰とツリーベースのモデル)、評価、解釈にscikit-learnを使用して、ビジネスへの影響と結果を説明する明確なマークダウンを含む、顧客離脱予測ユースケースのノートブックを作成してください。」 |
ディープラーニング |
「新しいノートブックを作成し、 MNIST データセット用の CNN をビルドしてください。」 |
パイプラインエンジニアリング |
「生の販売データを変換するdbtプロジェクトを作成する。」 |
セマンティックモデル統合(Cortex Analyst)
ユースケース |
プロンプトの例 |
|---|---|
セマンティッククエリ |
「@models/revenue.yamlセマンティックモデルを使用して、『前月の収益は?』に回答します」 |
モデルのデバッグ |
「@models/revenue.yamlセマンティックモデルのエラーを特定してください」 |
セキュリティとアクセス¶
Cortexコードは、Snowflakeアカウントの既存の認証およびロールベースのアクセス制御内で動作します(RBAC)認証情報を保存したり変更したりせず、現在のロールに許可されたアクションのみを実行します。
ワークスペースのCortexコード¶
Snowsight に統合されたアシスタントパネルからCortexコードにアクセスできます。Cortexコードは、アクティブなコードや環境、またはSnowflakeの一般的な知識のコンテキストでリクエストを処理します。
ワークスペースでCortexコードエージェントを使用するには:
Snowsight にサインインします。
ナビゲーションメニューで Projects » Workspaces を選択します。
関連するファイル(たとえば、既存の SQL ファイル)を含むワークスペースを開きます。
ワークスペースの右下にある Cortex Code アイコンを選択します。
自然言語を使用してプロンプトを入力するか、質問します。アイデアについては、 プロンプトの例 をご参照ください。
出力を確認します。Cortexコードは、回答、提案コード、または修正されたクエリを提供します。
コーディングタスクの場合、Cortexコードは、挿入と削除をハイライトした比較ビューを表示することがあります。提案された変更を確認し、スクリプトに直接適用します。
後続のプロンプトを使用して、コードを調整したり、ファイルを別のオブジェクトタイプ(ノートブックやセマンティックビューなど)に変換したり、 AISQL などの高度な関数を統合したりします。
AGENTS.mdおよびエージェントスキルでワークスペース内のCortexコードをカスタマイズ¶
AGENTS.md は、コーディングエージェントをガイドするためのシンプルでオープンな形式です。
AGENTS.mdを作成すると、Cortexコードがすべての会話に自動的に含める永続的な指示を提供する。ワークスペースのルートディレクトリにコピーすると、プロジェクトに関するCortexコードとの会話に適用されるパーソナライズされた手順が表示されます。
`エージェントスキル<https://agentskills.io/>`_ のサポートはまもなく利用可能になります。
ノートブックのCortexコード¶
Cortexコードを活用することで、データを探索し、クエリとコードを記述および編集し、インサイトを可視化し、 ワークスペースのノートブック でシームレスに結果を説明することができ、エンドツーエンドのデータサイエンスと機械学習の開発を加速します。
ノートブックのCortexコードでは次のことができます。
ワークスペースディレクトリでのノートブックの作成と管理
SQL、Python、Markdownセルの追加、削除、並べ替え
最新のプリインストールパッケージと適切なノートブック構文(セル参照など)を使用してコードを編集します。
matplotlib、seaborn、plotly、altairを使ってデータを可視化するコードを生成。
ノートブック全体または特定のセルを実行
プロンプトの例 を試してみてください。
dbt Projects on Snowflake 用Cortexコードエージェント¶
Cortexコードは、dbtのライフサイクルのすべてをスパンする変換ワークフローをサポートします。
生のソースデータを探索し、関係を推論
スキャフォールドステージングと中間モデル
マルチモデル DAGs およびメトリックの構築
データ品質テストと増分ロジックを追加
dbtコマンドを実行
プロジェクトドキュメントの生成と維持
自然言語プロンプトを使用するCortexコードエージェントは、データを探索し、dbtモデルを作成し、テストを追加し、パフォーマンスを最適化し、反復的なフィードバックを通じてドキュメントを生成するのに役立ちます。
プロジェクト構造とロジックに対する制御を維持しながら、定型的な SQL、依存関係管理、テスト、ドキュメントを自動化することで、日々のデータエンジニアリング作業を削減します。
dbtプロジェクトのプロンプトの例¶
Cortexコードエージェントは、新規および経験豊富なdbtユーザーの両方をサポートします。新規ユーザーは、新しくオンボーディングされたブロンズレイヤーデータを探索し、スキーマを推測し、ステージングモデルをスキャフォールディングして、クリーンな基盤を確立することができます。経験豊富なユーザーは、増分ファクトモデル、堅牢なテスト、自動生成ドキュメントを使用した複雑なデータマートを構築すると同時に、検証サイクルを迅速に反復できます。
次のシナリオは、dbtプロジェクトでCortexコードを使用する一般的な方法を示しています。
ユースケース |
コンテキスト |
プロンプトの例 |
|---|---|---|
ソースを探索 |
モデリングの前に生データスキーマと関係を理解します。 |
「ブロンズレイヤー内のすべてのソーステーブルをリストし、キー列、データ型、および考えられる主キーをまとめます。各ソースのステージングモデルを提案します。」 |
プロトタイピング |
マルチモデルロジックと DAGs の作成 |
「トラックと場所ごとに1日の収益性を計算するモデルを作成します。DAG を生成して依存関係を提案してください。」 |
データの品質 |
|
「not_nullとaccept_valuesテストをキーディメンションに追加します。推論キーに基づいて IDs の一意性テストを提案してください。」 |
増分ロジック |
モデルのパフォーマンスの最適化。 |
「主要なファクトモデルを、遅れて到着したデータのマージ動作を使用して、order_dateでパーティショニングされたインクリメンタルモデルに変換します。」 |
ドキュメント |
メンテナンスオーバーヘッドの削減。 |
「ソースコンテキストに基づいて、新しいモデルとキー列のプロジェクトのドキュメントとドラフトの説明を生成します。」 |
Cortexコード、Snowflake Intelligence、レガシーCopilot¶
Cortexコードは、広範囲のコーディングや管理タスクをサポートしていますが、Snowflake内のスタンドアロンのコーディングエージェントや他の特殊 AI システムとは異なります。
次のテーブルは、Cortexコード、Snowflake Intelligence、および レガシーCopilotエクスペリエンス の主な違いをまとめたものです。
機能 |
Cortexコード |
Snowflake Intelligence |
Snowflake Copilot(レガシー) |
|---|---|---|---|
ユースケース |
SQL の作成、データアセットの探索、管理タスクの実行など、Snowflakeでの開発および運用ワークフローをサポートします。 |
データに関する複雑な質問をし、分析に焦点を当てた応答を受信するための自然言語インターフェースを提供します。 |
ドキュメントヘルプと基本的な SQL 支援のためのCortexコードの以前のバージョン。 |
プライマリ統合 |
Snowsight とワークスペースに直接統合されています。アクティブなワークスペース内でコンテキストに応じた支援を提供します。 |
Snowflake Intelligence UI およびCortexエージェント API を介してアクセスし、洞察と推奨事項のための自然言語の相互作用を可能にします。 |
SQL および UI 支援のための個別のCopilot。 |
タスクの範囲 |
SQL の作成、データ探索、ドキュメント検索、アカウント管理をサポートします。 |
質問に対する回答、データのインサイト、分析主導の回答に焦点を当てます。 |
限られた SQL および UI 支援。 |
主な機能 |
SQL コードを生成および変更し、差分ビューを使用して変更をレビューし、既存のコードを説明します。 |
データを分析し、要約を生成し、自然言語との相互作用を支援します。 |
コンテキスト SQL 提案と限定的なヘルプ機能。 |
デザインの焦点 |
コーディング、ドキュメント、および管理ワークフロー全体で統一された AI インターフェースを提供します。 |
データを理解するための会話型の洞察とクエリの支援を提供します。 |
非推奨になり、Cortexコードに取って代わられました。 |