Benutzerdefinierte Skills in deklarativen Agents (Vorschau)

Wichtig

Benutzerdefinierte Skills in deklarativen Agents sind für Organisationen, die Teil von Microsoft Frontier Preview sind, in der Vorschau. Weitere Informationen finden Sie unter Erkunden des KI-frühzeitigen Zugriffs in Microsoft 365.

Benutzerdefinierte Skills sind in Mandanten, die Microsoft Purview-Informationsbarrieren (IB) verwenden, nicht verfügbar. Diese Einschränkung gilt sowohl für vom Administrator bereitgestellte als auch für vom Benutzer erstellte deklarative Agents.

Unterstützung für unabhängige Softwareanbieter (Independent Software Vendors, ISVs) zur Veröffentlichung deklarativer Agents mit benutzerdefinierten Skills über das Partner Center ist noch nicht verfügbar und wird in Kürze verfügbar sein. ISVs sollten keine deklarativen Agent-Pakete, die benutzerdefinierte Skills enthalten, an Partner Center übermitteln.

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.

Benutzerdefinierte Skills sind eine neue, 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. Benutzerdefinierte 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 benutzerdefinierte Fähigkeiten hinzufügen, indem Sie den Agent Builder oder das Microsoft 365 Agents Toolkit verwenden.

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

Benutzerdefinierte Skills 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.

Unterstützungsmatrix

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

Element 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 In dieser Phase der Vorschau nicht unterstützt In dieser Phase der Vorschau 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

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

Bekannte Probleme

Während der Vorschau können Sie auf das folgende Verhalten stoßen:

  • Skills und eingebettete Dateien können noch nicht kombiniert werden. Agents, die sowohl über Skills als auch über eingebettete Dateien verfügen, werden noch nicht unterstützt. Unterstützung ist geplant.