Aller au contenu principal
Dernière mise à jour le

Genie Code CLI

info

Bêta

Cette fonctionnalité est en version bêta. Il s'agit d'une version préliminaire, et ses fonctionnalités, commandes et interfaces changent fréquemment.

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.

Comme 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 pour votre compte. Il utilise la CLI Databricks, notamment les commandesdatabricks genie telles que databricks genie ask, pour découvrir des données et y répondre. Pendant la phase bêta, l'accès aux modèles est fourni et régi par Unity Gateway, de sorte que vous n'avez pas à apporter votre propre abonnement aux modèles.

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 ne l’avez pas configuré. Consultez Authentification pour la CLI Databricks. La CLI de Genie Code utilise ce profil pour accéder aux modèles via Unity Gateway. 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.

Facturation​

L’utilisation de Genie Code CLI est facturée de la même manière que l’utilisation directe du modèle via Unity Gateway, et apparaît dans votre utilisation d’Unity Gateway. Cela n’est pas facturé selon les tarifs de Genie.

Pour contrôler les dépenses, les administrateurs de Workspace peuvent définir des budgets pour Unity Gateway. Voir Gérer les budgets pour Unity Gateway.

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 de modèle séparé : L’accès aux modèles est fourni et gouverné via Unity Gateway, et l’utilisation est facturée sur votre compte Databricks.
  • 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 ?​

Les administrateurs gèrent Genie Code CLI via Unity Gateway, de la même manière que pour les autres agents de codage. L’utilisation de Genie Code CLI apparaît dans l’utilisation de Unity Gateway, et les budgets Unity Gateway s’appliquent à celle-ci. Voir Configurer les agents de codage et Gérer les budgets pour Unity Gateway.

Limitations​

  • La sélection des modèles est gérée par Databricks. Vous ne pouvez pas choisir de modèle spécifique. Pendant la version bêta, la CLI de Genie Code utilise GPT 5,6. La sélection peut différer des autres surfaces Genie et est susceptible d’évoluer au fil du temps.
  • Le CLI Genie Code n'est pas facturé dans le cadre de l'utilisation de Genie et n'est pas impacté par les budgets Genie. Pour contrôler les dépenses, définissez des budgets pour Unity Gateway. Voir Gérer les budgets pour Unity Gateway.
  • Genie Code CLI ne prend en charge que l'authentification OAuth machine à machine (M2M).
  • 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.
Sur cette page