Cortex Code dans Snowsight¶

Vue d’ensemble¶

Cortex Code fournit une expérience agentique dans plusieurs domaines fonctionnels au sein de Snowsight. Il est conçu pour aider les analystes de données, les ingénieurs et les administrateurs dans des tâches telles que le développement SQL, l’exploration des données et la gestion des comptes en s’intégrant en profondeur dans l’interface Snowsight et en offrant des capacités telles que des vues de différence.

Cortex Code utilise une orchestration intelligente pour planifier et exécuter des tâches à plusieurs étapes en fonction de votre requête. De plus, il sélectionne les outils internes et le contexte pertinent dans votre environnement Snowflake pour effectuer la tâche, en s’assurant que chaque réponse est précise.

L’assistant suit un workflow agentique et interprète votre intention, crée un plan d’action et exécute les étapes tout en conservant le contexte dans la session.

Cortex Code comprend les rôles, les privilèges, les schémas et la syntaxe SQL et applique les meilleures pratiques de Snowflake lorsqu’il génère ou modifie du code.

Pour utiliser Cortex Code dans Snowsight, suivez les étapes suivantes :

Sélectionnez l’icône Cortex Code dans le coin inférieur droit. Le panneau Cortex Code s’ouvre à droite de Snowsight.
Dans la boîte de message, tapez votre question, puis sélectionnez l’icône d’envoi ou appuyez sur Entrer pour la soumettre. Cortex Code fournit une réponse dans le panneau.

Si la réponse de Cortex Code comprend des instructions SQL, vous pouvez exécuter les instructions ou les copier dans votre presse-papiers.

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour accéder à Cortex Code doit disposer des rôles de base de données suivants :

Rôle de la base de données	Remarques
SNOWFLAKE.COPILOT_USER	Requis pour que tous les utilisateurs puissent accéder à Cortex Code.
SNOWFLAKE CORTEX_USER SNOWFLAKE ou CORTEX_AGENT_USER	Au moins un de ces rôles de base de données est requis. SNOWFLAKE.CORTEX_AGENT_USER fournit des capacités supplémentaires pour les workflows agentiques.

Pour obtenir des instructions sur l’octroi de rôles de base de données, voir GRANT DATABASE ROLE.

Pour des informations générales sur les rôles et le contrôle d’accès, voir Aperçu du contrôle d’accès.

Note

Si votre compte a précédemment retiré (ou désactivé) de Snowflake Copilot (hérité), Cortex Code sera également désactivé. Contactez l’équipe de votre compte pour activer cette fonctionnalité pour votre compte.

Cas d’utilisation et avantages¶

Cortex Code dans Snowsight agit en tant qu’agent intelligent, vous aidant à travailler plus efficacement en traduisant les instructions en langage naturel en actions exécutables. En tenant compte du contexte de votre espace de travail et de la configuration du compte Snowflake, il facilite les tâches de développement, d’exploration et d’administration sans que vous ayez à quitter Snowsight.

Cortex Code prend en charge les domaines fonctionnels clés suivants au sein de Snowsight :

Codage agentique dans Workspaces¶

Cortex Code fonctionne comme assistant de codage conversationnel intégré dans Workspaces. Il prend en charge la génération, la modification, l’examen et l’explication de code interactif.

Génération de code et développement : générez des requêtes SQL, créez de nouveaux fichiers et construisez la logique pour les pipelines de données et les workflows d’analyse.
Modification et optimisation du code : affinez SQL directement dans un espace de travail, identifiez les erreurs de logique ou de syntaxe et suggérez des optimisations pour les performances, la lisibilité ou les coûts.
Contrôle des modifications : examinez les modifications suggérées par AI en utilisant une vue diff avant de les appliquer. La vue des différences met en évidence les insertions et les suppressions, ce qui permet aux utilisateurs de garder le contrôle sur leur code.
Explication du code : demandez une explication des requêtes SQL existantes pour faciliter la compréhension ou la collaboration.
** Poser des questions de suivi : ** poursuivez la conversation en posant des questions de clarification ou en demandant une analyse plus approfondie du code ou des résultats générés.
Actions rapides à partir de texte SQL en surbrillance : dans un fichier SQL, mettez en surbrillance le texte pour ouvrir des actions rapides telles que Quick Edit, Format, Add to Chat et Explain.
Corriger les erreurs SQL : si une instruction SQL échoue, cliquez sur le bouton Fix dans la grille des résultats pour obtenir des suggestions de correction pour l’erreur.

