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 über das interne AI-Modell eines Browsers zusammen (welches sich zwischen den Browsern unterscheiden kann).

Konzepte und Nutzung

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

Bereitstellung einer Zusammenfassung eines gesamten Artikels, damit der Leser entscheiden kann, ob er den gesamten Artikel lesen möchte.
Zusammenfassung eines Meeting-Transkripts, damit Teilnehmer, die sich spät einloggen, schnell verstehen können, was sie verpasst haben.
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 AI-Modell des Browsers einspeisen und eine Zusammenfassung des Textes basierend auf angegebenen Optionen anfordern kann.

Dies erfolgt über die Funktionalität, die durch das Summarizer-Interface bereitgestellt wird, in einem zweistufigen Prozess:

Erstellen Sie eine Instanz des Summarizer-Objekts mit der statischen Methode Summarizer.create(), indem Sie Optionen angeben, welche Art von Zusammenfassung Sie erstellen möchten. Optionen umfassen Länge, Typ (zum Beispiel "tldr" oder Hauptpunkte), Format (Klartext oder Markdown) sowie Eingabe- und Ausgabesprachen.

Hinweis: Wenn Sie überprüfen möchten, ob das AI-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 eine ausstehende create()- oder summarize()-Operation mit einem AbortController abbrechen.

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

Siehe Verwendung der Summarizer API für einen Rundgang, wie die API funktioniert.

Schnittstellen

Summarizer Experimentell: Enthält die gesamte Funktionalität für die Summarizer API, einschließlich der Überprüfung der Verfügbarkeit von AI-Modellen, der Erstellung einer neuen Summarizer-Instanz, deren Nutzung 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.