Erweitern von Genie Code mit Agentenfähigkeiten

Genie Code wird mit integrierten Fähigkeiten für allgemeine Azure Databricks Workflows ausgeliefert: Schreiben von Code in Notizbüchern, Erkunden von Daten im Unity-Katalog, Erstellen von Dashboards, Erstellen von Pipelines und Arbeiten mit MLflow. Erstellen Sie benutzerdefinierte Fähigkeiten, um den Genie Code Agent-Modus mit speziellen Funktionen für die domänenspezifischen Aufgaben Ihres Teams zu erweitern. Auf dieser Seite wird erläutert, wie Sie sie erstellen und optimieren.

Was sind Fähigkeiten?

Erstellen Sie Fähigkeiten, um Genie Code mit spezialisierten Fähigkeiten zu erweitern. Fähigkeiten folgen dem offenen Standard der Agentenfähigkeiten. Fähigkeitenpakete bündeln domänenspezifisches Wissen und Arbeitsabläufe, die der Genie-Code bei Bedarf laden kann, um spezifische Aufgaben durchzuführen. Fähigkeiten können Anleitungen, bewährte Methoden, wiederverwendbaren Code und ausführbare Skripts umfassen.

Fähigkeiten sollten auf domänenspezifische Aufgaben zugeschnitten sein. Mit Fähigkeiten können Sie einen größeren Kontext (z. B. Skripts, Beispiele und andere Ressourcen) für einen Vorgang bereitstellen, als Sie mit Anweisungen arbeiten können. Im Gegensatz zu benutzerdefinierten Anweisungen, die global angewendet werden, werden Fähigkeiten automatisch und nur im relevanten Kontext geladen. Im Agent-Modus lädt Genie Code basierend auf Ihrer Anfrage und der Beschreibung der Fähigkeiten automatisch Fähigkeiten, wenn sie relevant sind. Sie können die Fähigkeiten auch manuell aufrufen, indem @ Sie sie erwähnen. Dadurch wird ein effizientes Kontextfenster beibehalten und die Notwendigkeit reduziert, denselben Kontext über mehrere Chats hinweg bereitzustellen.

Es gibt zwei Arten von Fähigkeiten:

  • Arbeitsbereichskompetenzen: Für jeden im Arbeitsbereich verfügbar. Arbeitsbereichsadministratoren können Arbeitsbereichskenntnisse erstellen und anderen Personen Zugriff auf den Kompetenzordner gewähren, um mehr hinzuzufügen. Verwenden Sie Arbeitsbereichskenntnisse, um organisationsweite Standards zu erzwingen, eine konsistente Ausgabe für Benutzer bereitzustellen (z. B. eine PII-Handhabungskompetenz, die vertrauliche Spalten maskiert), oder verschiedene Teams bedienen (z. B. Pipelinevorlagen für Dateningenieure und Modellschulungs-Playbooks für ML-Plattformbenutzer).
  • Benutzerkenntnisse: Nur für Sie verfügbar. Verwenden Sie Benutzerkenntnisse für persönliche Einstellungen wie bevorzugte Bibliotheken, Codierungsstil oder Rollen- und Hintergrundkontext. Benutzerkenntnisse sind auch nützlich für die Prototyperstellung einer Fähigkeit, bevor sie auf Arbeitsbereichsebene gefördert wird.

Hinweis

Fähigkeiten werden nur im Genie Code Agent-Modus unterstützt.

Erstellen einer Qualifikation

Fähigkeiten befinden sich in einem .assistant/skills/ Verzeichnis. Jede Fähigkeit muss über einen eigenen Ordner und eine SKILL.md Datei in diesem Ordner verfügen. Der Standort hängt vom Qualifikationstyp ab:

  • Arbeitsbereichsfertigkeiten: Workspace/.assistant/skills/
  • Benutzerkenntnisse: /Users/{username}/.assistant/skills/

So erstellen Sie eine neue Fähigkeit:

  1. Erstellen Sie einen neuen Kompetenzordner auf dem entsprechenden Weg für Ihren Qualifikationstyp.

    Nach der Erstellung können Sie schnell auf Ihren Kompetenzordner im Genie Code Panel zugreifen. Klicken Sie auf das Zahnradsymbol für Einstellungen. Klicken Sie dann auf den Pfeil im Symbol, um den Ordner "Fähigkeiten" zu öffnen.

  2. Erstellen Sie einen dedizierten Ordner für Ihre Fähigkeiten im Kompetenzordner. Jede Fähigkeit muss über einen eigenen Ordner verfügen. Beispiel:

    Workspace/.assistant/skills/
└── ml-workflows/
    └── SKILL.md

/Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. Erstellen Sie in Ihrem Skill-Ordner eine SKILL.md-Datei. Diese Datei ist erforderlich und definiert die Fähigkeit. Fähigkeiten folgen den Spezifikationen von Agent Skills.

  4. Fügen Sie den erforderlichen Frontmatter für Ihre Fähigkeiten hinzu:

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. Fügen Sie die Qualifikationsanweisungen im Markdown-Format nach dem Frontmatter hinzu. Es wird empfohlen, die folgenden Abschnitte einzuschließen:

    • Schrittweise Anleitungen: Klare Verfahrensanleitungen
    • Beispiele: Beispieleingaben und erwartete Ausgaben
    • Randfälle: Häufige Variationen und Ausnahmen

  6. (Optional) Für komplexe Fähigkeiten können Sie zusätzliche Ressourcen bereitstellen und darauf verweisen.

    • Skripts, die ausführbaren Code enthalten, den der Agent ausführen kann.
    • Dateien, die zusätzliche Dokumentation enthalten, auf die verwiesen werden soll, z. B. bewährte Methoden und Vorlagen.

    Wenn Sie auf andere Dateien verweisen, verwenden Sie relative Pfade aus der Stammkompetenz.

    Beispielsweise könnte eine maschinelle Lern-Workflow-Fähigkeit im Arbeitsbereich und eine persönliche Workflow-Fähigkeit die folgende Struktur haben:

    Workspace/.assistant/skills/
├── ml-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── training-patterns.md    # Standard ML training patterns
   └── scripts/
         └── model-deploy.py   # Model deployment automation

/Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         └── pipeline-setup.sh   # Environment setup scripts

Genie Code nimmt Ihre Fähigkeiten automatisch auf, wenn Sie es das nächste Mal im Agent-Modus verwenden. Sie können auch @ Fähigkeiten erwähnen, um sicherzustellen, dass Genie Code sie verwendet.

Wenn Sie eine vorhandene Fähigkeit bearbeiten, beginnen Sie einen neuen Chatthread, um Ihre Änderungen anzuwenden. Bearbeitungen werden in aktiven Threads nicht wirksam. Wenn ein Skill immer noch veraltet erscheint, etwa indem er altes Verhalten oder eine veraltete Beschreibung anzeigt, laden Sie die Browser-Registerkarte mit einem Hard-Refresh neu, um zwischengespeicherte Skill-Metadaten zu löschen.

Bewährte Methoden

Befolgen Sie die folgenden Richtlinien, um effektive Fähigkeiten zu schreiben:

  • Wählen Sie den geeigneten Qualifikationstyp aus. Verwenden Sie Arbeitsbereichskenntnisse, um gemeinsame Standards zu codieren (z. B. PII-Handhabung, Benennungskonventionen oder teamspezifische Vorlagen), damit jeder Benutzer eine konsistente Ausgabe erhält. Verwenden Sie Benutzerkenntnisse für persönliche Vorlieben und prototypieren Sie eine Fähigkeit, bevor Sie sie für den Arbeitsbereich bewerben.
  • Halten Sie Fähigkeiten fokussiert. Fähigkeiten funktionieren am besten, wenn sie sich auf eine einzelne Aufgabe oder einen einzelnen Workflow konzentrieren. Ein eingegrenzter Anwendungsbereich erleichtert Genie Code die Erkennung, wenn eine Fähigkeit zutrifft.
  • Verwenden Sie klare Namen und Beschreibungen. Ein präziser, beschreibender Name und eine Zusammenfassung helfen Genie Code dabei, die richtige Fähigkeit zur richtigen Anforderung zu finden.
  • Seien Sie explizit und beispielgesteuert. Beschreiben Sie Workflows schritt für Schritt, und fügen Sie konkrete Beispiele oder Muster ein, die Genie Code wiederverwenden kann.
  • Vermeiden Sie unnötigen Kontext. Geben Sie nur Informationen an, die für den Vorgang erforderlich sind. Zusätzliche Details können es erschweren, Fähigkeiten zuverlässig anzuwenden.
  • Über die Zeit iterieren. Behandeln Sie Fähigkeiten als lebendige Workflows. Kleine Updates, die auf der realen Nutzung basieren, können die Ergebnisse erheblich verbessern.
  • Autorfähigkeiten mit Genie Code. Verwenden Sie Genie Code, um Fähigkeiten zu entwerfen und zu verfeinern. Testen Sie neue oder aktualisierte Fähigkeiten für repräsentative Aufgaben, um zu finden, wo der Agent kämpft, und aktualisieren Sie dann die Anweisungen, um diese Lücken zu schließen.
  • Trennen Sie Anleitungen von der Automatisierung. Verwenden Sie Markdown, um Absichten und bewährte Methoden und Skripts für wiederholbare Aktionen zu erläutern. Das Unterscheiden dieser Bedenken erleichtert das Verwalten und Wiederverwenden von Kenntnissen.
  • Verwalteten Sie Ihre Fähigkeiten mit Versionskontrolle. Sichern Sie Ihren Fähigkeitenordner mit Git-Ordnern von Databricks, um Änderungen nachzuverfolgen, mit Teamkollegen zusammenzuarbeiten und bei Bedarf ein Rollback auszuführen.

Siehe auch

  • Last updated on