Summarizer: create() statische Methode

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 Zeichenfolgen, die die erwarteten Sprachen des Eingabetextes angeben. Diese sollten gültige BCP 47-Sprach-Tags sein. Standardmäßig ["en"].

expectedContextLanguages

Ein Array von Zeichenfolgen, die die erwarteten Sprachen aller bereitgestellten Kontexttexte angeben (entweder der sharedContext, der dem Summarizer übergeben wurde, oder ein context, der während eines summarize() oder summarizeStreaming() Aufrufs angegeben wurde). Diese sollten gültige BCP 47-Sprachtags sein. Standardmäßig ["en"].

format

Ein Aufzählungswert, der das Textformat angibt, in dem Sie die Zusammenfassungen zurückgeben möchten. Standardmäßig markdown.

length

Ein Aufzählungswert, der die relative length für die erzeugten Zusammenfassungen angibt. Standardmäßig short.

monitor

Eine Callback-Funktion mit einem CreateMonitor Argument, das es ermöglicht, den Download-Fortschritt des KI-Modells zu überwachen.

outputLanguage

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

sharedContext

Eine sharedContext Zeichenfolge, die den Kontext beschreibt, in dem die zusammenzufassenden Textstücke verwendet werden. Dies hilft dem Summarizer, geeignetere Zusammenfassungen zu erstellen.

signal

Eine 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 Erfüllung des create()-Promise aufgerufen wird, hat es den gleichen Effekt wie ein Aufruf von Summarizer.destroy(): Die Ressourcen der resultierenden Summarizer-Instanz werden freigegeben, und laufende sowie nachfolgende Summarizer-Methodenaufrufe werden mit einem AbortError abgelehnt.

type

Ein Aufzählungswert, der den type der Zusammenfassung angibt, die dieser Summarizer erzeugen soll. Standardmäßig key-points.

Rückgabewert

Ein Promise, das mit einer Summarizer-Objektinstanz erfüllt wird.

Ausnahmen

NotAllowedError DOMException

Ausgelöst, wenn die Nutzung der Summarizer API durch eine summarizer Permissions-Policy blockiert wird.

NotSupportedError DOMException

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

OperationError DOMException

Allgemeine Ausnahme, die ausgelöst wird, wenn die Erstellung des Summarizer aus irgendeinem anderen Grund fehlschlägt.

Beispiele

Grundlegendes 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 KI-Demos auf chrome.dev