Veröffentlicht: 11. November 2024
Stellen Sie sich vor, Sie könnten Ihren Nutzern die Möglichkeit bieten, lange Artikel, komplexe Dokumente oder sogar lebhafte Chatunterhaltungen in prägnante und aussagekräftige Zusammenfassungen zu verdichten.
Mit der Summarizer API können Sie verschiedene Arten von Zusammenfassungen in unterschiedlichen Längen und Formaten generieren, z. B. Sätze, Absätze und Aufzählungslisten. Wir sind der Meinung, dass diese API in folgenden Fällen nützlich ist:
- Die wichtigsten Punkte eines Artikels oder einer Chatunterhaltung zusammenfassen.
- Titel und Überschriften für Artikel vorschlagen
- Eine prägnante und informative Zusammenfassung eines langen Textes erstellen.
- Einen Teaser für ein Buch basierend auf einer Buchrezension generieren
Verfügbarkeit
- Nehmen Sie am Ursprungstest der Summarizer API teil, der von Chrome 131 bis Chrome 136 läuft. Mit Ursprungstests können Sie die Funktion echten Nutzern an Ihrem Ursprung in Chrome anbieten.
- Folgen Sie der Implementierung im Chrome-Status.
- Der Vorschlag für die Summarizer API ist Teil einer Suite von APIs für die Texterstellung und steht zur Diskussion.
- Melden Sie sich für das Vorab-Programm an, um einen ersten Blick auf die neuen integrierten KI-APIs zu werfen und an der Diskussion in unserer Mailingliste teilzunehmen.
Für den Ursprungstest registrieren
So verwenden Sie die Summarizer API:
- Sie bestätigen, dass Sie die Google-Richtlinie zur unzulässigen Nutzung von generativer KI gelesen und verstanden haben.
- Rufen Sie den Ursprungstest der Summarizer API auf.
- Klicken Sie auf Registrieren und füllen Sie das Formular aus.
- Geben Sie im Feld Web-Ursprung Ihren Ursprung oder die Erweiterungs-ID
chrome-extension://YOUR_EXTENSION_ID
ein.
- Geben Sie im Feld Web-Ursprung Ihren Ursprung oder die Erweiterungs-ID
- Klicken Sie auf Registrieren, um die Änderungen zu senden.
- Kopieren Sie das bereitgestellte Token und fügen Sie es auf jeder Webseite in Ihrem Ursprung oder Ihrer Datei für die Erweiterung ein, auf der der Test aktiviert werden soll.
- Wenn Sie eine Erweiterung erstellen, folgen Sie der Anleitung für Ursprungstests für Erweiterungen.
- Verwenden Sie die Summarizer API.
Weitere Informationen zum Einstieg in Tests für Quellen
Einschränkungen während des Testzeitraums für den Ursprung
Während des Testzeitraums unterstützt die Summarizer API nur die Zusammenfassung englischer Texte, da die Modellqualität nur gründlich an englischen Inhalten getestet wurde. Wir möchten diese Einschränkung aufheben, sobald wir weitere Sprachen auf Qualität und Sicherheit getestet haben und die API allgemein verfügbar ist.
Unterstützung für localhost hinzufügen
Wenn Sie während des Ursprungstests auf die Summarizer API auf localhost
zugreifen möchten, benötigen Sie Chrome Canary. Führen Sie dann die folgenden Schritte aus:
- Öffnen Sie Chrome Canary auf einer der folgenden Plattformen: Windows, Mac oder Linux.
- Öffnen Sie
chrome://flags/#summarization-api-for-gemini-nano
. - Wählen Sie Aktiviert aus.
- Klicken Sie auf Neu starten oder starten Sie Chrome neu.
Summarizer API verwenden
Führen Sie zuerst die Funktionserkennung aus, um zu prüfen, ob der Browser die Summarizer API unterstützt.
if ('ai' in self && 'summarizer' in self.ai) {
// The Summarizer API is supported.
}
Modelldownload
Die Summarizer API verwendet ein leistungsstarkes KI-Modell, das zum Generieren hochwertiger Zusammenfassungen trainiert wurde. Die API ist zwar in Chrome integriert, das Modell wird jedoch separat heruntergeladen, wenn eine Website die API zum ersten Mal verwendet.
Rufen Sie die asynchrone Funktion ai.summarizer.capabilities()
auf, um zu prüfen, ob das Modell einsatzbereit ist. Es gibt ein AISummarizerCapabilities
-Objekt mit einem available
-Feld zurück, das drei mögliche Werte annehmen kann:
no
: Der aktuelle Browser unterstützt die Summarizer API, kann sie aber derzeit nicht verwenden. Das kann verschiedene Gründe haben, z. B. nicht genügend Speicherplatz zum Herunterladen des Modells.readily
: Der aktuelle Browser unterstützt die Summarizer API und kann sofort verwendet werden.after-download
: Der aktuelle Browser unterstützt die Summarizer API, muss aber zuerst das Modell herunterladen.
Rufen Sie die asynchrone Funktion ai.summarizer.create()
auf, um den Modelldownload auszulösen und den Summarizer zu erstellen. Wenn die Antwort auf capabilities()
after-download
war, solltest du auf den Downloadfortschritt achten. So können Sie den Nutzer informieren, falls der Download etwas Zeit in Anspruch nimmt.
const summarizer = await ai.summarizer.create({
monitor(m) {
m.addEventListener('downloadprogress', (e) => {
console.log(`Downloaded ${e.loaded} of ${e.total} bytes.`);
});
}
});
API-Funktionen
Mit der Funktion create()
können Sie ein neues Zusammenfassungsobjekt nach Ihren Anforderungen konfigurieren. Es nimmt ein optionales options
-Objekt mit den folgenden Parametern an:
sharedContext
: Zusätzlicher gemeinsamer Kontext, der dem Zusammenfassungstool helfen kann.type
: Der Typ der Zusammenfassung mit den zulässigen Wertenkey-points
(Standard),tl;dr
,teaser
undheadline
.format
: Das Format der Zusammenfassung mit den zulässigen Wertenmarkdown
(Standard) undplain-text
.length
: Die Länge der Zusammenfassung. Zulässige Werte:short
,medium
(Standard) undlong
. Die Bedeutung dieser Längen variiert je nach angefordertertype
. In Chrome besteht eine kurze Zusammenfassung der wichtigsten Punkte beispielsweise aus drei Aufzählungspunkten und eine kurze Zusammenfassung aus einem Satz. Eine lange Zusammenfassung der wichtigsten Punkte besteht aus sieben Aufzählungspunkten und eine lange Zusammenfassung aus einem Absatz.
Im folgenden Beispiel wird gezeigt, wie der Summer initialisiert wird.
const options = {
sharedContext: 'This is a scientific article',
type: 'key-points',
format: 'markdown',
length: 'medium',
};
const available = (await self.ai.summarizer.capabilities()).available;
let summarizer;
if (available === 'no') {
// The Summarizer API isn't usable.
return;
}
if (available === 'readily') {
// The Summarizer API can be used immediately .
summarizer = await self.ai.summarizer.create(options);
} else {
// The Summarizer API can be used after the model is downloaded.
summarizer = await self.ai.summarizer.create(options);
summarizer.addEventListener('downloadprogress', (e) => {
console.log(e.loaded, e.total);
});
await summarizer.ready;
}
Zusammenfassung ausführen
Es gibt zwei Möglichkeiten, den Summarizer auszuführen: Streaming und Nicht-Streaming.
Zusammenfassung ohne Streaming
Bei der nicht-streamingbasierten Zusammenfassung verarbeitet das Modell die Eingabe als Ganzes und generiert dann die Ausgabe.
Wenn Sie eine nicht gestreamte Zusammenfassung erhalten möchten, rufen Sie die asynchrone summarize()
-Funktion des Summarizers auf. Das erste Argument für die Funktion ist der Text, den Sie zusammenfassen möchten. Das zweite, optionale Argument ist ein Objekt mit einem context
-Feld.
In diesem Feld können Sie Hintergrunddetails hinzufügen, die die Zusammenfassung verbessern könnten.
const longText = document.querySelector('article').innerHTML;
const summary = await summarizer.summarize(longText, {
context: 'This article is intended for a tech-savvy audience.',
});
Streaming-Zusammenfassung
Bei der Streaming-Zusammenfassung erhalten Sie Ergebnisse in Echtzeit. Die Ausgabe wird kontinuierlich aktualisiert, während die Eingabe hinzugefügt und angepasst wird.
Wenn Sie eine Streaming-Zusammenfassung abrufen möchten, rufen Sie die Funktion summarizeStreaming()
des Summarizers auf. Gehen Sie dann die verfügbaren Textsegmente im Stream durch.
let result = '';
let previousChunk = '';
for await (const chunk of stream) {
const newChunk = chunk.startsWith(previousChunk)
? chunk.slice(previousChunk.length) : chunk;
console.log(newChunk);
result += newChunk;
previousChunk = chunk;
}
console.log(result);
summarizeStreaming()
gibt eine ReadableStream
zurück, bei der die Antwortsegmente aufeinander aufbauen. Das bedeutet, dass jede Antwort die gesamte bis zu diesem Punkt generierte Zusammenfassung enthält, nicht nur das nächste Segment. Das ist nicht beabsichtigt.
Wir möchten uns an anderen Streaming-APIs auf der Plattform orientieren, bei denen die Segmente aufeinanderfolgende Teile eines einzigen langen Streams sind. Um das gewünschte Verhalten zu erzielen, können Sie vorerst Folgendes implementieren:
let result = '';
let previousLength = 0;
for await (const segment of stream) {
const newContent = segment.slice(previousLength);
console.log(newContent);
previousLength = segment.length;
result += newContent;
}
console.log(result);
Demo
Sie können die Summarizer API im Summarizer API Playground ausprobieren.
Standardisierungsaufwand
Wir arbeiten daran, die Summarizer API zu standardisieren, um für plattformübergreifende Kompatibilität zu sorgen.
Unser API-Vorschlag hat Unterstützung von der Community erhalten und wird nun in der W3C Web Incubator Community Group weiter diskutiert. Das Chrome-Team hat Feedback von der W3C Technical Architecture Group angefordert und Mozilla und WebKit um ihre Positionierung zu den Standards gebeten.
Teilnehmen und Feedback geben
Sie können die Summarizer API jetzt testen, indem Sie am Ursprungstest teilnehmen und uns Feedback geben. Ihr Feedback kann sich direkt darauf auswirken, wie wir zukünftige Versionen dieser API und alle integrierten KI-APIs entwickeln und implementieren.
- Wenn Sie Feedback zur Implementierung in Chrome geben möchten, können Sie einen Fehlerbericht oder eine Funktionsanfrage senden.
- Diskutieren Sie das Design der Summarizer API auf GitHub, indem Sie ein vorhandenes Problem kommentieren oder ein neues öffnen.
- Wenn Sie sich an der Standardsentwicklung beteiligen möchten, können Sie der Web Incubator Community Group beitreten.