Aller au contenu principal

Genie Code CLI

Genie Code CLI est un agent de codage qui s’exécute localement dans votre terminal et qui est configuré pour le travail sur les données et l’IA sur Databricks. Il fonctionne comme les autres agents de codage de terminal, mais il est préconfiguré pour comprendre Databricks et pour fonctionner naturellement avec vos données, pipelines de données, modèles et applications.

Parce qu'il s'exécute sur votre machine, Genie Code CLI peut lire et modifier vos fichiers locaux, exécuter des commandes et accéder à Databricks en votre nom. Il utilise la CLI Databricks, y compris les commandes databricks genie telles que databricks genie ask, pour découvrir les données et répondre aux questions. Genie Code CLI utilise des modèles fournis par Databricks ; vous n'avez donc pas besoin d'apporter votre propre abonnement à un modèle. Vous gérez l'accès et les budgets de la même manière que pour Genie Code. Voir Facturation et budgets.

Prérequis​

Genie Code CLI s’exécute sous votre propre identité. Par conséquent, il ne peut accéder qu’aux données et effectuer les opérations autorisées par vos permissions Databricks.

Installer et configurer​

  1. Installez séparément la Databricks CLI (version 1.0.0 ou supérieure), si ce n'est pas déjà fait. Consultez Install or update the Databricks CLI.

  2. Installez Genie Code CLI avec la commande correspondant à votre système d’exploitation.

Bash
curl -fsSL https://github.com/databricks/genie-code-cli/releases/latest/download/install.sh | bash
  1. Confirmez l'installation :

    Bash
    genie --version
  2. Accédez au répertoire de votre projet et start Genie Code CLI :

    Bash
    cd my-project
    genie
  3. Lorsque vous y êtes invité, sélectionnez un profil CLI Databricks ou authentifiez-vous si vous n'en avez pas configuré. Voir Authentification pour la CLI Databricks. La CLI Genie Code utilise ce profil pour l'accès aux modèles et la facturation. Il peut toujours utiliser d'autres profils CLI Databricks pour travailler avec d'autres Workspace ou travailler entièrement en dehors de Databricks.

  4. Confirmez que vous faites confiance au contenu du répertoire, puis start à rédiger des invites.

Ce que vous pouvez faire avec la CLI Genie Code​

La Genie Code CLI peut interagir directement avec des fichiers locaux, découvrir et query vos données Unity Catalog via Genie, ainsi que créer et déployer des assets Databricks à partir d'une seule conversation dans le terminal. Par exemple :

  • Ingérer et gouverner : « Nettoyez ces CSV de ventes mensuels, chargez-les dans Unity Catalog et montrez-moi le chiffre d’affaires par région au fil du temps. »
  • Explorez vos données : « Quel est le catalogue qui contient les données de désabonnement des clients et quels ont été les principaux drivers au dernier trimestre ? »
  • Étendre un pipeline : "Ajouter une table silver refunds à mon pipeline de commandes et reconstituer les données des 90 derniers jours."
  • Entraîner et déployer un modèle : "Exécutez ce script d'entraînement sur Databricks et placez le modèle derrière un endpoint."
  • Créer et déployer une application : « Créer un prototype d'application locale pour ma table customers et le déployer en tant qu'application Databricks. »

En quoi l’interface de ligne de commande (CLI) de Genie Code diffère-t-elle de Genie Code dans le Workspace​

Genie Code CLI est une expérience distincte conçue pour le travail local dans le terminal. Il dispose également de ses propres outils, compétences et instructions et, pour le moment, ne les partage pas avec Genie Code dans le Workspace Databricks. Il n’inclut pas non plus encore toutes les fonctionnalités disponibles dans l’interface utilisateur du Workspace.

Utilisez Genie Code CLI comme compagnon natif du terminal lorsque vous travaillez localement avec des fichiers, des scripts et des prototypes. Continuez à utiliser Genie Code dans le Workspace pour bénéficier d’une expérience plus riche et complète.

Configurer des compétences et des serveurs MCP​

Vous pouvez étendre Genie Code CLI avec des compétences, des serveurs MCP et des instructions de projet. Si vous utilisez déjà Claude Code ou Cursor, exécutez /import dans Genie Code CLI pour importer votre configuration à partir de ceux-ci.

Ajouter des compétences​

Genie Code CLI est déjà installé avec les compétences d’agent Databricks. L'agent travaille donc plus efficacement avec les données et les ressources Databricks comme les jobs, les pipelines, les modèles et les applications. Ces compétences sont dans ~/.genie/skills/.system/.

