SnowsightのCortexコード

概要

Cortexコードは、 Snowsight 内のいくつかの機能エリアでエージェント体験を提供します。これは、 Snowsight インターフェースに深く統合され、差分ビューなどの機能を提供することで、 SQL 開発、データ探索、アカウント管理などのタスクを実行するデータアナリスト、エンジニア、管理者を支援するように設計されています。

Cortexコードは、インテリジェントなオーケストレーションを使用して、リクエストに基づいてマルチステップのタスクを計画し実行します。さらに、Snowflake環境から内部ツールと関連するコンテキストを選択してタスクを完了し、各応答が正確であることを確認します。

アシスタントはエージェントワークフローに従い、あなたの意図を解釈し、アクションの計画を作成し、セッション全体でコンテキストを維持しながらステップを実行します。

Cortexコードは、ロール、権限、スキーマ、 SQL 構文を理解し、コードの生成または変更時にSnowflakeのベストプラクティスを適用します。

Snowsight でCortexコードを使用するには、次のステップに従います。

  1. 右下隅のCortexコードアイコン Cortexコードアイコン を選択します。Cortexコードパネルが Snowsight の右側に表示されます。

  2. メッセージボックスに質問を入力し、送信アイコンを選択するか、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 ボタンをクリックすると、エラーの修正が提案されます。

  • **AIを活用したコード提案（現在プレビュー中）：SQLファイルに入力していると、Cortex Codeはコンテキストに応じたインライン提案を表示し、開発の速度と精度を改善します。

AIコード提案

Snowflakeのロゴ（黒）（文字なし） プレビュー機能 --- オープン

すべてのアカウントで利用可能です。

Cortex Codeは、SnowflakeにおけるSQL向けに、インテリジェントでコンテキストに応じたインラインコード提案を提供します。SQLファイルに入力していると、Cortex CodeはSQLステートメントの次の部分を予測して提案し、それはカーソル位置に灰色のテキストで表示されます。

Cortex Codeは、クエリ履歴、現在のワークスペースのコンテンツ、テーブルスキーマ、および現在のワークスペースで最後に実行された数件のクエリを使用して、作業パターンに合わせた提案を生成します。

提案は、入力中に少し手を止めた後、または直前の提案を受け入れた直後に自動的にトリガーされます。

提案を操作する際は、次のアクションを実行できます。

  • 提案を受け入れるには、Shift + :kbd:`Enter`キーを押します。

  • 提案を破棄するには、Esc、Delete、または:kbd:`Backspace`キーを押すか、入力を続けます。

カタログ提案がインライン提案と同時に表示された場合は、Shift + :kbd:`Enter`キーを押してインライン提案を受け入れるか、下矢印キーを押してから:kbd:`Enter`キーを押してカタログオプションを選択します。

注釈

AIコード提案は、時として正しくなかったり、意図と一致しなかったりする場合があります。提案が関連していない場合は、その提案を破棄し、より多くのコンテキストを提供するために入力を続けます。

AIコード提案を無効にするには、次の手順に従います。

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Projects » Workspaces を選択します。

  3. SQLファイルから、右上隅の:ui:`Settings`アイコンを選択します。

  4. User preferences を選択します。

  5. :ui:`AI code suggestions`トグルを選択して、この機能を無効にします。

  6. Close を選択します。

インテリジェントな製品とドキュメントの検出

Cortexコードは、HorizonカタログとSnowflakeドキュメントのコンテキストを使用して、ワークスペースを離れることなくデータアセットと参照情報を見つけることができます。

  • 自然言語スキーマ検索： 正確なオブジェクト名を知ることなく、平易な言語クエリを使用してテーブルや列などのデータベースオブジェクトを検索します。

  • 統合されたQ&A： Snowflakeの機能、 SQL 構文、または公式ドキュメントに基づくベストプラクティスに関する回答を取得します。

  • Snowflake Marketplace検出： プロンプトがSnowflake Marketplaceを参照している場合、CortexコードはSnowflake Marketplaceからのリストを検索して返します。

利用可能な場合、応答には、タグ、マスキングポリシー、系統などの関連コンテキストが含まれ、発見されたデータアセットを検証するのに役立ちます。

アカウント管理の簡素化

Cortexコードは、ガバナンス、セキュリティ、コスト管理に関するコンテキスト情報を提供することで、アカウント管理をサポートします。

  • ガバナンスとセキュリティ： ユーザーとロールのアクセス、データ所有権、および個人を特定できる情報（PII）が含まれたテーブルを取得します。

  • コスト管理： アカウント使用状況とクレジット消費をクエリし、コストの高いウェアハウスやクエリを特定します。

サポートされているモデルとリージョン

Cortexコードは以下のモデルをサポートしています。これらのモデルは、アカウントにアクセスがある限り使用できます。詳細については、 モデルアクセスの制御 をご参照ください。

  • 推奨：Claude Opus 4.6（claude-opus-4-6）

  • 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コードを使用できます。これには、モデルが利用できないクラウドやリージョンが含まれます。詳細については、 クロスリージョン推論 をご参照ください。

重要