Découverte intelligente des produits et de la documentation¶

Cortex Code utilise le contexte du catalogue Horizon et de la documentation Snowflake pour vous aider à localiser les données et à référencer les informations sans quitter votre espace de travail.

Recherche de schéma en langage naturel : recherchez des objets de base de données tels que des tables et des colonnes à l’aide de requêtes en langage clair, sans avoir besoin de connaître les noms exacts des objets.
Q & A intégrés : récupérez les réponses sur les fonctionnalités de Snowflake, la syntaxe SQL ou les meilleures pratiques basées sur la documentation officielle.
Dé avec Snowflake Marketplace : si votre prompt fait référence à Snowflake Marketplace, Cortex Code recherchera et renverra des annonces sur Snowflake Marketplace.

Lorsqu’elles sont disponibles, les réponses peuvent inclure un contexte pertinent tel que des balises, des politiques de masquage et une lignée pour vous aider à valider les données que vous découvrez.

Administration des comptes simplifiée¶

Cortex Code prend en charge l’administration des comptes en fournissant des informations contextuelles sur la gouvernance, la sécurité et la gestion des coûts.

Gouvernance et sécurité : récupérez des informations sur l’accès des utilisateurs et des rôles, la propriété des données et les tables contenant des informations personnellement identifiables (PII).
Gestion des coûts : interrogez l’utilisation du compte et la consommation de crédit, et identifiez les entrepôts ou les requêtes à coûts élevés.

Modèles et régions pris en charge¶

Cortex Code prend en charge les modèles suivants. Vous pouvez utiliser ces modèles à condition que le compte y ait accès. Pour plus d’informations, voir Contrôle de l’accès au modèle.

Recommandé : Claude Opus 4.5 (claude-opus-4-5)
Claude Sonnet 4.5 (claude-sonnet-4-5)
Claude Sonnet 4.0 (claude-4-sonnet)

Bien que les modèles répertoriés puissent ne pas être disponibles dans toutes les régions, vous pouvez utiliser Cortex Code dans n’importe quel cloud ou région en utilisant l’inférence interrégionale Cortex. Cela inclut les clouds et les régions où les modèles ne sont pas disponibles. Pour plus d’informations, voir Inférence interrégionale.

Important

L’inférence interrégionale est requise lorsque le modèle sélectionné n’est pas disponible dans votre région. Si l’inférence échoue avec une erreur de disponibilité du modèle, configurez l’inférence interrégionale :

AWS US - Claude Sonnet 4+ offre la plus haute qualité. Configurez l’inférence interrégionale Cortex pour AWS_US afin d’accéder aux modèles Claude Sonnet 4.x.
AWS EU - Configurez l’inférence interrégionale de Cortex pour AWS_EU afin d’accéder aux modèles Claude.
AWS APJ - Configurez l’inférence interrégionale de Cortex pour AWS_APJ afin d’accéder aux modèles Claude.
N’importe quelle région - Configurez l’inférence interrégionale de Cortex pour ANY_REGION afin d’accéder à tous les modèles.

Pour activer l’inférence interrégionale, un ACCOUNTADMIN doit exécuter :

ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'AWS_US';

Copy

Remplacez AWS_US par l’identificateur de région approprié (AWS_US, AWS_EU, AWS_APJ, ANY_REGION).

Note

