Genie Code CLI

Genie Code CLI is een codeeragent die lokaal in je terminal draait en is afgestemd op data- en AI-werk op Azure Databricks. Het werkt zoals andere terminal coding agents, maar is vooraf geconfigureerd om Azure Databricks te begrijpen en natuurlijk te werken met je data, pipelines, modellen en apps.

Omdat het op je machine draait, kan Genie Code CLI je lokale bestanden lezen en bewerken, commando's uitvoeren en namens jou toegang krijgen tot Azure Databricks. Het gebruikt de Databricks CLI, inclusief commando'sdatabricks genie zoals databricks genie ask, om data te ontdekken en vragen te beantwoorden. Genie Code CLI gebruikt modellen die Azure Databricks aanbiedt, dus je hoeft geen eigen modelabonnement mee te nemen. Je beheert toegang en budgetten op dezelfde manier als bij Genie Code. Zie Facturering en budgetten.

Requirements

Genie Code CLI draait onder jouw eigen identiteit, dus het kan alleen data benaderen en bewerkingen uitvoeren die je Azure Databricks-rechten toestaan.

Installeren en instellen

  1. Installeer de Databricks CLI (versie 1.0.0 of hoger) apart, als je dat nog niet hebt gedaan. Zie De Databricks CLI installeren of bijwerken.

  2. Installeer Genie Code CLI met het commando voor je besturingssysteem.

    Linux of macOS

    curl -fsSL https://github.com/databricks/genie-code-cli/releases/latest/download/install.sh | bash
    

    Windows

    Voer het volgende uit in PowerShell:

    powershell -ExecutionPolicy Bypass -c "irm https://github.com/databricks/genie-code-cli/releases/latest/download/install.ps1 | iex"
    
  3. Bevestig de installatie:

    genie --version
    
  4. Ga naar je projectmap en start Genie Code CLI:

    cd my-project
    genie
    
  5. Wanneer daarom wordt gevraagd, selecteer dan een Databricks CLI-profiel, of authenticeer je als je er nog geen hebt geconfigureerd. Zie Verificatie voor de Databricks CLI. Genie Code CLI gebruikt dit profiel voor modeltoegang en facturering. Het kan nog steeds andere Databricks CLI-profielen gebruiken om te werken met andere werkruimtes of helemaal buiten Azure Databricks te werken.

  6. Bevestig dat je de inhoud van de map vertrouwt en begin dan met vragen.

Wat je kunt doen met Genie Code CLI

Genie Code CLI kan direct werken met lokale bestanden, je Unity Catalog-data ontdekken en opvragen via Genie, en Azure Databricks-assets bouwen en uitrollen vanuit één terminalgesprek. Voorbeeld:

  • Innemen en beheren: "Maak deze maandelijkse verkoop-CSV's schoon, laad ze in Unity Catalog en laat me de omzet per regio in de loop van de tijd zien."
  • Bekijk uw gegevens: "Welke van mijn catalogi heeft klantverloopgegevens, en wat waren de belangrijkste drijfveren vorig kwartaal?"
  • Een pijplijn uitbreiden: "Voeg een zilveren refunds tabel toe aan mijn order-pijplijn en vul de laatste 90 dagen op."
  • Train en serveer een model: "Voer dit trainingsscript uit op Azure Databricks en plaats het model achter een serving endpoint."
  • Bouw en lever een app: "Bouw een lokaal appprototype voor mijn customers tabel en rol het uit als een Azure Databricks App."

Hoe Genie Code CLI verschilt van Genie Code in de werkruimte

Genie Code CLI is een aparte ervaring die is gebouwd voor lokaal, terminal-gebaseerd werk. Het heeft zijn eigen tools, vaardigheden en instructies, en deelt deze op dit moment niet met Genie Code in de Azure Databricks workspace. Het bevat ook nog niet alle mogelijkheden die beschikbaar zijn in de workspace-interface.

Gebruik Genie Code CLI als terminal-native companion wanneer je lokaal werkt met bestanden, scripts en prototypes. Blijf Genie Code gebruiken in de werkruimte voor een rijkere, volledig uitgeruste ervaring.

Vaardigheden opzetten en MCP-servers

Je kunt Genie Code CLI uitbreiden met vaardigheden, MCP-servers en projectinstructies. Als je al Claude Code of Cursor gebruikt, voer /import dan uit in Genie Code CLI om je configuratie daaruit te importeren.

