Summarizer: inputQuota-Eigenschaft

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 inputQuota-Schreibgeschützte Eigenschaft der Summarizer-Schnittstelle gibt das verfügbare Input-Kontingent für den Browser zum Generieren von Zusammenfassungen zurück.

Wert

Eine Zahl, die das verfügbare Input-Kontingent spezifiziert. Diese Zahl ist implementierungsabhängig. Zum Beispiel könnte es infinity sein, wenn es keine Begrenzungen über den Speicher des Benutzers und die maximale Länge von JavaScript-Strings hinaus gibt, oder es könnte eine Anzahl von Token sein im Fall von KI-Modellen, die ein Token/Credits-Schema verwenden.

Beispiele

Überprüfen Sie, ob Sie ausreichendes Kontingent haben

Im folgenden Code-Snippet erstellen wir eine neue Summarizer-Instanz mit create(), dann geben wir das gesamte Input-Kontingent über inputQuota und die Input-Kontingent-Nutzung für die Zusammenfassung eines bestimmten Textstrings über measureInputUsage() zurück.

Wir testen dann, ob die individuelle Input-Nutzung für diesen String größer ist als das insgesamt verfügbare Kontingent. Falls ja, werfen wir einen angemessenen Fehler; falls nein, beginnen wir mit der Zusammenfassung des Strings mittels summarize().

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",
});

const totalInputQuota = summarizer.inputQuota;
const inputUsage = await summarizer.measureInputUsage(myTextString);

if (inputUsage > totalInputQuota) {
  throw new Error("Boo, insufficient quota to generate a summary.");
} else {
  console.log("Yay, quota available to generate a summary.");
  const summary = await summarizer.summarize(myTextString);
  // ...
}

Spezifikationen

Specification
Writing Assistance APIs
# dom-summarizer-inputquota

Browser-Kompatibilität

Siehe auch