L’accès aux modèles peut également être restreint par votre organisation. Si vous ne pouvez pas accéder à un modèle même après avoir activé l’inférence interrégionale, vérifiez que le modèle est activé dans les paramètres d’accès au modèle AI de votre compte. Voir Contrôle de l’accès au modèle pour plus de détails.

Cortex Code nécessite que l’utilisateur possède le rôle de base de données SNOWFLAKE.COPILOT_USER et le rôle de base de donnéesSNOWFLAKE.CORTEX_USER ou SNOWFLAKE.CORTEX_AGENT_USER.

Note

Recherche Web¶

Un rôle ACCOUNTADMIN peut configurer la CLI de Cortex Code pour effectuer une recherche sur le Web et utiliser les résultats pour générer des réponses et effectuer des tâches de planification. Pour activer correctement la recherche Web dans un compte, procédez comme suit :

Accédez à AI/ML > Agents.
Sélectionnez Settings.
Sélectionnez le bouton bascule à côté de Web search pour activer la fonctionnalité, comme indiqué ci-dessous.

Basculement de recherche Web Cortex Code

Snowflake traitera vos entrées conformément à la Politique de confidentialité Snowflake (§2). La recherche Web ne peut pas être utilisée à des fins de redistribution ou de création d’un service de recherche Web concurrent.

Exemples d’invites¶

Vous pouvez interagir avec Cortex Code en utilisant des prompts de langage naturel. Dans vos invites, fournissez le contexte nécessaire pour générer des résultats précis (par exemple, la base de données, le schéma et les objets avec lesquels vous souhaitez travailler). Pour obtenir les résultats les plus fiables dans tous les environnements, utilisez des noms d’objets complets.

Les exemples suivants montrent des moyens typiques de demander la génération de code, l’optimisation et les informations administratives.

Accès et autorisations

Cas d’utilisation	Exemple d’invite
Découverte d’accès	« À quelles bases de données ai-je accès ? »
Audit de sécurité	« Trouvez toutes les tables qui contiennent PII. »

Découverte de données

Cas d’utilisation	Exemple d’invite
Découverte de balises	« Répertoriez chaque table balisée PII = TRUE dans ANALYTICS_DB. »
Lignée et balisage	« Affichez la lignée de RAW_DB.ORDERS vers les tableaux de bord en aval. »
Recherche de métadonnées	« Où puis-je trouver des tables relatives au désabonnement des clients et au statut de l’abonnement ? »

Développement et optimisation SQL

Cas d’utilisation	Exemple d’invite
Explication de la logique	« Que fait ce script SQL ?
Génération	« Écrivez une requête pour les 10 premiers clients par chiffre d’affaires et une moyenne mobile sur 7 jours. »
Affinage de la requête	« Mettez à jour la requête des meilleures performances pour afficher les 100 premiers. »
Optimisation des performances	« Expliquez pourquoi cette requête est lente et optimisez-la. »
Synthèse des données	« Générez des données synthétiques pour 30 jours de ventes pour un site d’e-commerce dans la table SAMPLESDATA.SALES. »

Gestion de l’infrastructure et des coûts

Cas d’utilisation	Exemple d’invite
Moniteur de ressources	« Quels 5 types de services utilisent le plus de crédits ? Montrez-moi une visualisation et comment réduire les coûts.

Machine learning et pipelines d’ingénierie

Cas d’utilisation	Exemple d’invite
Notebooks (EDA et machine learning)	« Construisez-moi un notebook pour un cas d’utilisation de prédiction du désabonnement des clients en utilisant pandas pour la gestion des données, matplotlib et seaborn pour l’analyse exploratoire (EDA) et la visualisation, ainsi que scikit-learn pour le prétraitement, l’entraînement des modèles (régression logistique et un modèle basé sur les arborescences), l’évaluation et l’interprétation, avec un balisage clair expliquant l’impact pour l’entreprise et les résultats.
Apprentissage profond	« Créez un nouveau notebook et construisez un CNN pour le jeu de données MNIST. »
Ingénierie des pipelines	« Créez un projet dbt pour transformer des données de ventes brutes. »

