Freigeben über

Erweitern Sie den Assistenten mit Agentenfähigkeiten

Erstellen Sie Fähigkeiten zum Erweitern des Databricks-Assistenten im Agentmodus mit speziellen Funktionen für Ihre domänenspezifischen Aufgaben. Auf dieser Seite wird erläutert, wie Sie Fähigkeiten erstellen und optimieren.

Was sind Fähigkeiten?

Erstellen Sie Fähigkeiten, um den Assistenten mit spezialisierten Fähigkeiten zu erweitern. Fähigkeiten folgen dem offenen Standard der Agentenfähigkeiten. Fähigkeiten bündeln domänenspezifisches Wissen und Arbeitsabläufe, die der Assistent laden kann, wenn sie relevant sind, um spezifische Aufgaben auszufü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 der Assistent basierend auf Ihrer Anfrage und der Beschreibung der Fähigkeiten automatisch Fähigkeiten, wenn sie relevant sind. Dadurch wird ein effizientes Kontextfenster beibehalten und die Notwendigkeit reduziert, denselben Kontext über mehrere Chats hinweg bereitzustellen.

Hinweis

Fähigkeiten werden nur im Agentmodus des Databricks-Assistenten unterstützt.

Erstellen einer Qualifikation

Fähigkeiten befinden sich im /Users/{username}/.assistant/skills/ Verzeichnis. Jede Fähigkeit muss über einen eigenen Ordner und eine SKILL.md Datei in diesem Ordner verfügen.

So erstellen Sie eine neue Fähigkeit:

  1. Erstellen Sie im Ordner "Benutzerarbeitsbereich" einen neuen Kompetenzordner. Der Ordnerpfad sollte folgendes sein: /Users/{username}/.assistant/skills/.

    Nach der Erstellung können Sie im Assistentenbereich schnell auf diesen Ordner 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. Wenn Sie z. B. eine Fähigkeit für persönliche Workflows erstellen, kann Ihre Ordnerstruktur folgendes sein:

    /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.

    Sie können beispielsweise über eine persönliche Workflow-Fähigkeit verfügen, die auf beste Praktiken, Dashboardvorlagen und Skripte für die Pipelineeinrichtung und -bereitstellung verweist. Ihr Qualifikationsordner könnte die folgenden Dateien enthalten:

    /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
         └── model-deploy.py     # Model deployment automation

Der Databricks-Assistent nimmt Ihre Fähigkeiten automatisch auf, wenn Sie es das nächste Mal im Agentmodus verwenden.

Bewährte Methoden

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

  • Halten Sie Fähigkeiten fokussiert. Fähigkeiten funktionieren am besten, wenn sie sich auf eine einzelne Aufgabe oder einen einzelnen Workflow konzentrieren. Schmaler Bereich erleichtert es dem Assistenten, zu erkennen, wann eine Fähigkeit gilt.
  • Verwenden Sie klare Namen und Beschreibungen. Ein präziser, beschreibender Name und eine Zusammenfassung helfen dem Assistenten, 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 der Assistent 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.
  • 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.
  • Last updated on