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 (dies kann zwischen den Browsern variieren).

Konzepte und Nutzung

Eine Zusammenfassung eines größeren Textkörpers zu schreiben, ist eine häufige Schreibaufgabe, für die KI gut geeignet ist. Typische Anwendungsfälle umfassen:

  • Bereitstellen einer Zusammenfassung eines vollständigen Artikels, sodass der Leser entscheiden kann, ob er den gesamten Artikel lesen möchte.
  • Zusammenfassen eines Sitzungsprotokolls, sodass Nachzügler schnell nachvollziehen können, was sie verpasst haben.
  • Zusammenfassen 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 eigene interne AI-Modell des Browsers einspeisen und eine Zusammenfassung des Textes basierend auf den angegebenen Optionen anfordern kann.

Dies erfolgt mit der Funktionalität, die von der Summarizer-Schnittstelle in einem zweistufigen Prozess bereitgestellt wird:

  1. Erstellen Sie eine Summarizer-Objektinstanz mit der statischen Methode Summarizer.create(). Dabei geben Sie Optionen an, welche Art von Zusammenfassung Sie wünschen. Optionen umfassen Länge, Typ (zum Beispiel "tldr" oder Hauptpunkte), Format (Klartext oder Markdown) sowie Eingabe- und Ausgabesprachen.

    Hinweis: Wenn Sie prüfen möchten, ob das Browser-AI-Modell Ihre Präferenzen unterstützt, können Sie dies mit der statischen Methode Summarizer.availability() tun.

  2. Führen Sie die Instanzmethode Summarizer.summarize() aus, um die Zusammenfassung anzufordern.

Nachdem eine Summarizer-Instanz erstellt wurde, können Sie sie mit der Instanzmethode Summarizer.destroy() wieder entfernen. Sie können auch eine ausstehende create()- oder summarize()-Operation mit einem AbortController abbrechen.

Sehen Sie sich Verwendung der Summarizer API für einen ausführlichen Überblick darüber an, wie die API funktioniert.

Schnittstellen

Summarizer

Beinhaltet die gesamte Funktionalität für die Summarizer API, einschließlich der Prüfung der Verfügbarkeit des AI-Modells, Erstellung einer neuen Summarizer-Instanz, deren Verwendung zur Generierung einer neuen Zusammenfassung und mehr.

HTTP-Header

Permissions-Policy; Die Direktive summarizer

Kontrolliert den Zugriff auf die Summarizer API. Wo eine Richtlinie die Nutzung der Summarizer API speziell verbietet, schlagen alle Versuche, die Methoden der API aufzurufen, mit einem NotAllowedError DOMException fehl.

Sicherheitsüberlegungen

Die Spezifikation erfordert, dass ein Benutzer kürzlich mit der Seite interagiert hat, wenn Summarizer-Objekte erstellt werden (flüchtige Benutzeraktivierung ist erforderlich).

Darüber hinaus kontrolliert die Spezifikation den Zugriff auf die API über summarizer-Permissions-Policy-Direktiven.

Beispiele

Für ein vollständiges Beispiel, siehe Verwendung der Summarizer API.

Spezifikationen

Specification
Writing Assistance APIs
# summarizer-api

Browser-Kompatibilität

Siehe auch