Intégration du modèle sémantique (Cortex Analyst)

Cas d’utilisation	Exemple d’invite
Requêtes sémantiques	« Utilisez le modèle sémantique @models/revenue.yaml pour répondre « Quels étaient les revenus du mois dernier ? »
Débogage du modèle	« Identifiez les erreurs dans mon modèle sémantique à @models/revenue.yaml »

Sécurité et accès¶

Cortex Code fonctionne dans les contrôles d’authentification et d’accès basés sur les rôles (RBAC) existants de votre compte Snowflake. Il ne stocke ni ne modifie vos informations d’identification et n’effectue que les actions autorisées par votre rôle actuel.

Cortex Code dans Workspaces¶

Vous pouvez accéder à Cortex Code via le panneau d’assistant intégré dans Snowsight. Cortex Code traite les requêtes dans le contexte du code ou de l’environnement actif, ou selon les connaissances générales de Snowflake.

Pour utiliser l’agent Cortex Code dans Workspaces :

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez Projects » Workspaces.
Ouvrez un espace de travail contenant le fichier concerné (par exemple, un fichier SQL existant).
Sélectionnez l’icône Cortex Code en bas à droite de l’espace de travail.
Saisissez une invite ou posez une question en langage naturel. Voir Exemples d’invites pour des idées.
Examinez la sortie. Cortex Code fournit une réponse, un code suggéré ou une requête modifiée.
Pour les tâches de codage, Cortex Code peut afficher une vue de comparaison mettant en évidence les insertions et les suppressions. Vérifiez les modifications suggérées et appliquez-les directement au script.
Utilisez les invites suivantes pour affiner le code, convertir le fichier en un type d’objet différent (comme un notebook ou une vue sémantique) ou intégrer des fonctions avancées comme AI SQL.

Personnaliser Cortex Code dans Workspaces avec AGENTS.md et Agent Skills¶

AGENTS.md est un format simple et ouvert pour guider les agents de codage.

Créez un fichier AGENTS.md pour fournir des instructions persistantes que Cortex Code inclura automatiquement dans chaque conversation. Copiez-le dans le répertoire racine de votre espace de travail pour obtenir des instructions personnalisées qui s’appliquent aux conversations avec Cortex Code sur votre projet.

La prise en charge d’Agent Skills sera bientôt disponible.

Cortex Code dans Notebooks¶

L’utilisation de Cortex Code vous aide à explorer les données, à écrire et à modifier des requêtes et du code, à visualiser des informations et à expliquer les résultats de manière transparente dans Notebooks dans Workspaces, accélérant ainsi le développement global de la science des données et du machine learning.

Cortex Code dans Notebooks peut :

Créer et gérer des notebooks dans le répertoire Workspaces
Ajouter, supprimer et réorganiser les cellules SQL, Python et Markdown
Modifier le code en utilisant des paquets préinstallés à jour et une syntaxe de notebook appropriée (par exemple, le référencement de cellule)
Générer du code pour visualiser les données en utilisant matplotlib, seaborn, plotly et altair
Exécuter un notebook entier ou des cellules spécifiques

Essayez ces exemples d’invites.

Agent Cortex Code pour dbt Projects on Snowflake¶

Cortex Code prend en charge les workflows de transformation qui couvrent tout le cycle de vie dbt :

Explorer les données sources brutes et les relations d’inférence
Concevez des modèles de mise en zone de préparation et intermédiaires.
Créer des DAGs multi-modèles et les métriques associées
Ajouter des tests de qualité des données et une logique incrémentielle
Exécuter des commandes dbt
Générer et tenir à jour la documentation du projet

À l’aide d’invites en langage naturel, l’agent Cortex Code vous aide à explorer des données, à créer des modèles dbt, à ajouter des tests, à optimiser les performances et à générer de la documentation par le biais de commentaires itératifs.

