Fähigkeiten in deklarativen Agenten

In diesem Artikel werden die Fähigkeiten behandelt, die mit einem deklarativen Agenten verbunden sind. Wenn Sie einen Skill direkt zur Verwendung in Microsoft 365 Copilot Chat erstellen möchten, ohne einen Agent erstellen zu müssen, lesen Sie Build Skills for Copilot Chat. Die Supportmatrix in diesem Artikel gilt für Agent-bezogene Skills, nicht für alle Skills oder Plug-In-Pakete.

Wichtig

In Mandanten, die Microsoft Purview-Informationsbarrieren (IB) verwenden, können Administratoren deklarative Agents mit Qualifikationen bereitstellen, aber Endbenutzer können von ihnen erstellte deklarative Agents keine Qualifikationen hinzufügen.

Ein Skill ist eine modulare Funktion, die Sie einem deklarativen Agent hinzufügen, damit er eine bestimmte Aufgabe zuverlässiger und wiederholbarer ausführen kann. Ein Skill ist ein Dateiverzeichnis, das eine erforderliche SKILL.md Datei sowie optionale Ressourcendateien und Skripts enthält. Die SKILL.md Datei enthält die Anweisungen, die das Modell anweisen, die Aufgabe abzuschließen.

Fähigkeiten sind eine eigenständige Komponente eines deklarativen Agents. In früheren Anleitungen bezog sich das Wort "Fähigkeiten " auf Aufgabenbeschreibungen, die Sie inline in den Anweisungen eines Agenten verfassten. Skills ersetzen diesen Ansatz: Anstatt Aufgabendetails direkt in die Anweisungen zu schreiben, verpacken Sie sie als separate Komponente, auf die der Agent verweist. Eine Anleitung dazu, wie Anweisungen auf Fertigkeiten verweisen sollten, finden Sie unter Schreiben effektiver Anweisungen für deklarative Agents.

Sie können einem deklarativen Agent mithilfe des Agent-Generators Fähigkeiten hinzufügen. Für unterstützte Pro-Code-Szenarien wird Work IQ Dev Tools empfohlen. Für wiqd agent add skill die Route ist das agent-skills Featureflag erforderlich, das standardmäßig deaktiviert ist. Weitere Informationen finden Sie unter Auswählen des Pfads für die Skillimplementierung. Die Toolkit-basierte exemplarische Vorgehensweise bleibt für vorhandene Toolkit-Projekte verfügbar.

Was ist ein Skill

Ein Skill ist ein Verzeichnis mit dem folgenden Inhalt:

  • Eine erforderliche SKILL.md Datei, die Folgendes enthält:
    • Ein Skill-Name und eine Beschreibung in der YAML-Titelseite.
    • Fertigkeitsanweisungen, die weniger als 20.000 Zeichen umfassen müssen.
  • Optionale Ressourcendateien, z. B. Vorlagen, Referenzdaten oder Definitionen.
  • Optionale Skripts und unterstützende Ordner.

Beispielsweise kann ein Finanzteam einen vierteljährlichen Geschäftsberichtsskill erstellen, der die Anweisungen für die Erstellung des Berichts, Skripte zum Transformieren von Daten und Generieren von Diagrammen sowie Ressourcen wie Finanzmodelle, KPI-Definitionen und Markenfolienvorlagen bündelt. Der Agent verwendet den Skill, wenn ein Benutzer nach dieser Aufgabe fragt.

Gründe für die Verwendung von Skills in deklarativen Agents

