Summarizer: create() statische Methode

Syntax

Summarizer.create()
Summarizer.create(options)

Parameter

options Optional

Ein Objekt, das Konfigurationsoptionen für den Summarizer spezifiziert. Mögliche Werte umfassen:

expectedInputLanguages

Ein Array von Zeichenfolgen, das die erwarteten Sprachen des Eingabetextes angibt, die gültige BCP 47 Sprachtags sein sollten. Standardmäßig ["en"].

expectedContextLanguages

Ein Array von Zeichenfolgen, das die erwarteten Sprachen aller bereitgestellten Kontextzeichenfolgen angibt (entweder der an den Summarizer übergebene sharedContext, oder ein während eines summarize() oder summarizeStreaming() Aufrufs spezifizierter context), die gültige BCP 47 Sprachtags sein sollten. Standardmäßig ["en"].

format

Ein enumerierter Wert, der das Text-format angibt, in dem die Zusammenfassungen zurückgegeben werden sollen. Standardmäßig markdown.

length

Ein enumerierter Wert, der die relative length für die generierten Zusammenfassungen angibt. Standardmäßig short.

monitor

Eine Callback-Funktion mit einem CreateMonitor Argument, das die Überwachung des Downloadfortschritts des KI-Modells ermöglicht.

outputLanguage

Eine Zeichenfolge, die die erwartete Sprache der vom Summarizer generierten Zusammenfassungen angibt, die ein gültiger BCP 47 Sprachtag sein sollte. Standardmäßig en.

sharedContext

Eine sharedContext Zeichenfolge, die den Kontext beschreibt, in dem die zu zusammenfassenden Textstücke verwendet werden, was dem Summarizer hilft, geeignetere Zusammenfassungen zu generieren.

signal

Ein AbortSignal Objektinstanz, die es ermöglicht, eine create() Operation über den zugehörigen AbortController abzubrechen. Die genaue Wirkung hängt davon ab, wann AbortController.abort() aufgerufen wird:

• Wenn abort() vor der Auflösung des create() Promise aufgerufen wird, wird die create() Operation abgebrochen.
• Wenn abort() nach der Erfüllung des create() Promise aufgerufen wird, hat es die gleiche Wirkung wie der Aufruf von Summarizer.destroy(): Die den resultierenden Summarizer Instanz zugewiesenen Ressourcen werden freigegeben, und alle laufenden und nachfolgenden Summarizer Methodenanrufe werden mit einem AbortError abgelehnt.

type

Ein enumerierter Wert, der den type der Zusammenfassung angibt, die dieser Summarizer generieren soll. Standardmäßig key-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 ist.

NotSupportedError DOMException

Wird ausgelöst, wenn eines der in expectedContextLanguages, expectedInputLanguages oder outputLanguage angegebenen Sprach-Tags ungültig oder nicht unterstützt ist.

OperationError DOMException

Allgemeiner Zweck-Ausnahme ausgelöst, wenn die Erstellung des Summarizer aus 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

Browser-Kompatibilität

Siehe auch

• Verwendung der Summarizer API
• Web AI Demos auf chrome.dev