Il réduit le travail quotidien d’ingénierie des données en automatisant les requêtes SQL de code standard, la gestion des dépendances, les tests et la création de documentation, tout en préservant le contrôle de la structure et de la logique du projet.

Exemples d’invites pour les projets dbt¶

L’agent Cortex Code prend en charge les utilisateurs dbt nouveaux et expérimentés. Les nouveaux utilisateurs peuvent explorer les données de la couche Bronze nouvellement installées, déduire les schémas et concevoir les modèles de génération de zone de préparation pour établir une base propre. Les utilisateurs expérimentés peuvent construire des datamarts complexes avec des modèles factuels incrémentiels, des tests robustes et une documentation générée automatiquement, tout en itérant rapidement au fil des cycles de validation.

Les scénarios suivants illustrent des moyens courants d’utiliser Cortex Code avec des projets dbt.

Cas d’utilisation	Contexte	Exemple d’invite
Explorer les sources	Comprenez les schémas et les relations des données brutes avant la modélisation.	« Listez toutes les tables sources dans la couche bronze et résumez les colonnes clés, les types de données et les clés primaires probables. Proposez des modèles de mise en zone de préparation pour chaque source. »
Prototypage	Création d’une logique multi-modèles et de DAGs.	« Créer des modèles pour calculer la rentabilité quotidienne par camion et par emplacement. Générez le DAG et proposez des dépendances. »
Qualité des données	Ajout de tests à `schema.yml`.	« Ajoutez des tests not_null et accepted_values aux dimensions clés. Suggérez des tests d’unicité pour les IDs basés sur des clés déduites. »
Logique incrémentielle	Optimisation des performances des modèles.	« Convertissez le modèle factuel principal en un modèle incrémentiel partitionné par order_date, avec un comportement de fusion pour les données qui arrivent tard. »
Documentation	Réduction des frais de maintenance.	« Générez des documents pour le projet et ébauchez des descriptions pour les nouveaux modèles et colonnes clés en fonction du contexte source. »

Cortex Code, Snowflake Intelligence et Copilot hérité¶

Bien que Cortex Code prenne en charge un large éventail de tâches de codage et de tâches administratives, il se distingue des agents de codage autonomes et d’autres systèmes AI spécialisés au sein de Snowflake.

Le tableau suivant résume les principales différences entre Cortex Code, Snowflake Intelligence et l’expérience Copilot héritée.

Fonctionnalité	Cortex Code	Snowflake Intelligence	Snowflake Copilot (hérité)
Cas d’utilisation	Prend en charge les workflows de développement et d’exploitation dans Snowflake, y compris la création SQL, l’exploration des actifs de données et l’exécution des tâches administratives.	Fournit une interface en langage naturel pour poser des questions complexes sur les données et recevoir des réponses basées sur l’analyse.	Itération précédente de Cortex Code pour l’aide à la documentation et l’assistance SQL de base.
Intégration principale	Intégré directement dans Snowsight et Workspaces. Fournit une assistance contextuelle dans l’espace de travail actif.	Accessible via l’UI Snowflake Intelligence et l’API Cortex Agents, permettant une interaction en langage naturel pour les informations et les recommandations.	Copilote séparé pour SQL et l’aide de l’UI.
Périmètre des tâches	Prend en charge la création SQL, l’exploration de données, la recherche de documentation et l’administration de comptes.	Se concentre sur la réponse aux questions, les informations sur les données et les réponses basées sur l’analyse.	Création SQL et aide de l’UI limitées.
Capacités clés	Génère et modifie le code SQL, examine les modifications à l’aide d’une vue différentielle et explique le code existant.	Analyse les données, génère des résumés et facilite les interactions en langage naturel.	Suggestions SQL contextuelles et fonctionnalités d’aide limitées.
Axé sur la conception	Fournit une interface AI unifiée pour les workflows de codage, de documentation et d’administration.	Fournit des informations conversationnelles et une assistance en matière de requêtes pour la compréhension des données.	Obsolète en faveur de Cortex Code.