Référence

Cette page fournit des informations de référence sur l’utilisation de Snowflake Intelligence. Elle couvre les concepts suivants :

  • Points de terminaison REST API et commandes SQL disponibles pour créer, gérer et interagir avec les Agents Cortex

  • Les modèles d’AI pris en charge et leur disponibilité régionale

  • Mentions légales sur l’utilisation des modèles et la classification des données

Commandes SQL et référence d’API

Snowflake propose les méthodes programmatiques suivantes pour créer des Agents Cortex et interagir avec eux dans le cadre de Snowflake Intelligence :

API REST d’objet Cortex Agent

L’API REST d’objet Cortex Agent fournit un ensemble complet de points de terminaison pour la création d’applications optimisées par l’AI qui s’intègrent à Snowflake Intelligence. Vous pouvez utiliser l’API REST pour gérer les objets agent et orchestrer les interactions avec vos données.

Opérations de gestion des agents

L’API REST d’objet agent prend en charge les opérations suivantes pour la gestion des objets Cortex Agent :

Fonctionnement

Point de terminaison

Description

Créer

POST /api/v2/databases/{database}/schemas/{schema}/agents

Crée un nouvel Agent Cortex avec des attributs spécifiés et une configuration d’outil spécifiée.

Décrire

GET /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Récupère la configuration et les métadonnées d’un agent existant.

Mettre à jour

PUT /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Modifie la configuration, les outils ou les instructions d’un agent existant.

Liste

GET /api/v2/databases/{database}/schemas/{schema}/agents

Répertorie tous les agents d’une base de données et d’un schéma spécifiés, avec des options de filtrage.

Supprimer

DELETE /api/v2/databases/{database}/schemas/{schema}/agents/{name}

Supprime un agent de votre compte.

Pour des spécifications API détaillées, notamment les paramètres de requête, les schémas de réponse et des exemples, voir API REST des Cortex Agents.

Commandes SQL Agents

Snowflake fournit des commandes SQL pour créer et gérer les objets Agents Cortex à utiliser avec Snowflake Intelligence.

Commandes de gestion des agents

Les commandes SQL suivantes sont disponibles pour la gestion des Agents Cortex :

Commande

Description

CREATE AGENT

Crée un nouvel Agent Cortex ou remplace un existant avec des attributs spécifiés, des paramètres de profil et une spécification YAML.

DESCRIBE AGENT

Récupère la configuration, la spécification et les métadonnées complètes d’un agent existant.

SHOW AGENTS

Liste tous les Agents Cortex pour lesquels vous disposez de privilèges d’accès, avec des options de filtrage et de pagination.

DROP AGENT

Supprime un agent du schéma actuel ou du schéma spécifié.

Pour obtenir une syntaxe SQL détaillée, les paramètres et des exemples, voir Commandes Cortex Agent.

Modèles et régions pris en charge

Snowflake Intelligence prend en charge les modèles répertoriés dans Modèles. 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.

Lors de la création d’un agent, nous vous recommandons de sélectionner Auto pour le modèle. Cela permet à Snowflake Intelligence de sélectionner automatiquement le modèle de la meilleure qualité pour votre compte. La qualité s’améliore automatiquement à mesure que de nouveaux modèles deviennent disponibles.

Bien que les modèles répertoriés puissent ne pas être disponibles dans toutes les régions, vous pouvez utiliser Snowflake Intelligence 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 sur la configuration de l’inférence interrégionale Cortex, voir Inférence interrégionale.

  • AWS US - Dans AWS, Claude 4+ offre la meilleure qualité et les meilleures performances en matière de vitesse. Nous vous recommandons de configurer l’inférence interrégionale Cortex aws_us pour utiliser Claude 4 et obtenir les meilleures performances. Sans inférence interrégionale Cortex, vous êtes limité à l’utilisation de Claude 3.5 dans aws_us.

  • Azure US - Si vous utilisez Snowflake Intelligence dans East US, vous pouvez utiliser GPT 4.1+ sans inférence interrégionale Cortex. Les autres combinaisons de régions et de modèles nécessitent la configuration de l’inférence interrégionale Cortex pour azure_us.

  • AWS EU - Vous pouvez utiliser Claude 4+ dans cette région à condition de configurer l’inférence interrégionale de Cortex pour aws_eu.

  • AWS APJ - Vous pouvez utiliser Claude 4+ dans cette région à condition de configurer l’inférence interrégionale de Cortex pour aws_apj.