Pour ajouter votre propre compétence, créez un dossier contenant un fichier SKILL.md au format d’assistant de compétences standard et enregistrez-le dans ~/.genie/skills/. Pour partager une compétence avec votre équipe, enregistrez-la plutôt dans .agents/skills/ dans votre repository. La CLI Genie Code charge également des compétences à partir d’autres dossiers locaux, tels que les dossiers parents de votre répertoire de travail et la racine de votre repository.

Vous pouvez également demander à l’interface de ligne de commande (CLI) de Genie Code de créer une compétence ou de convertir une compétence existante à partir d’un autre agent de codage.

Genie Code CLI charge les compétences uniquement à partir de dossiers locaux. Pour utiliser une compétence de votre workspace Databricks, telle qu’une compétence dans .assistant/skills/, download-la dans l’un de ces dossiers.

Connecter des serveurs MCP​

Utilisez genie mcp add pour connecter le CLI de Genie Code à n'importe quel serveur MCP, y compris les serveurs MCP qui ne sont pas hébergés sur Databricks.

Pour connecter un serveur MCP distant, indiquez son URL et le nom d’une variable d’environnement qui contient un jeton d’accès pour celui-ci :

Bash
genie mcp add <server-name> --url <server-url> --bearer-token-env-var <env-var-name>

Pour connecter un serveur MCP qui s’exécute sur votre machine, transmettez la commande qui le start :

Bash
genie mcp add <server-name> -- <command> <args>

Pour connecter un serveur MCP géré sur Databricks, tel que le serveur MCP Genie One:

  1. Stockez un jeton d'accès Databricks dans une variable d'environnement :

    Bash
    export DATABRICKS_MCP_TOKEN=$(databricks auth token --profile <profile-name> | jq -r .access_token)
  2. Ajoutez le serveur MCP et transmettez le nom de la variable d’environnement. Si l’URL de votre workspace inclut un ID de workspace, tel que ?o=<workspace-id>, ajoutez-le à la fin de l’URL du serveur MCP.

    Bash
    genie mcp add genie_one \
    --url "https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp" \
    --bearer-token-env-var DATABRICKS_MCP_TOKEN
  3. Dans le même terminal, start la CLI Genie Code :

    Bash
    genie
  4. Exécutez /mcp pour confirmer que le serveur est connecté.

Ajouter des instructions de projet​

Pour donner à Genie Code CLI des instructions qui s’appliquent à chaque conversation dans un projet, telles que les conventions de codage, les noms de catalogue et de schéma, ou la manière d’exécuter les tests, ajoutez un fichier AGENTS.md à la racine de votre répertoire de projet. Genie Code CLI lit ce fichier lorsque vous le start dans ce répertoire.

Disponibilité régionale​

Genie Code CLI est un service désigné. Sa disponibilité dépend de la région de votre workspace et du paramètre Appliquer le traitement des données dans la région géographique du workspace pour les services désignés . Le traitement inter-géographique est activé par default pour les Workspace en dehors des États-Unis et de l'UE qui n'ont pas activé le profil de sécurité de la conformité. Si le traitement inter-géographique est désactivé, Genie Code CLI peut ne pas être disponible dans votre workspace. Pour la disponibilité dans chaque Geo, voir Disponibilité des services désignés dans chaque Geo.

La CLI Genie Code n’est pas disponible dans les régions où la facturation à l’utilisation Genie n’est pas proposée : centre-ouest des États-Unis et centre du Qatar (Azure), Asie-Pacifique (Jakarta) (AWS), ainsi que les régions gouvernementales.

Recherche web​

La recherche Web a des exigences supplémentaires :

  • La recherche sur le web a les mêmes exigences que la recherche sur le web dans Genie Code, notamment la préversion de la recherche sur le web dans Genie Code et Genie One .
  • Contrairement à la recherche sur le Web dans Genie Code, la recherche sur le Web dans Genie Code CLI n’est pas disponible dans les Workspace avec le profil de sécurité de la conformité.

Lorsque la recherche web n’est pas disponible, Genie Code CLI peut toujours accéder à Internet en exécutant des commandes shell telles que curl.

Facturation et budgets​

Genie Code CLI est facturé de la même manière que Genie Code, en utilisant les tarifs à l’utilisation de Genie. Il partage l'utilisation mensuelle gratuite que chaque utilisateur reçoit pour les produits Genie. L'utilisation de Genie Code CLI est suivie via Unity Gateway.

Les budgets et les contrôles des coûts pour Genie Code CLI sont gérés avec d’autres produits Genie, et l’utilisation de Genie Code CLI est comptabilisée dans le même budget Genie. Voir Gérer les budgets et les contrôles des coûts pour Genie.

