Fähigkeiten

Skills sind wiederverwendbare Anweisungsbündel für LibreChat Agents. Eine Skill basiert auf einer SKILL.md-Datei: Das Frontmatter beschreibt, wann die Skill verwendet werden soll, und der Markdown-Textinhalt gibt dem Agenten die Vorgehensweise, Regeln, Beispiele oder Referenzen an die Hand, denen er folgen soll.

Skills sind nützlich für wiederholbare Aufgaben wie:

• Anwenden von Marken- oder Schreibrichtlinien
• Befolgen der internen Prüflisten
• Ausführen eines Standard-Research-Workflows
• Vorbereiten eines spezialisierten Tool-Workflows
• Verpacken von wiederverwendbaren Skripten, Referenzen und Assets mit einer Anweisungsdatei

Skills aktivieren

Die skills Agenten-Funktion ist standardmäßig aktiviert. Administratoren können sie aus der Liste der Fähigkeiten des agents Endpunkts entfernen, um Skills vor Benutzern zu verbergen.

endpoints:
  agents:
    capabilities:
      - 'deferred_tools'
      - 'execute_code'
      - 'file_search'
      - 'web_search'
      - 'artifacts'
      - 'subagents'
      - 'actions'
      - 'context'
      - 'skills'
      - 'tools'
      - 'chain'
      - 'ocr'

Rollenberechtigungen steuern außerdem, wer Skills verwenden, erstellen, teilen und öffentlich teilen darf.

Bereitstellungsfähigkeiten

Admins können schreibgeschützte Skills über das Dateisystem mit DEPLOYMENT_SKILLS_DIR bereitstellen.

DEPLOYMENT_SKILLS_DIR=./skill

Das Verzeichnis ist standardmäßig auf ./skill im Projektstammverzeichnis eingestellt. LibreChat lädt Deployment-Skills beim Start und stellt sie Benutzern zur Verfügung, bei denen die Skills-Funktion aktiviert ist.

Bereitstellungsfähigkeiten:

• Sind in der UI schreibgeschützt
• Verwenden Sie deployment als deren Quelle
• Haben Vorrang vor gespeicherten Skills mit demselben Namen
• Ein Neustart von LibreChat ist erforderlich, nachdem Dateien hinzugefügt, entfernt oder geändert wurden

GitHub Skill Sync

Admins können Skills aus GitHub-Repositories mit skillSync.github in librechat.yaml spiegeln.

skillSync:
  github:
    enabled: true
    intervalMinutes: 60
    runOnStartup: true
    sources:
      - id: librechat-skills
        owner: your-org
        repo: your-skills-repo
        ref: main
        paths:
          - skills
        skillDiscoveryDepth: 2
        token: '${GITHUB_SKILLS_TOKEN}'

GitHub Skill Sync:

• Durchsucht konfigurierte Repository-Pfade nach SKILL.md
• Importiert gebündelte Dateien neben jeder Skill
• Speichert gespiegelte Skills mit source: "github"
• Aktualisiert gespiegelte Skills, wenn sich das Upstream-Repository ändert
• Entfernt gespiegelte Skills, die in der konfigurierten Quelle nicht mehr existieren
• Unterstützt geplante, beim Start ausgeführte und manuell durch Administratoren ausgelöste Durchläufe

Verwenden Sie ein fein abgestimmtes GitHub Personal Access Token mit schreibgeschützten Berechtigungen für Contents und Metadata für das ausgewählte Repository. Siehe Skill Sync Object Structure für alle Felder, Anmeldeoptionen, Tenant-Scoping und Admin-Sync-Endpunkte.

Eine Skill erstellen

Öffnen Sie Skills über das Seitenpanel. Sie können einen Skill direkt in LibreChat schreiben oder eine .md-, .zip- oder .skill-Datei hochladen, die eine SKILL.md enthält.

Minimales SKILL.md:

---
name: brand-guidelines
description: Use when writing public-facing content that must follow the company voice and terminology.
---
 
# Brand Guidelines
 
Write in a concise, practical tone.
Prefer active voice.
Use product terminology consistently.

Frontmatter

Aufrufmodi

Skills können einen Agenten auf drei Arten erreichen:

• Manuell: Der Benutzer gibt $ im Chat ein und wählt eine Fähigkeit aus dem Popover aus.
• Model-invoked: das Modell wählt eine Fähigkeit aus dem injizierten Fähigkeitskatalog aus und ruft das Skill-Tool auf.
• Always apply: die Fähigkeit wird bei Aktivierung in jede Interaktion eingebunden.

Die manuelle Aufrufung ist eine explizite Benutzerabsicht. Sie kann Skills verwenden, die für die Modellaufrufung mit disable-model-invocation: true verborgen sind, sofern user-invocable nicht auf false gesetzt ist.

Agent-Geltungsbereich

Agents müssen über aktivierte Skills verfügen, bevor sie den Katalog nutzen können.

• Wenn skills_enabled bei einem gespeicherten Agenten auf false gesetzt oder nicht definiert ist, sind die Skills für diesen Agenten inaktiv.
• Wenn skills_enabled auf true gesetzt ist und keine Skill-Allowlist festgelegt wurde, kann der Agent den gesamten aktiven Katalog verwenden, der für den Benutzer sichtbar ist.
• Wenn skills_enabled auf true gesetzt ist und skills spezifische Skill-IDs enthält, wird der Agent auf diese Liste eingeschränkt.

Dies ermöglicht es Administratoren, die Skills-Funktion global bereitzustellen und gleichzeitig das nutzbare Skill-Set jedes Agenten fokussiert zu halten.

Aktive und geteilte Skills

Benutzer können Skills aktivieren oder deaktivieren. Eigene Skills sind standardmäßig aktiv. Geteilte Skills verwenden die vom Administrator konfigurierte Standardeinstellung, bis der Benutzer diese überschreibt.

Inaktive Skills sind ausgeschlossen von:

• Das $-Popover
• Der vom Modell aufgerufene Skill-Katalog
• Immer anwendendes Priming

Gebündelte Dateien

Hochgeladene Skill-Bundles können neben der SKILL.md weitere Dateien enthalten, wie zum Beispiel:

• references/...
• scripts/...
• assets/...

Das Backend speichert diese Dateien zusammen mit dem Skill. Der Agent kann Skill-Dateien auflösen, wenn der Skill aktiv und im Gültigkeitsbereich ist.