Vaardigheden toevoegen

Genie Code CLI wordt al geleverd met Azure Databricks agentvaardigheden, dus de agent werkt effectiever met Azure Databricks data en middelen zoals jobs, pipelines, modellen en apps. Deze vaardigheden staan in ~/.genie/skills/.system/.

Om je eigen vaardigheid toe te voegen, maak je een map aan die een bestand SKILL.md bevat in het standaard Agent Skills-formaat en sla je deze op in ~/.genie/skills/. Om een vaardigheid met je team te delen, sla die in plaats daarvan op in je repository .agents/skills/. Genie Code CLI laadt ook vaardigheden uit andere lokale mappen, zoals oudermappen van je werkmap en de root van je repository.

Je kunt ook Genie Code CLI vragen om een skill te maken, of om een bestaande skill van een andere codeeragent om te zetten.

Genie Code CLI laadt skills alleen uit lokale mappen. Om een vaardigheid uit je Azure Databricks workspace te gebruiken, zoals een vaardigheid in .assistant/skills/, download je deze naar een van deze mappen.

Verbind MCP-servers

Gebruik genie mcp add om Genie Code CLI te verbinden met elke MCP-server, inclusief MCP-servers die niet op Azure Databricks worden gehost.

Om een externe MCP-server te verbinden, geef je de URL en de naam van een omgevingsvariabele door die een toegangstoken voor deze server bevat:

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

Om verbinding te maken met een MCP-server die op jouw machine draait, geef je het commando door waarmee deze wordt gestart:

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

Om een beheerde MCP-server te verbinden op Azure Databricks, zoals de Genie One MCP-server:

  1. Sla een Azure Databricks toegangstoken op in een omgevingsvariabele:

    export DATABRICKS_MCP_TOKEN=$(databricks auth token --profile <profile-name> | jq -r .access_token)
    
  2. Voeg de MCP-server toe en geef de naam van de omgevingsvariabele door. Als je workspace-URL een workspace-ID bevat, bijvoorbeeld ?o=<workspace-id>, voeg deze toe aan het einde van de MCP-server-URL.

    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. Start in dezelfde terminal Genie Code CLI:

    genie
    
  4. Voer /mcp uit om te bevestigen dat de server verbonden is.

Voeg projectinstructies toe

Om Genie Code CLI-instructies te geven die op elk gesprek in een project van toepassing zijn, zoals codeerconventies, catalogus- en schemanamen, of hoe je tests uitvoert, voeg je een AGENTS.md bestand toe aan de wortel van je projectmap. Genie Code CLI leest dit bestand wanneer je het in die map start.

Regionale beschikbaarheid

Genie Code CLI is een Designated Service. De beschikbaarheid hangt af van de regio van je werkruimte en van de instelling Enforce data processing within workspace Geography for Designated Services. Cross-Geo verwerking is standaard ingeschakeld voor werkruimtes buiten de VS en de EU die het compliance-beveiligingsprofiel niet hebben ingeschakeld. Als cross-Geo verwerking is uitgeschakeld, is Genie Code CLI mogelijk niet beschikbaar in je werkruimte. Voor beschikbaarheid in elke Geo, zie Beschikbaarheid van Aangewezen Diensten in elke Geo.

Genie Code CLI is niet beschikbaar in regio's waar Genie pay-as-you-go facturering niet beschikbaar is: Azure West Central US en Qatar Central, AWS Asia Pacific (Jakarta) en overheidsregio's.

Zoeken op het web is niet beschikbaar.

Wanneer webzoeken niet beschikbaar is, kan Genie Code CLI nog steeds toegang krijgen tot het internet door shell-commando's uit te voeren zoals curl.

Facturering en budgetten

Genie Code CLI wordt op dezelfde manier gefactureerd als Genie Code, met Genie-pay-as-you-go-prijzen. Het maakt gebruik van dezelfde gratis maandelijkse gebruikslimiet die elke gebruiker ontvangt voor Genie-producten. Het gebruik van Genie Code CLI wordt gevolgd via Unity Gateway.

Budgetten en kostencontroles voor Genie Code CLI worden samen met die voor andere Genie-producten beheerd, en het gebruik van Genie Code CLI telt mee voor hetzelfde Genie-budget. Zie Budgetten en kostenbeheer beheren voor Genie.

