Contrôles des coûts pour Cortex Code¶

Comment fonctionnent les limites de crédit¶

Chaque paramètre suit l’utilisation du crédit estimée de l’utilisateur correspondant sur une fenêtre continue de 24 heures. Lorsque l’utilisation estimée d’un utilisateur atteint la limite configurée pour une surface donnée, l’accès est bloqué pour cette surface jusqu’à ce que l’utilisation tombe en dessous du seuil.

Les deux paramètres partagent le même comportement :

Chaque paramètre peut être défini au niveau du compte (s’applique à tous les utilisateurs) ou au niveau de l’utilisateur (s’applique à un utilisateur spécifique). Un paramètre au niveau de l’utilisateur remplace le paramètre au niveau du compte pour cet utilisateur.

Limites de la CLI Code Cortex¶

Le paramètre CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER contrôle la limite de crédit journalière pour l’utilisation de la CLI Cortex Code.

-- Set the daily credit usage limit to 20 credits for all users in the account
ALTER ACCOUNT SET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER = 20;

-- Remove the account-level limit (restores default unlimited usage)
ALTER ACCOUNT UNSET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER;

-- Set a per-user CLI limit that overrides the account-level setting
ALTER USER jsmith SET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER = 10;

-- Remove the user-level override (account-level setting applies instead)
ALTER USER jsmith UNSET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER;

Limites de Cortex Code dans Snowsight¶

Le paramètre CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER contrôle la limite de crédit quotidienne pour l’utilisation de Cortex Code dans l’interface Web de Snowsight.

-- Set the daily Snowsight credit usage limit to 20 credits for all users in the account
ALTER ACCOUNT SET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER = 20;

-- Remove the account-level Snowsight limit (restores default unlimited usage)
ALTER ACCOUNT UNSET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER;

-- Set a per-user Snowsight limit that overrides the account-level setting
ALTER USER jsmith SET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER = 10;

-- Remove the user-level Snowsight override (account-level setting applies instead)
ALTER USER jsmith UNSET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER;

Lorsqu’une limite est atteinte¶

Lorsque l’utilisation du crédit estimée d’un utilisateur dépasse la limite configurée pour une surface, cette surface renvoie une erreur indiquant que la limite de crédit quotidienne a été atteinte. L’utilisateur ne peut pas utiliser cette surface tant qu’un délai suffisant ne s’est pas écoulé pour que l’utilisation cumulée de 24 heures glissantes tombe en dessous de la limite. Les autres zones avec des limites distinctes ne sont pas concernées.

Les administrateurs peuvent ajuster ou supprimer la limite à tout moment pour restaurer l’accès.

Affichage des utilisateurs avec des limites personnalisées¶

Le script SQL suivant liste tous les utilisateurs qui ont un remplacement de la limite de crédit par utilisateur pour le paramètre CLI. Ceci est utile pour les administrateurs qui souhaitent auditer quels utilisateurs ont des limites personnalisées définies au niveau de l’utilisateur.

-- List all users who have a per-user CLI credit limit override
EXECUTE IMMEDIATE $$
DECLARE
  current_user STRING;
  rs_users RESULTSET;
  res      RESULTSET;
BEGIN
  CREATE OR REPLACE TEMPORARY TABLE _param_overrides (user_name STRING, param_value STRING);

  SHOW USERS;
  rs_users := (SELECT "name" FROM TABLE(RESULT_SCAN(LAST_QUERY_ID())));

  FOR record IN rs_users DO
    current_user := record."name";

    EXECUTE IMMEDIATE
      'SHOW PARAMETERS LIKE ''CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER'' IN USER "' || :current_user || '"';

    INSERT INTO _param_overrides (user_name, param_value)
      SELECT :current_user, "value"
      FROM TABLE(RESULT_SCAN(LAST_QUERY_ID()))
      WHERE "level" = 'USER';
  END FOR;

  res := (SELECT * FROM _param_overrides);
  RETURN TABLE(res);
END;
$$;

Ce script itère sur tous les utilisateurs du compte, vérifie si un remplacement au niveau de l’utilisateur est défini pour``CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER``, et renvoie une table d’utilisateurs avec leurs valeurs de remplacement. Vous pouvez modifier le nom du paramètre dans la clause SHOW PARAMETERS LIKE pour vérifier le paramètre Snowsight à la place.

Exemple : Configuration des limites pour votre organisation¶

L’exemple suivant définit des limites par défaut pour tous les utilisateurs du compte sur les deux surface, puis attribue une limite supérieure à un utilisateur expert pour l’utilisation de la CLI :

-- Set default daily limits for all users
ALTER ACCOUNT SET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER = 20;
ALTER ACCOUNT SET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER = 20;

-- Allow a specific user a higher CLI limit
ALTER USER power_user SET CORTEX_CODE_CLI_DAILY_EST_CREDIT_LIMIT_PER_USER = 50;

-- Block a specific user from Snowsight entirely
ALTER USER restricted_user SET CORTEX_CODE_SNOWSIGHT_DAILY_EST_CREDIT_LIMIT_PER_USER = 0;