Fähigkeiten helfen Ihnen, zuverlässigere, wiederholbare Agent-Workflows zu erstellen:

  • Optimierte Kontextverwendung und verbesserte Genauigkeit. Skills verwenden progressive Offenlegung: Das Modell lädt die Anweisungen und Inhalte eines Skills nur dann in einen Kontext, wenn die Aufgabe sie erfordert. Der Kontext des Agenten bleibt fokussiert, auch wenn seine Bibliothek an Fähigkeiten wächst. Die Bereitstellung von Skripts anstelle von modellgeneriertem Code erhöht auch die Wiederholbarkeit Ihrer Workflows.
  • Skalieren Sie Anweisungen ohne Qualitätsverlust. Sie können komplexe Anweisungen in modulare, wiederverwendbare Fähigkeiten zerlegen. Mit diesem Ansatz können Sie längere und spezifischere Anleitungen bereitstellen, ohne die Qualität der Anweisungsbefolgung zu beeinträchtigen und ohne das Limit von 8.000 Zeichen für deklarative Agent-Anweisungen zu überschreiten.
  • Verpacken von wiederverwendbaren Ressourcen. Sie können Anweisungen, Ressourcen und Skripts als Skill verpacken und diese Funktion in Ihren deklarativen Agent integrieren.
  • Geeignet für Unternehmen. Skripts werden in einer sicheren Sandbox ausgeführt, Vertraulichkeitsbezeichnungen für Skill-Dateien werden beibehalten und berücksichtigt, und Admin-Governance ist verfügbar.

Supportmatrix

Einige Grenzwerte unterscheiden sich, je nachdem, ob Sie den Skill mit Agent Builder oder Agents Toolkit hinzufügen.

In der folgenden Tabelle werden diese beiden Erstellungspfade beschrieben, nicht die WIQD-Grenzwerte oder die Featureabdeckung. Überprüfen Sie die aktuellen Anforderungen für die empfohlene Pro-Code-Route in der WIQD-Dokumentation.

Item Agent-Generator Agents Toolkit
Maximale Skills pro Agent 8 8
Skill-Paket Komprimiert .zip, maximal 50 MB Skill-Verzeichnis; .zip wird nicht unterstützt
Maximale Dateigröße 25 MB pro Datei Keine Qualifikationsgrenze; das komplette App-Paket ist auf 10 MB begrenzt
Maximale Anzahl von Dateien pro Paket 350 Dateien für alle Skills 350 Dateien für alle Skills
Erstellen eines Skills aus einzelnen Uploads Nicht unterstützt; Laden Sie das vollständige .zip Vollständiges Fähigkeitenverzeichnis hinzufügen oder importieren
Verzeichnishierarchie Maximale Verzeichnistiefe ist 3 Maximale Verzeichnistiefe ist 3
Agentübergreifende Wiederverwendung Nicht unterstützt Nicht unterstützt

Unterstützte Dateitypen und Skripttypen

Ein Skill kann die folgenden Dateitypen umfassen:

Kategorie Dateitypen
Anweisungen und Ressourcendateien .json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log
Skripts und Binärdateien .py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash

Sandbox für Skriptausführung

Skill-Skripts werden in einer sicheren Sandbox mit den folgenden Einschränkungen ausgeführt:

Funktion Support
Internet- oder Netzwerkzugriff über Skripts Nicht unterstützt Die Sandbox hat zur Laufzeit keinen Netzwerkzugriff.
Paketinstallation Nicht unterstützt Ein Skill kann Pakete zur Laufzeit nicht installieren.
Authentifizierte Netzwerkaufrufe von Skripts Nicht unterstützt
Vorinstallierte Pakete Ein Skill kann Pakete verwenden, die bereits in der Sandbox vorhanden sind. Verlassen Sie sich nicht auf ein Paket, es sei denn, seine Verfügbarkeit ist bestätigt.
Connectors, API-Plug-Ins und MCP-Server Der Agent kann aktivierte Funktionen über den Orchestrator verwenden. Skripts können sie nicht über die Sandbox aufrufen.

Vertraulichkeit und Speicher

Item Support
Vertraulichkeitsbezeichnungen Die Sandbox behält Vertraulichkeitsbezeichnungen bei und berücksichtigt Bezeichnungsrichtlinien. Benutzerdefinierte Berechtigungen oder Doppelschlüsselverschlüsselung werden nicht unterstützt.
Speicher Das System speichert hochgeladene Skill-Dateien in mandantenbezogenen SharePoint Embedded-Containern.