Verwalten und löschen Sie Fähigkeiten in einem Agenten

Nachdem Sie Skills zu Ihrem Agenten hinzugefügt haben, können Sie sie in der Registerkarte Build bearbeiten, herunterladen, ersetzen und löschen. Die geordnete und aktuelle Verwaltung der Fertigkeiten Ihres Agenten sorgt für das beste Nutzererlebnis.

Note

Funktionen in diesem Artikel werden von Agenten oder Workflows genutzt, die vom GitHub Copilot-Harness betrieben werden.

Nutzungsbasierte Abrechnung gilt für die Nutzung, den Bau, das Testen und die Bewertung von Agenten. Diese Aktionen könnten Copilot-Credits verbrauchen. Erfahren Sie mehr unter Kosten verwalten für Agenten, die vom GitHub Copilot-Harness betrieben werden.

Die Skills Ihres Agent anzeigen

  1. Öffnen Sie Ihren Agenten in Copilot Studio.

  2. Wählen Sie die Registerkarte Erstellen aus.

  3. Im Komponenten-Bereich zeigt der Bereich Fertigkeiten die Fertigkeiten, die Sie Ihrem Agenten hinzugefügt haben.

Bearbeiten Sie einen Skill, den Sie von Grund auf erstellt haben

Sie können Skills, die Sie von Grund auf erstellen, direkt im Fertigkeitskonfigurations-Bereich bearbeiten.

  1. Wählen Sie die Fertigkeit aus, die Sie bearbeiten möchten, um den „Fertigkeits“-Konfigurationsbereich zu öffnen.

  2. Aktualisieren Sie beliebige der folgenden Elemente:

    • Name: Kennung der Fertigkeit. Verwenden Sie nur Kleinbuchstaben, Zahlen und Bindestriche. Beginnen oder beenden Sie den Namen nicht mit einem Bindestrich.
    • Beschreibung: Was die Fertigkeit tut und wann sie aktiviert werden soll.
    • Anweisungen: Die Markdown-Anweisungen, die das Verhalten des Agenten leiten.

  3. Wählen Sie "Speichern" aus, um Ihre Änderungen anzuwenden.

Tip

Nachdem Sie einen Skill bearbeitet haben, testen Sie Ihren Agenten auf der Registerkarte Preview, um zu überprüfen, ob die Änderungen wie erwartet funktionieren.

Herunterladen einer Fähigkeit

Sie können eine Fertigkeit herunterladen, um sie mit anderen zu teilen oder zu sichern.

  1. Wählen Sie die Fertigkeit aus, die Sie herunterladen möchten, um den Konfigurations-Bereich zu öffnen.

  2. Je nach Fertigkeit:

    • Wenn Sie die Fertigkeit von Grund auf neu erstellt haben, wählen Sie das Download-Symbol aus.

    • Wenn Sie die Fertigkeit hochgeladen haben, wählen Sie die drei Punkte (...) und dann Herunterladen.

Die Fertigkeit wird als Markdown-Datei heruntergeladen, die den Fertigkeit-Namen und die Fertigkeit-Beschreibung im „YAML Front Matter“ sowie Anweisungen enthält. Der Dateiname entspricht dem Namen der Fertigkeit.

Eine hochgeladene Fertigkeit ersetzen

Nachdem Sie die Anweisungen für eine bestehende Fertigkeit in Ihrem bevorzugten Texteditor bearbeitet haben, laden Sie Ihre Änderungen hoch, indem Sie die aktuelle Version der Fertigkeit in Ihrem Agenten ersetzen. Es ist auch möglich, eine Fertigkeit durch eine andere Fertigkeit zu ersetzen.

  1. Wählen Sie die Fertigkeit aus, die Sie ersetzen möchten, um den „Fertigkeit“-Konfigurationsbereich zu öffnen.

  2. Markieren Sie die drei Punkte (...) und wählen Sie dann Ersetzen.

  3. Navigieren Sie zu der gewünschten Fertigkeits-Datei und laden Sie diese hoch.

Löschen einer Fähigkeit

  1. Wählen Sie im Komponenten-Bereich das X-Symbol neben der Fertigkeit aus, die Sie löschen möchten. In einer Meldung werden Sie aufgefordert, Ihre Absicht zu bestätigen.

  2. Klicken Sie auf Löschen, um den Löschvorgang zu bestätigen.

Note

Das Löschen einer Fertigkeit entfernt sie dauerhaft von diesem Agenten. Wenn Sie die Fertigkeit später benötigen, laden Sie sie zuerst herunter.

Beheben Sie Probleme mit Skills, die nicht geladen werden

Wenn eine von dir hinzugefügte Fähigkeit nach dem Speichern nicht im Komponentenpanel erscheint oder der Agent sich so verhält, als wäre die Skill nicht installiert, hat die Skill wahrscheinlich eine Ladezeitprüfung nicht bestanden. Copilot Studio lädt trotzdem den Rest deines Agenten, wenn das passiert, aber die betroffene Fähigkeit wird übersprungen.

Die häufigsten Gründe, warum eine Fähigkeit übersprungen wird, und die Korrektur für jede Fähigkeit:

Grund Was dies bedeutet So beheben Sie es
Ungültige YAML-Frontmaterie Der ----Block oben in SKILL.md ist kein gültiges YAML. Setzen Sie Zeichenfolgenwerte, die einen Doppelpunkt oder ein anderes YAML-Sonderzeichen enthalten (zum Beispiel description: "My: skill"), in Anführungszeichen. Überprüfen Sie, dass die Frontmaterie eine Abbildung von key: value Paaren ist.
Fehlend name Das Frontmatter hat keinen nicht leeren name:-Wert. Füge name: <skill-name> zum Frontmatter hinzu.
Fehlend description Das Frontmatter enthält keinen nicht leeren description:-Wert. Füge description: <one-line summary> zum Frontmatter hinzu.
Beschreibung zu lang Der effektive description Wert ist länger, als der modellbezogene Katalog zulässt. Verkürze die Beschreibung auf eine einzige Zeile, die den Zweck der Fertigkeit zusammenfasst.
Duplikater Fähigkeitsname Zwei Skills im selben Agenten verwenden denselben Ordnernamen. Benenne eine der Fähigkeiten um, sodass jede einen einzigartigen Namen hat.
Unlesbar SKILL.md Die Datei SKILL.md konnte nicht gelesen werden, meist wegen einer Nicht-UTF-8-Dateikodierung. Speichere SKILL.md als UTF-8 ohne Byte-Order-Markierung und lade dann die Skill erneut hoch.
Die Ressourcendatei wurde nicht geschrieben Eine oder mehrere unterstützende Dateien im Skill-Paket konnten nicht geschrieben werden. Exportiere das Skill-Paket erneut, prüfe, ob jede Datei vorhanden und lesbar ist, und lade dann erneut hoch.
Fertigkeitspaket abgelehnt Das Skill-Paket ist bei einer strukturellen Validierungsprüfung während der Installation durchgefallen. Exportiere das Paket erneut aus einem funktionierenden Editor und versuche es erneut. Wenn sich das Problem mit einem früheren Paket wiederholt, kontaktiere deinen Administrator.

Fähigkeiten, deren unterstützende Dateien teilweise geschrieben wurden, laden weiterhin, aber der Agent kann sich zur Laufzeit anders verhalten, weil einige der referenzierten Inhalte fehlen. Laden Sie das Paket erneut hoch, um den vollständigen Dateisatz wiederherzustellen.

  • Last updated on