[go: up one dir, main page]

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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, 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 dem Summarizer übergeben wird, oder ein context, das während eines summarize() oder summarizeStreaming() Aufrufs angegeben wird), die gültige BCP 47 Sprach-Tags sein sollten. Standard ist ["en"].

format

Ein enumerierter Wert, der das Text-format angibt, in dem Sie die Rückgabe der Zusammenfassungen wünschen. Standard ist markdown.

length

Ein enumerierter Wert, der die relative length für die generierten Zusammenfassungen angibt. Standard ist short.

monitor

Eine Rückruffunktion 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ültiges BCP 47 Sprach-Tag sein soll. Standard ist en.

sharedContext

Eine sharedContext Zeichenfolge, die den Kontext beschreibt, in dem die zu summarierenden Textstücke verwendet werden und die dem Summarizer hilft, 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()-Promises aufgerufen wird, wird die create()-Operation abgebrochen.
  • Wenn abort() nach der Erfüllung des create()-Promises aufgerufen wird, hat es die gleiche Wirkung wie ein Aufruf von Summarizer.destroy(): Die Ressourcen, die der resultierenden Summarizer Instanz zugewiesen sind, werden freigegeben, und alle laufenden und nachfolgenden Summarizer-Methodenaufrufe werden mit einem AbortError abgelehnt.
type

Ein enumerierter Wert, der den type der Zusammenfassung angibt, die dieser Summarizer generieren soll. Standard ist 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 wird.

NotSupportedError DOMException

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

OperationError DOMException

Allgemeiner Zweck Fehler, der ausgelöst wird, wenn die Erstellung des Summarizer aus einem anderen Grund fehlgeschlagen ist.

Beispiele

Grundlegende Summarizer Erstellung

js
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