Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Genie Code CLI ist ein Coding-Agent, der lokal in Ihrem Terminal läuft und auf Daten- und KI-Arbeit auf Azure Databricks optimiert ist. Es funktioniert wie andere Terminal-Coding-Agenten, ist aber vorkonfiguriert, um Azure Databricks zu verstehen und natürlich mit deinen Daten, Pipelines, Modellen und Anwendungen zu arbeiten.
Da es auf deinem Rechner läuft, kann die Genie Code CLI deine lokalen Dateien lesen und bearbeiten, Befehle ausführen und in deinem Namen auf Azure Databricks zugreifen. Es verwendet die Databricks-CLI, einschließlich der databricks genie Befehle wie databricks genie ask, um Daten zu entdecken und Fragen zu beantworten. Genie Code CLI verwendet Modelle, die Azure Databricks bereitstellt, sodass du kein eigenes Modellabonnement mitbringen musst. Sie verwalten den Zugang und die Budgets genauso wie bei Genie Code. Siehe Abrechnung und Budgets.
Anforderungen
- Ein Azure Databricks-Arbeitsbereich in einer Region, in der Genie Code CLI verfügbar ist, ist erforderlich. Modell- und Funktionsverfügbarkeit variiert je nach Region. Siehe regionale Verfügbarkeit.
- Partnergestützte KI-Features, die sowohl für das Konto als auch für den Arbeitsbereich aktiviert sind. Siehe partnergestützte KI-Features.
- Unity-Katalog für Ihren Arbeitsbereich aktiviert. Weitere Informationen finden Sie unter Aktivieren eines Arbeitsbereichs für Unity Catalog.
- Die separat installierte Databricks CLI in Version 1.0.0 oder höher. Die Genie Code CLI verwendet sie zur Authentifizierung und zum Ausführen der
databricks genieBefehle. Siehe Installieren oder Aktualisieren der Databricks CLI.
Die Genie Code CLI läuft unter deiner eigenen Identität, sodass sie nur auf Daten zugreifen und Operationen ausführen kann, die deine Azure Databricks-Berechtigungen erlauben.
Installation und Einrichtung
Installiere die Databricks CLI (Version 1.0.0 oder höher) separat, falls du das noch nicht getan hast. Siehe Installieren oder Aktualisieren der Databricks CLI.
Installiere Genie Code CLI mit dem Befehl für dein Betriebssystem.
Linux oder macOS
curl -fsSL https://github.com/databricks/genie-code-cli/releases/latest/download/install.sh | bashWindows
Führen Sie Folgendes in PowerShell aus:
powershell -ExecutionPolicy Bypass -c "irm https://github.com/databricks/genie-code-cli/releases/latest/download/install.ps1 | iex"Bestätigen Sie die Installation:
genie --versionWechsle in dein Projektverzeichnis und starte die Genie Code CLI:
cd my-project genieWenn du aufgefordert wirst, wähle ein Databricks-CLI-Profil aus oder authentifiziere dich, falls du noch keines konfiguriert hast. Weitere Informationen finden Sie unter Authentifizierung für die Databricks CLI. Genie Code CLI verwendet dieses Profil für den Modellzugriff und die Abrechnung. Es kann weiterhin andere Databricks-CLI-Profile verwenden, um mit anderen Arbeitsbereichen zu arbeiten oder ganz außerhalb von Azure Databricks zu arbeiten.
Bestätige, dass du dem Inhalt des Verzeichnisses vertraust, und beginne dann mit dem Prompting.
Was du mit Genie Code CLI machen kannst
Genie Code CLI kann direkt mit lokalen Dateien arbeiten, Ihre Unity-Catalog-Daten über Genie entdecken und abfragen sowie Azure Databricks-Assets aus einer einzigen Konversation im Terminal erstellen und bereitstellen. Beispiele:
- Erfassen und steuern: „Bereinige diese monatlichen Vertriebs-CSVs, lade sie in Unity Catalog, und zeige mir den Umsatz nach Region im Zeitverlauf.“
- Entdecken Sie Ihre Daten: "Welcher meiner Kataloge enthält Kundenfluktuationsdaten und was waren die wichtigsten Treiber im letzten Quartal?"
-
Eine Pipeline erweitern: "Füge meiner Bestellpipeline eine Silbertabelle
refundshinzu und fülle die letzten 90 Tage auf." - Ein Modell trainieren und bereitstellen: „Führen Sie dieses Trainingsskript auf Azure Databricks aus und setzen Sie das Modell hinter einen Serving-Endpunkt.“
-
Eine App erstellen und bereitstellen: „Einen lokalen App-Prototyp für meine
customers-Tabelle erstellen und als Azure Databricks-App bereitstellen.“
Wie sich die Genie Code CLI im Arbeitsbereich vom Genie Code unterscheidet
Genie Code CLI ist eine separate Erfahrung, die für lokale, terminalbasierte Arbeit entwickelt wurde. Es verfügt über eigene Tools, Skills und Anweisungen und teilt diese derzeit nicht mit Genie Code im Azure Databricks-Arbeitsbereich. Außerdem sind noch nicht alle Funktionen der Arbeitsbereich-Benutzeroberfläche enthalten.
Nutze Genie Code CLI als terminal-nativen Begleiter, wenn du lokal mit Dateien, Skripten und Prototypen arbeitest. Nutzen Sie weiterhin Genie Code im Arbeitsbereich für ein reichhaltigeres und vollwertiges Erlebnis.
Fertigkeiten einrichten und MCP-Server einrichten
Du kannst die Genie Code CLI mit Skills, MCP-Servern und Projektanleitungen erweitern. Wenn du bereits Claude Code oder Cursor verwendest, führe /import in der Genie Code CLI aus, um deine Konfiguration von ihnen zu importieren.
Hinzufügen von Fähigkeiten
Genie Code CLI ist bereits mit Azure Databricks Agenten-Fähigkeiten installiert, sodass der Agent effektiver mit Azure Databricks Daten und Ressourcen wie Jobs, Pipelines, Modellen und Apps arbeitet. Diese Fähigkeiten sind unter ~/.genie/skills/.system/ aufgeführt.
Um deinen eigenen Skill hinzuzufügen, erstelle einen Ordner, der eine SKILL.md Datei im Standardformat Agent Skills enthält, und speichere sie in ~/.genie/skills/. Um eine Fähigkeit mit deinem Team zu teilen, speichere sie .agents/skills/ stattdessen in deinem Repository. Genie Code CLI lädt auch Skills aus anderen lokalen Ordnern, wie zum Beispiel Elternordner Ihres Arbeitsverzeichnisses und der Wurzel Ihres Repositorys.
Du kannst auch die Genie Code CLI bitten, einen Skill zu erstellen oder einen bestehenden Skill von einem anderen Coding-Agent umzuwandeln.
Genie Code CLI lädt Skills nur aus lokalen Ordnern. Um eine Fähigkeit aus Ihrem Azure Databricks-Arbeitsbereich zu verwenden, wie zum Beispiel eine Fähigkeit in .assistant/skills/, laden Sie sie in einen dieser Ordner herunter.
MCP-Server verbinden
Verbinde die genie mcp add Genie Code CLI mit jedem MCP-Server, einschließlich MCP-Servern, die nicht auf Azure Databricks gehostet sind.
Um eine Verbindung zu einem entfernten MCP-Server herzustellen, geben Sie dessen URL und den Namen einer Umgebungsvariablen weiter, die ein Zugriffstoken für ihn enthält:
genie mcp add <server-name> --url <server-url> --bearer-token-env-var <env-var-name>
Um einen MCP-Server zu verbinden, der auf Ihrem Computer ausgeführt wird, übergeben Sie den Befehl, der ihn startet:
genie mcp add <server-name> -- <command> <args>
Um einen verwalteten MCP-Server auf Azure Databricks zu verbinden, wie zum Beispiel den Genie One MCP-Server:
Speichere ein Azure Databricks Access Token in einer Umgebungsvariable:
export DATABRICKS_MCP_TOKEN=$(databricks auth token --profile <profile-name> | jq -r .access_token)Füge den MCP-Server hinzu und gib den Namen der Umgebungsvariablen weiter. Wenn Ihre Workspace-URL eine Workspace-ID enthält, zum Beispiel
?o=<workspace-id>, fügen Sie sie am Ende der MCP-Server-URL hinzu.genie mcp add genie_one \ --url "https://<workspace-host>/ai-gateway/mcp-services/system.ai.genie_one_mcp" \ --bearer-token-env-var DATABRICKS_MCP_TOKENIm selben Terminal starten Sie die Genie Code CLI:
genieFühren Sie
/mcpaus, um zu bestätigen, dass der Server verbunden ist.
Projektanweisungen hinzufügen
Um Genie Code CLI-Anweisungen zu geben, die für jede Unterhaltung in einem Projekt gelten, wie Codierungskonventionen, Katalog- und Schemanamen oder wie man Tests durchführt, fügen Sie eine AGENTS.md Datei in die Wurzel Ihres Projektverzeichnisses ein. Genie Code CLI liest diese Datei, wenn du es in diesem Verzeichnis startest.
Regionale Verfügbarkeit
Genie Code CLI ist ein Designated Service. Die Verfügbarkeit hängt von der Region Ihres Arbeitsbereichs und von der Datenverarbeitung innerhalb des Arbeitsbereichs für bestimmte Dienste erzwingen-Einstellung ab. Cross-Geo-Verarbeitung ist standardmäßig für Arbeitsbereiche außerhalb der USA und EU aktiviert, die das Compliance-Sicherheitsprofil nicht aktiviert haben. Wenn Cross-Geo-Verarbeitung deaktiviert ist, ist die Genie Code CLI möglicherweise nicht in Ihrem Arbeitsbereich verfügbar. Für die Verfügbarkeit in jedem Geo siehe Verfügbarkeit der bezeichneten Dienste in jedem Geo.
Genie Code CLI ist in Regionen nicht verfügbar, in denen Genie Pay-as-you-go-Abrechnung nicht verfügbar ist: Azure West Central US und Qatar Central, AWS Asia Pacific (Jakarta) und Regierungsregionen.
Websuche
Websuche ist nicht verfügbar.
Wenn die Websuche nicht verfügbar ist, kann die Genie Code CLI dennoch auf das Internet zugreifen, indem Shell-Befehle wie curlausgeführt werden.
Abrechnung und Budgets
Genie Code CLI wird genauso abgerechnet wie Genie Code, mit dem Genie Pay-as-you-go-Preis. Sie nutzt das kostenlose monatliche Kontingent gemeinsam, das jeder Nutzer für Genie-Produkte erhält. Die Nutzung der Genie Code CLI wird über Unity Gateway verfolgt.
Budgets und Kostenkontrollen für Genie Code CLI werden zusammen mit anderen Genie-Produkten verwaltet, und die Nutzung der Genie Code CLI zählt zum gleichen Genie-Budget. Siehe Verwalten von Budgets und Kostenkontrollen für Genie.
Die Verwendung der Genie-Code-CLI erscheint in der system.billing.usage Systemtabelle mit usage_metadata.genie.surface gesetzt auf GENIE_CODE_CLI. Siehe Ihre Genie-Kosten überwachen und verstehen.
Aktuelle Preise und den kostenlosen Nutzungsbetrag finden Sie auf der Azure Databricks Preisseite.
Häufig gestellte Fragen
Wann sollte ich Genie Code CLI anstelle von Unity Gateway mit meinem eigenen Coding-Agenten verwenden?
Verwenden Sie einen anderen Coding-Agent über die ug CLI, z. B. ug claude, wenn Sie diesen Agent bereits so konfiguriert haben, dass er Azure Databricks-Agent-Fähigkeiten und Azure Databricks-verwaltete MCP-Server verwendet, wie z. B. Genie One.
Nutze Genie Code CLI, wenn du das nicht eingerichtet hast oder wenn du auch die zusätzliche Abstimmung möchtest, die Azure Databricks auf das Agenten-Harness anwendet, damit es besser mit Azure Databricks funktioniert.
Wie unterscheidet sich die Genie Code CLI von anderen Coding-Agenten?
Genie Code CLI funktioniert wie andere Terminalcoding-Agenten, mit folgenden Unterschieden:
- Vorkonfiguriert für Azure Databricks: Es enthält Azure Databricks-Skills, verwendet die Databricks-CLI und Genie, um Ihre Daten zu entdecken und abzufragen, und ist mit Anweisungen für Daten- und KI-Arbeit optimiert. Sie installieren oder konfigurieren diese nicht selbst.
- Kein separates Modellabonnement: Genie Code CLI verwendet Modelle, die Azure Databricks bereitstellt, und die Nutzung wird Ihrem Azure Databricks-Konto genauso berechnet wie Genie Code.
- Vorgänge im Arbeitsbereich unterliegen Azure Databricks: Vorgänge in Ihrem Azure Databricks-Arbeitsbereich werden mit Ihrer Azure Databricks-Identität ausgeführt, sodass die Unity Catalog-Berechtigungen gelten. Lokale Operationen, wie das Bearbeiten von Dateien und das Ausführen von Befehlen auf deinem Rechner, werden nicht von Azure Databricks gesteuert.
Informationen zur Verwendung eines anderen Coding-Agents mit Azure Databricks finden Sie unter Erste Schritte mit Coding-Agents.
Welche Betriebssysteme unterstützt Genie Code CLI?
Genie Code CLI unterstützt macOS, Linux und Windows. Siehe Installieren und Einrichten.
Kann ich Genie Code CLI in meiner IDE verwenden?
Ja. Starte die Genie Code CLI über das integrierte Terminal jeder IDE, wie z. B. Visual Studio Code, Cursor oder IntelliJ IDEA. Genie Code CLI funktioniert mit den Dateien im Verzeichnis, in dem du es startest.
Wie kann ich ein vorheriges Gespräch fortsetzen?
Jedes Mal, wenn Sie genie ausführen, beginnt die Genie Code CLI ein neues Gespräch. Um ein vorheriges Gespräch fortzusetzen, verwenden Sie eine der folgenden Optionen:
-
genie resume: Wähle ein Gespräch aus einer Liste. -
genie resume --last: Setzen Sie Ihre letzte Unterhaltung fort. -
/resume: Wähle ein Gespräch aus einer Liste, während Genie Code CLI läuft.
Wie aktualisiere ich die Genie Code CLI?
Genie Code CLI prüft beim Start, ob eine neue Version verfügbar ist, und fordert dich auf, ein Update zu machen. Führen Sie für eine manuelle Aktualisierung genie update aus, oder führen Sie den Installationsbefehl für Ihr Betriebssystem erneut aus.
Wie steuern Administratoren die Genie Code CLI?
Die Nutzung der Genie Code CLI wird über Unity Gateway verfolgt, und Administratoren verwalten dessen Budgets zusammen mit anderen Genie-Produkten. Siehe Verwalten von Budgets und Kostenkontrollen für Genie.
Limitations
- Genie Code CLI unterstützt nur die OAuth-Benutzer-zu-Maschine-Authentifizierung (U2M) unter Verwendung eines mit
databricks auth loginerstellten Databricks-CLI-Profils. OAuth Machine-to-Machine (M2M)-Authentifizierung und persönliche Zugriffstoken werden nicht unterstützt. - Genie Code CLI unterstützt keine SSH-Tunnelsitzungen . Um die Genie Code CLI zu verwenden, führe es auf deinem lokalen Rechner aus.
- Genie Code CLI lädt Skills nur aus lokalen Ordnern. Es lädt keine Skills oder Anweisungen aus deinem Arbeitsbereich oder aus dem Unity-Katalog.
- Wenn du einen MCP-Server auf Azure Databricks mit einem Zugriffstoken verbindest, schlagen MCP-Aufrufe nach Ablauf des Tokens mit einem
401Fehler fehl. Um die Verbindung wiederherzustellen, schließen Sie die Genie Code CLI, setzen Sie die Umgebungsvariable auf ein neues Token und führen Siegenieaus.