Summarizer API

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die Summarizer API fasst einen gegebenen Textkörper mithilfe eines internen KI-Modells des Browsers zusammen (was zwischen den Browsern variieren kann).

Konzepte und Verwendung

Das Schreiben einer Zusammenfassung eines größeren Textkörpers ist eine häufige Schreibaufgabe, für die KI gut geeignet ist. Typische Anwendungsfälle sind:

Bereitstellung einer Zusammenfassung eines vollständigen Artikels, damit der Leser entscheiden kann, ob er das ganze lesen möchte.
Zusammenfassung eines Besprechungsprotokolls, damit spät hinzukommende Teilnehmer den verpassten Inhalt schnell nachholen können.
Zusammenfassung einer Reihe von Produktbewertungen, um schnell die allgemeine Stimmung zu kommunizieren.

Die Summarizer API bietet einen asynchronen (Promise-basierten) Mechanismus, mit dem eine Website einen Textkörper in das interne KI-Modell des Browsers einspeisen und eine Zusammenfassung des Textes basierend auf angegebenen Optionen anfordern kann.

Dies wird mithilfe der Funktionalität der Summarizer-Schnittstelle in einem zweistufigen Prozess durchgeführt:

Erstellen Sie eine Summarizer-Objektinstanz mit der statischen Methode Summarizer.create(), indem Sie Optionen angeben, welche Art von Zusammenfassung Sie möchten. Optionen umfassen Länge, Typ (zum Beispiel "tldr" oder Schlüsselpunkte), Format (nur Text oder Markdown) sowie Eingabe- und Ausgabesprachen.

Hinweis: Wenn Sie überprüfen möchten, ob das KI-Modell des Browsers Ihre Präferenzen unterstützen kann, können Sie dies mit der statischen Methode Summarizer.availability() tun.
Führen Sie die Instanzmethode Summarizer.summarize() aus, um die Zusammenfassung anzufordern.

Sie können einen ausstehenden create()- oder summarize()-Vorgang mit einem AbortController abbrechen.

Nachdem eine Summarizer-Instanz erstellt wurde, können Sie ihre zugewiesenen Ressourcen freigeben und jede weitere Aktivität stoppen, indem Sie ihre Methode Summarizer.destroy() aufrufen. Es wird empfohlen, dies zu tun, nachdem Sie das Summarizer-Objekt verwendet haben, da es viele Ressourcen verbrauchen kann.

Siehe Verwendung der Summarizer API für eine detaillierte Anleitung, wie die API funktioniert.

Schnittstellen

Summarizer Experimentell: Beinhaltet die gesamte Funktionalität der Summarizer API, einschließlich der Überprüfung der Verfügbarkeit des KI-Modells, der Erstellung einer neuen Summarizer-Instanz, der Verwendung zur Generierung einer neuen Zusammenfassung und mehr.

HTTP-Header

Permissions-Policy; die summarizer Direktive: Steuert den Zugriff auf die Summarizer API. Wo eine Richtlinie die Nutzung der Summarizer API ausdrücklich untersagt, schlagen alle Versuche, die Methoden der API aufzurufen, mit einem NotAllowedError DOMException fehl.