Genie Code CLI-gebruik verschijnt in de system.billing.usage systeemtabel met usage_metadata.genie.surface gezet op GENIE_CODE_CLI. Bekijk Monitor en begrijp je Genie-kosten.

Zie de pagina Azure Databricks prijzen voor huidige prijzen en het gratis gebruiksbedrag.

Veelgestelde vragen

Wanneer moet ik Genie Code CLI gebruiken in plaats van Unity Gateway met mijn eigen codeeragent?

Gebruik bijvoorbeeld een andere coding agent via de ug CLI, ug claude als je die agent al hebt geconfigureerd om Azure Databricks agent skills en Azure Databricks managed MCP-servers te gebruiken, zoals Genie One.

Gebruik Genie Code CLI als je dit niet hebt ingesteld, of als je ook de extra afstemming wilt die Azure Databricks toepast op de agent harness zodat het beter werkt met Azure Databricks.

Hoe verschilt Genie Code CLI van andere codeeragenten?

Genie Code CLI werkt zoals andere terminalcoderingsagenten, met de volgende verschillen:

  • Vooraf geconfigureerd voor Azure Databricks: Het bevat Azure Databricks-vaardigheden, gebruikt de Databricks CLI en Genie om je data te ontdekken en op te vragen, en is afgestemd met instructies voor data- en AI-werk. Je installeert of configureert deze niet zelf.
  • Geen apart modelabonnement: Genie Code CLI gebruikt modellen die Azure Databricks aanbiedt, en het gebruik wordt op dezelfde manier gefactureerd aan je Azure Databricks-account als aan Genie Code.
  • Workspace-operaties worden beheerd door Azure Databricks: Operaties in je Azure Databricks-werkruimte draaien onder je Azure Databricks-identiteit, dus Unity Catalog-rechten zijn van toepassing. Lokale bewerkingen, zoals het bewerken van bestanden en het uitvoeren van commando's op je computer, worden niet beheerd door Azure Databricks.

Om in plaats daarvan een andere codeeragent met Azure Databricks te gebruiken, zie Begin met codeeragenten.

Welke besturingssystemen ondersteunt Genie Code CLI?

Genie Code CLI ondersteunt macOS, Linux en Windows. Zie Installeren en opzetten.

Kan ik Genie Code CLI gebruiken in mijn IDE?

Yes. Start Genie Code CLI vanaf de geïntegreerde terminal van elke IDE, zoals Visual Studio Code, Cursor of IntelliJ IDEA. Genie Code CLI werkt met de bestanden in de map waar je het start.

Hoe hervat ik een eerder gesprek?

Elke keer dat je genie uitvoert, start Genie Code CLI een nieuw gesprek. Om een eerder gesprek te hervatten, gebruik een van de volgende opties:

  • genie resume: Kies een gesprek uit een lijst.
  • genie resume --last: Ga verder met je meest recente gesprek.
  • /resume: Kies een gesprek uit een lijst terwijl Genie Code CLI draait.

Hoe werk ik de Genie Code CLI bij?

Genie Code CLI controleert op een nieuwe versie wanneer deze start en vraagt je om te updaten. Om handmatig te updaten, voer genie update uit, of voer het installatiecommando voor je besturingssysteem opnieuw uit.

Hoe beheren beheerders de Genie Code CLI?

Het gebruik van Genie Code CLI wordt bijgehouden via Unity Gateway, en beheerders beheren de budgetten samen met die van andere Genie-producten. Zie Budgetten en kostenbeheer beheren voor Genie.

Limitations

  • Genie Code CLI ondersteunt alleen OAuth user-to-machine (U2M) authenticatie, met behulp van een Databricks CLI-profiel dat is gemaakt met databricks auth login. OAuth machine-to-machine (M2M) authenticatie en persoonlijke toegangstokens worden niet ondersteund.
  • Genie Code CLI ondersteunt geen SSH-tunnelsessies . Om Genie Code CLI te gebruiken, voer je het uit op je lokale machine.
  • Genie Code CLI laadt skills alleen uit lokale mappen. Het laadt geen vaardigheden of instructies uit je werkruimte of uit de Unity Catalog.
  • Als je verbinding maakt met een MCP-server op Azure Databricks met een toegangstoken, falen MCP-aanroepen met een 401 foutmelding nadat het token verloopt. Om opnieuw verbinding te maken, sluit je de Genie Code CLI af, stel je de omgevingsvariabele in op een nieuw token en voer genie uit.