Summarizer: create() statische Methode
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.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die create()
statische Methode der Summarizer
Schnittstelle erstellt eine neue Summarizer
-Instanz, um Zusammenfassungen zu generieren.
Hinweis:
Die create()
-Methode erfordert transiente Aktivierung, das heißt, sie muss als Reaktion auf eine Benutzeraktion wie einen Mausklick oder Tastendruck aufgerufen werden.
Syntax
Summarizer.create()
Summarizer.create(options)
Parameter
options
Optional-
Ein Objekt, das Konfigurationsoptionen für den
Summarizer
angibt. Mögliche Werte sind:expectedInputLanguages
-
Ein Array von Strings, das die erwarteten Sprachen des Eingabetexts spezifiziert, die gültige BCP 47 Sprach-Tags sein sollten. Standardmäßig
["en"]
. expectedContextLanguages
-
Ein Array von Strings, das die erwarteten Sprachen aller bereitgestellten Kontext-Strings spezifiziert (entweder der
sharedContext
, der demSummarizer
übergeben wurde, oder eincontext
, das während einessummarize()
- odersummarizeStreaming()
-Aufrufs spezifiziert wurde), die gültige BCP 47 Sprach-Tags sein sollten. Standardmäßig["en"]
. format
-
Ein enumerierter Wert, der das Text
format
angibt, in dem Sie Zusammenfassungen erhalten möchten. Standardmäßigmarkdown
. length
-
Ein enumerierter Wert, der die relative
length
für die generierten Zusammenfassungen angibt. Standardmäßigshort
. monitor
-
Eine Callback-Funktion mit einem
CreateMonitor
-Argument, die es ermöglicht, den Download-Fortschritt des KI-Modells zu überwachen. outputLanguage
-
Ein String, der die erwartete Sprache der vom
Summarizer
generierten Zusammenfassungen angibt, die ein gültiges BCP 47 Sprach-Tag sein sollte. Standardmäßigen
. -
Ein
sharedContext
String, der den Kontext beschreibt, in dem die zusammenzufassenden Texte verwendet werden, was demSummarizer
hilft, geeignetere Zusammenfassungen zu generieren. signal
-
Ein
AbortSignal
Objekt, das es ermöglicht, diecreate()
-Operation über den assoziiertenAbortController
abzubrechen. type
-
Ein enumerierter Wert, der die
type
der Zusammenfassung angibt, die dieserSummarizer
generieren soll. Standardmäßigkey-points
.
Rückgabewert
Ein Promise
, das mit einer Summarizer
-Objektinstanz erfüllt wird.
Ausnahmen
NotAllowedError
DOMException
-
Wird ausgelöst, wenn die Nutzung der Summarizer API durch eine
summarizer
Permissions-Policy
blockiert wird. NotSupportedError
DOMException
-
Wird ausgelöst, wenn eines der in
expectedContextLanguages
,expectedInputLanguages
oderoutputLanguage
angegebenen Sprach-Tags ungültig oder nicht unterstützt ist. OperationError
DOMException
-
Allgemeine Ausnahme, die ausgelöst wird, wenn die Erstellung des
Summarizer
aus einem anderen Grund fehlschlug.
Beispiele
>Grundlegende Erstellung eines Summarizer
const summarizer = await Summarizer.create({
sharedContext:
"A general summary to help a user decide if the text is worth reading",
type: "tldr",
length: "short",
format: "markdown",
expectedInputLanguages: ["en-US"],
outputLanguage: "en-US",
});
Spezifikationen
Specification |
---|
Writing Assistance APIs> # dom-summarizer-create> |
Browser-Kompatibilität
Loading…
Siehe auch
- Verwendung der Summarizer API
- Web AI Demos auf chrome.dev