選択したモデルがリージョンで利用できない場合、クロスリージョン推論が必要になります。 モデル可用性エラーで推論が失敗した場合は、クロスリージョン推論を構成します。

  • AWS US：Claude Opus 4.6は最高の品質を提供します。``AWS_US``向けにCortexクロスリージョン推論を設定して、Claude Opus 4.6モデルにアクセスします。

  • AWSEU ：AWS_EU 用Cortexクロスリージョン推論を設定してClaudeモデルにアクセスします。

  • AWSAPJ ：AWS_APJ 用Cortexクロスリージョン推論を設定してClaudeモデルにアクセスします。

  • AWS AU - Set up Cortex Cross-region inference for AWS_AU to access Claude Opus 4.6 models.

  • 任意のリージョン：ANY_REGION 用Cortexクロスリージョン推論を設定してすべてのモデルにアクセスします。

クロスリージョン推論を有効にするには、 ACCOUNTADMIN は次を実行する必要があります：

ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'AWS_US';

Replace AWS_US with the appropriate region identifier (AWS_US, AWS_EU, AWS_APJ, AWS_AU, ANY_REGION).

注釈

モデルへのアクセスは、組織によって制限されることもあります。クロスリージョン推論を有効にしてもモデルにアクセスできない場合は、アカウントの AI モデルアクセス設定でモデルが有効になっていることを確認してください。詳細については モデルアクセスの制御 をご参照ください。

Cortexコードでは、ユーザーは SNOWFLAKE.COPILOT_USER データベースロールおよび SNOWFLAKE.CORTEX_USER または SNOWFLAKE.CORTEX_AGENT_USER データベースロールのいずれかを持っている必要があります。

注釈

アカウントが以前にSnowflake Copilot（レガシー）をオプトアウト（または無効化）した場合、Cortexコードも無効になります。アカウントでこの機能を有効にするには、アカウントチームにお問い合わせください。

プロンプトの例

自然言語のプロンプトを使って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 ワークシート、ワークスペース、またはUIの左下隅にあるロールセレクターで選択したロールに関係なく、常に既定のロールを使用してセッションを開始します。別のロールを必要とするアクションを実行する必要がある場合は、セッション中にCortexコードにロールを変更するように依頼できます（例：「SYSADMINロールに変更」）。

注釈

Cortexコードが権限エラーを返す場合、既定のロールに必要な権限があることを確認してください。ALTER USER を使用して既定のロールを変更するか、現在のセッションで特定のロールを使用するようCortexコードに依頼します。

ワークスペースのCortexコード

Snowsight に統合されたアシスタントパネルからCortexコードにアクセスできます。Cortexコードは、アクティブなコードや環境、またはSnowflakeの一般的な知識のコンテキストでリクエストを処理します。

ワークスペースでCortexコードエージェントを使用するには：

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Projects » Workspaces を選択します。

  3. 関連するファイル（たとえば、既存の SQL ファイル）を含むワークスペースを開きます。

  4. ワークスペースの右下にある Cortex Code アイコンを選択します。

  5. 自然言語を使用してプロンプトを入力するか、質問します。@ と入力して、カタログオブジェクト（テーブル、スキーマ、ビューなど）を検索してインラインコンテキストとして追加します。アイデアについては、 プロンプトの例 をご参照ください。

  6. 出力を確認します。Cortexコードは、回答、提案コード、または修正されたクエリを提供します。

  7. コーディングタスクの場合、Cortexコードは、挿入と削除をハイライトした比較ビューを表示することがあります。提案された変更を確認し、スクリプトに直接適用します。

  8. 後続のプロンプトを使用して、コードを調整したり、ファイルを別のオブジェクトタイプ（ノートブックやセマンティックビューなど）に変換したり、 AISQL などの高度な関数を統合したりします。

AGENTS.mdおよびエージェントスキルでワークスペース内のCortexコードをカスタマイズ

AGENTS.md は、コーディングエージェントをガイドするためのシンプルでオープンな形式です。

AGENTS.mdを作成すると、Cortexコードがすべての会話に自動的に含める永続的な指示を提供する。ワークスペースのルートディレクトリにコピーすると、プロジェクトに関するCortexコードとの会話に適用されるパーソナライズされた手順が表示されます。

`エージェントスキル<https://agentskills.io/>`_ のサポートはまもなく利用可能になります。

スキル

スキルは、Cortex Codeに特化した機能を追加します。これらのスキルは、メッセージボックスに``/``と入力することで呼び出せます。

組み込みスキル

Snowflakeは、|sf-web-interface|の任意のページから利用できる組み込みスキルを提供します。``/``と入力し、利用可能なスキルを表示して選択します。|sf-web-interface|に機能チームが新しいスキルを追加するにつれて、組み込みスキルのリストも変化していきます。

個人用スキル

ワークスペースで独自のスキルを作成し、特定のワークフローに合わせてCortex Codeをカスタマイズできます。

個人用スキルを追加するには、ワークスペースで以下のいずれかのオプションを使用します。

  • Upload Skill File(s)

  • Upload Skill Folder(s)

  • + Create Skill

個人用スキルはワークスペースの:file:.snowflake/cortex/skills`ディレクトリに保存され、メッセージボックスに`/``と入力することで呼び出すことができます。

注釈

個人用スキルには、作成されたワークスペースからのみアクセスできます。別のワークスペースを使用している場合や、ワークスペース外にいる場合は利用できません。

ノートブックの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 を生成して依存関係を提案してください。」

データの品質

schema.yml へのテストの追加。

「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コードに取って代わられました。