Partager des Agents Cortex¶

Exigences¶

Le partage d’un Agent Cortex nécessite les éléments suivants :

• Partage de tous les objets liés tels que les vues sémantiques ou les Cortex Search Services. Pour plus d’informations, voir Créer et configurer des partages et Partager les vues sémantiques.

• Les objets liés partagés doivent se trouver dans la même base de données que votre Agent Cortex partagé.

• Seuls les agents qui utilisent les types d’outils suivants peuvent être partagés : les vues sémantiques, les Cortex Search Services et les fonctions. Les Agents qui utilisent d’autres types d’outils, comme des procédures, des capacités ou des connecteurs MCP, ne peuvent pas être partagés.

Définir un Agent Cortex comme étant partagé¶

Vous pouvez partager vos Agents Cortex en tant que fournisseur dans la Snowflake Marketplace via Provider Studio.

Vous pouvez également définir un agent comme étant partagé avec une instruction SQL. L’exemple suivant ajoute l’agent my_agent au partage my_share :

GRANT USAGE ON AGENT my_agent TO SHARE my_share;

Si votre agent utilise des objets liés tels que des vues sémantiques, des Cortex Search Services ou des fonctions, vous devez également accorder ces objets au partage :

GRANT USAGE ON AGENT my_agent TO SHARE my_share;
GRANT SELECT, REFERENCES ON SEMANTIC VIEW my_sv TO SHARE my_share;
GRANT USAGE ON CORTEX SEARCH SERVICE my_css TO SHARE my_share;
GRANT USAGE ON FUNCTION my_function TO SHARE my_share;

Lorsque vous ajoutez un agent à un partage existant, l’utilisateur consommateur qui a installé le partage reçoit une notification par e-mail pour tester l’agent.

Identifier les agents partagés dans Snowsight¶

Dans le menu de navigation, sélectionnez AI & ML » Agents. La colonne Source indique si chaque agent est Local ou Partagé. Utilisez cette colonne pour faire rapidement la distinction entre les agents créés dans votre compte et les agents partagés avec vous à partir d’un autre compte.

Consommer un Cortex Agent partagé¶

Lorsque vous récupérez une annonce qui contient un Agent Cortex partagé, vous pouvez ajouter l’agent à Snowflake Intelligence. Pour ce faire, gardez le commutateur Ajouter à Snowflake Intelligence activé lorsque vous récupérez l’annonce. L’agent partagé est ainsi disponible en tant que source de données dans Snowflake Intelligence.

Réplication¶

Les Agents Cortex partagés prennent en charge la réplication. L’exécution automatique des annonces réplique les agents dans d’autres régions, ce qui permet aux consommateurs de différentes régions d’accéder à l’agent partagé.

Limitations¶

Les limitations suivantes s’appliquent aux Agents Cortex partagés :

• Une fonction de table SQL peut être partagée, mais pas une fonction de table Python définie par l’utilisateur.

• Si vous mettez à jour un agent partagé pour utiliser de nouveaux outils (tels que des vues sémantiques, des Cortex Search Services ou des fonctions), vous devez également accorder ces nouveaux outils au partage. Les nouveaux outils ne sont pas automatiquement ajoutés.

Considérations relatives aux clients¶

En plus des coûts payés au fournisseur de l’Agent Cortex partagé, les consommateurs sont facturés comme suit :

• Jetons d’entrée et de sortie utilisés par l’appel du consommateur de l’agent partagé.

• Utilisation de l’entrepôt du consommateur pour l’exécution SQL des requêtes et des outils.

Pour plus d’informations sur les coûts payés aux fournisseurs, consultez Payer pour des annonces. Pour plus d’informations sur les coûts de calcul de Snowflake, consultez le `Tableau de consommation du service Snowflake `_.