Summarizer: measureInputUsage()-Methode

input

Ein String, der den Eingabetext repräsentiert, für den Sie eine Eingabenutzungsmessung wünschen.

options Optional

Ein Objekt, das Konfigurationsoptionen für die measureInputUsage()-Operation spezifiziert. Mögliche Werte umfassen:

context

Ein String, der den Kontext beschreibt, in dem der Eingabetext verwendet wird, um eine geeignetere Zusammenfassung zu generieren.

signal

Ein AbortSignal-Objekt, das es erlaubt, die measureInputUsage()-Operation über den zugehörigen AbortController abzubrechen.

Ein Promise, das sich mit einer Zahl erfüllt, die die inputQuota-Nutzung des gegebenen Eingabetextes angibt.

NotAllowedError DOMException

Wird ausgelöst, wenn die Nutzung der Summarizer-API durch eine summarizer Permissions-Policy blockiert ist.

NotReadableError DOMException

Wird ausgelöst, wenn die Ausgabezusammenfassung vom Benutzeragenten gefiltert wurde, z. B. weil sie als schädlich, ungenau oder unsinnig erkannt wurde.

NotSupportedError DOMException

Wird ausgelöst, wenn der bereitgestellte context nicht in einer Sprache vorliegt, die der Summarizer unterstützt.

UnknownError DOMException

Wird ausgelöst, wenn der measureInputUsage()-Aufruf aus einem anderen Grund fehlgeschlagen ist, oder aus einem Grund, den der Benutzeragent nicht offenlegen wollte.

Im folgenden Beispiel erstellen wir eine neue Summarizer-Instanz mit Hilfe von create() und geben dann das gesamte Eingabekontingent über inputQuota und die Eingabenutzung für die Zusammenfassung eines bestimmten Textstrings über measureInputUsage() zurück.

Dann prüfen wir, ob die individuelle Nutzung dieses Strings größer ist als das insgesamt verfügbare Kontingent. Falls ja, werfen wir einen entsprechenden Fehler; andernfalls beginnen wir mit der Zusammenfassung des Strings unter Verwendung von summarize().

const summarizer = await Summarizer.create({
  sharedContext:
    "A general summary to help a user decide if the text is worth reading",
  type: "tl;dr",
  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);
  // ...
}

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