L’utilisation de CLI de Genie Code apparaît dans la table système system.billing.usage avec usage_metadata.genie.surface défini sur GENIE_CODE_CLI. Voir Surveiller et comprendre votre coût Genie.

Pour connaître les tarifs actuels et le montant d'utilisation gratuite, consultez la page des tarifs Databricks.

Questions fréquemment posées​

Quand dois-je utiliser Genie Code CLI au lieu de Unity Gateway avec mon propre agent de codage ?​

Utilisez un autre agent de codage via ug CLI, par exemple ug claude, si vous l'avez déjà configuré pour utiliser les compétences d’agent Databricks et les serveurs MCP gérés par Databricks, comme Genie One.

Utilisez Genie Code CLI si vous n’avez pas configuré cela, ou si vous souhaitez également bénéficier du réglage supplémentaire que Databricks applique au harness de l’agent afin qu’il fonctionne mieux avec Databricks.

En quoi Genie Code CLI diffère-t-elle des autres agents de codage ?​

Le CLI de Genie Code fonctionne comme les autres agents de codage de terminal, avec ces différences :

  • Préconfiguré pour Databricks : Il inclut des compétences Databricks, utilise Databricks CLI et Genie pour découvrir et query vos données, et est réglé avec des instructions pour le travail sur les données et l’IA. Vous ne les installez pas et ne les configurez pas vous-même.
  • Pas d'abonnement au modèle séparé : Genie Code CLI utilise les modèles fournis par Databricks, et l'utilisation est facturée sur votre compte Databricks de la même manière que Genie Code.
  • Les opérations de workspace sont régies par Databricks : Les opérations dans votre workspace Databricks s’exécutent sous votre identité Databricks, les autorisations Unity Catalog s’appliquent donc. Les opérations locales, telles que la modification de fichiers et l’exécution de commandes sur votre machine, ne sont pas régies par Databricks.

Pour utiliser un autre agent de codage avec Databricks, consultez start avec les agents de codage.

Quels systèmes d'exploitation sont pris en charge par le CLI Genie Code ?​

Genie Code CLI prend en charge macOS, Linux et Windows. Voir Installer et configurer.

Puis-je utiliser le CLI Genie Code dans mon IDE ?​

Oui. start Genie Code CLI à partir du terminal intégré de n’importe quel IDE, tel que Visual Studio Code, Cursor ou IntelliJ IDEA. La CLI de Genie Code fonctionne avec les fichiers du répertoire à partir duquel vous la start.

Comment reprendre une conversation précédente ?​

Chaque fois que vous exécutez genie, la CLI Genie Code démarre une nouvelle conversation. Pour reprendre une conversation précédente, utilisez l’une des options suivantes :

  • genie resume: Choisissez une conversation parmi une liste.
  • genie resume --last: Reprenez votre conversation la plus récente.
  • /resume: Choisissez une conversation dans une liste pendant que Genie Code CLI est en cours d’exécution.

Comment mettre à jour la CLI de Genie Code ?​

Le CLI de Genie Code vérifie la présence d'une nouvelle version lorsqu'il start et vous invite à effectuer la mise à jour. Pour effectuer la mise à jour manuellement, exécutez genie update ou exécutez à nouveau la commande d'installation pour votre système d'exploitation.

Comment les administrateurs gèrent-ils Genie Code CLI ?​

L'utilisation de la CLI Genie Code est suivie par Unity Gateway, et les administrateurs gèrent ses budgets avec d'autres produits Genie. Voir Gérer les budgets et les contrôles des coûts pour Genie.

Limitations​

  • Genie Code CLI ne prend en charge que l'authentification OAuth user-to-machine (U2M), en utilisant un profil CLI Databricks créé avec databricks auth login. L'authentification OAuth machine-to-machine (M2M) et les jetons d'accès personnels ne sont pas pris en charge.
  • Genie Code CLI ne prend pas en charge les sessions de tunnel SSH. Pour utiliser Genie Code CLI, exécutez-la sur votre machine locale.
  • Le CLI de Genie Code charge les compétences uniquement à partir des dossiers locaux. Il ne charge pas les compétences ou les instructions à partir de votre workspace ou de Unity Catalog.
  • Si vous connectez un serveur MCP sur Databricks avec un jeton d’accès, les appels MCP échouent avec une erreur 401 après l’expiration du jeton. Pour vous reconnecter, quittez la CLI Genie Code, définissez la variable d’environnement sur un nouveau jeton et exécutez genie.