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, von der aus Zusammenfassungen generiert werden können.
Hinweis:
Die create() Methode erfordert eine vorübergehende 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
optionsOptional-
Ein Objekt, das Konfigurationsoptionen für den
Summarizerangibt. Mögliche Werte sind:expectedInputLanguages-
Ein Array von Zeichenfolgen, das die erwarteten Sprachen des Eingabetextes angibt, die gültige BCP 47 Sprach-Tags sein sollten. Standard ist
["en"]. expectedContextLanguages-
Ein Array von Zeichenfolgen, das die erwarteten Sprachen aller bereitgestellten Kontextzeichenfolgen angibt (entweder der
sharedContext, der demSummarizerübergeben wird, oder eincontext, das während einessummarize()odersummarizeStreaming()Aufrufs angegeben wird), die gültige BCP 47 Sprach-Tags sein sollten. Standard ist["en"]. format-
Ein enumerierter Wert, der das Text-
formatangibt, in dem Sie die Rückgabe der Zusammenfassungen wünschen. Standard istmarkdown. length-
Ein enumerierter Wert, der die relative
lengthfür die generierten Zusammenfassungen angibt. Standard istshort. monitor-
Eine Rückruffunktion mit einem
CreateMonitorArgument, das die Überwachung des Downloadfortschritts des KI-Modells ermöglicht. outputLanguage-
Eine Zeichenfolge, die die erwartete Sprache der vom
Summarizergenerierten Zusammenfassungen angibt, die ein gültiges BCP 47 Sprach-Tag sein soll. Standard isten. -
Eine
sharedContextZeichenfolge, die den Kontext beschreibt, in dem die zu summarierenden Textstücke verwendet werden und die demSummarizerhilft, geeignetere Zusammenfassungen zu erstellen. signal-
Eine
AbortSignalObjektinstanz, die es ermöglicht, einecreate()-Operation über den zugehörigenAbortControllerabzubrechen. Die genaue Wirkung hängt davon ab, wannAbortController.abort()aufgerufen wird:- Wenn
abort()vor der Auflösung descreate()-Promises aufgerufen wird, wird diecreate()-Operation abgebrochen. - Wenn
abort()nach der Erfüllung descreate()-Promises aufgerufen wird, hat es die gleiche Wirkung wie ein Aufruf vonSummarizer.destroy(): Die Ressourcen, die der resultierendenSummarizerInstanz zugewiesen sind, werden freigegeben, und alle laufenden und nachfolgendenSummarizer-Methodenaufrufe werden mit einemAbortErrorabgelehnt.
- Wenn
type-
Ein enumerierter Wert, der den
typeder Zusammenfassung angibt, die dieserSummarizergenerieren soll. Standard istkey-points.
Rückgabewert
Ein Promise, das mit einer Summarizer Objektinstanz erfüllt wird.
Ausnahmen
NotAllowedErrorDOMException-
Wird ausgelöst, wenn die Nutzung der Summarizer API durch eine
summarizerPermissions-Policyblockiert wird. NotSupportedErrorDOMException-
Wird ausgelöst, wenn eines der Sprach-Tags, die in
expectedContextLanguages,expectedInputLanguagesoderoutputLanguageangegeben sind, ungültig oder nicht unterstützt ist. OperationErrorDOMException-
Allgemeiner Zweck Fehler, der ausgelöst wird, wenn die Erstellung des
Summarizeraus einem anderen Grund fehlgeschlagen ist.
Beispiele
>Grundlegende Summarizer Erstellung
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
Siehe auch
- Verwendung der Summarizer API
- Web KI Demos auf chrome.dev