Rewriter API

Menggunakan Rewriter API

Pertama, jalankan deteksi fitur untuk melihat apakah browser mendukung API ini.

if ('Rewriter' in self) {
  // The Rewriter API is supported.
}

Rewriter API, dan semua API AI bawaan lainnya, terintegrasi di browser. Gemini Nano didownload secara terpisah saat pertama kali situs menggunakan API AI bawaan. Dalam praktiknya, jika pengguna telah berinteraksi dengan API bawaan, mereka telah mendownload model ke browser mereka.

Untuk menentukan apakah model siap digunakan, panggil fungsi asinkron Rewriter.availability(). Metode ini menampilkan string yang dapat mengambil empat kemungkinan nilai:

• unavailable: Browser mendukung Rewriter API, tetapi tidak dapat digunakan saat ini. Hal ini dapat terjadi karena beberapa alasan, seperti kapasitas disk yang tersedia tidak cukup untuk mendownload model.
• available: Browser mendukung Rewriter API, dan dapat langsung digunakan.
• downloadable: Browser mendukung Rewriter API, tetapi browser perlu mendownload model terlebih dahulu.
• downloading: Browser mendukung Rewriter API, dan saat ini sedang mendownload model.

Untuk memicu download model dan memulai penulis ulang, panggil fungsi Rewriter.create(). Jika respons terhadap availability() adalah downloadable, dengarkan progres download dan beri tahu pengguna, karena download mungkin memerlukan waktu.

const rewriter = await Rewriter.create({
  monitor(m) {
    m.addEventListener("downloadprogress", e => {
      console.log(`Downloaded ${e.loaded * 100}%`);
    });
  }
});

Fungsi API

Fungsi create() memungkinkan Anda mengonfigurasi objek penulis ulang baru. Metode ini menggunakan objek options opsional dengan parameter berikut:

• tone: Nuansa penulisan dapat merujuk pada gaya, karakter, atau sikap konten. Nilai dapat ditetapkan ke more-formal, as-is (default), atau more-casual.
• format: Pemformatan output, dengan nilai yang diizinkan as-is (default), markdown, dan plain-text.
• length: Panjang output, dengan nilai yang diizinkan shorter, as-is (default), dan longer.
• sharedContext: Saat menulis ulang beberapa konten, konteks bersama dapat membantu model membuat konten yang lebih sesuai dengan ekspektasi Anda.

Contoh berikut menunjukkan cara memulai objek rewriter:

const options = {
  sharedContext: 'This is an email to acquaintances about an upcoming event.',
  tone: 'more-casual',
  format: 'plain-text',
  length: 'shorter',
};

const available = await Rewriter.availability();
let rewriter;
if (available === 'unavailable') {
  // The Rewriter API isn't usable.
  return;
}
if (available === 'available') {
  // The Rewriter API can be used immediately .
  rewriter = await Rewriter.create(options);
} else {
  // The Rewriter can be used after the model is downloaded.
  rewriter = await Rewriter.create(options);
  rewriter.addEventListener('downloadprogress', (e) => {
    console.log(e.loaded, e.total);
  });
}

Mulai menulis ulang

Ada dua cara untuk menghasilkan konten dari model: non-streaming dan streaming.

Output non-streaming

Dengan penulisan ulang non-streaming, model memproses input secara keseluruhan, lalu menghasilkan output.

Untuk mendapatkan output non-streaming, panggil fungsi asinkron rewrite(). Anda harus menyertakan teks awal yang ingin ditulis ulang. Anda dapat menambahkan context opsional untuk memberikan informasi latar belakang model, yang dapat membantu model memenuhi ekspektasi Anda terhadap output dengan lebih baik.

// Non-streaming
const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});
const result = await rewriter.rewrite(reviewEl.textContent, {
  context: "Avoid any toxic language and be as constructive as possible."
});

Output penulisan ulang streaming

Streaming menawarkan hasil secara real-time. Output diperbarui secara berkelanjutan saat input ditambahkan dan disesuaikan.

Untuk mendapatkan penulis ulang streaming, panggil fungsi rewriteStreaming() dan lakukan iterasi pada segmen teks yang tersedia dalam streaming. Anda dapat menambahkan context opsional untuk memberikan informasi latar belakang model, yang dapat membantu model memenuhi ekspektasi Anda terhadap output dengan lebih baik.

const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});

const stream = rewriter.rewriteStreaming(reviewEl.textContent, {
  context: "Avoid any toxic language and be as constructive as possible.",
  tone: "more-casual",
});

for await (const chunk of stream) {
  composeTextbox.append(chunk);
}

Membagikan konteks untuk beberapa tugas

Anda dapat menggunakan rewriter untuk membuat beberapa konten. Dalam hal ini, sebaiknya tambahkan sharedContext. Misalnya, Anda mungkin ingin membantu peninjau memberikan masukan yang lebih baik dalam komentar.

// Shared context and per writing task context
const rewriter = await Rewriter.create({
  sharedContext: "This is for publishing on [popular website name], a business and employment-focused social media platform."
});

const stream = rewriter.rewriteStreaming(
  "Love all this work on generative AI at Google! So much to learn and so many new things I can do!",
  {
    context: "The request comes from someone working at a startup providing an e-commerce CMS solution.",
    tone: "more-casual",
  }
);

for await (const chunk of stream) {
  composeTextbox.append(chunk);
}

Menggunakan kembali alat tulis ulang

Anda dapat menggunakan penulis ulang yang sama untuk mengedit beberapa konten. Hal ini dapat sangat berguna jika menambahkan penulis ulang ke alat masukan atau komentar, untuk membantu penulis memberikan masukan yang produktif dan bermanfaat.

// Reusing a rewriter
const rewriter = await Rewriter.create({
  sharedContext: "A review for the Flux Capacitor 3000 from TimeMachines Inc."
});

const rewrittenReviews = await Promise.all(
  Array.from(
    document.querySelectorAll("#reviews > .review"),
    (reviewEl) => rewriter.rewrite(reviewEl.textContent, {
      context: "Avoid any toxic language and be as constructive as possible.",
      tone: "more-casual",
    })
  ),
);

Menghentikan penulis ulang

Untuk mengakhiri proses penulisan ulang, batalkan pengontrol dan hancurkan rewriter.

// Stop a rewriter
const controller = new AbortController();
stopButton.onclick = () => controller.abort();

const rewriter = await Rewriter.create({ signal: controller.signal });
await rewriter.rewrite(reviewEl.textContent, { signal: controller.signal });

// Destroy a rewriter
rewriter.destroy();

Demo

Berinteraksi dan memberikan masukan

Writer API dan Rewriter API sedang dalam tahap pembahasan aktif dan dapat berubah sewaktu-waktu di masa mendatang. Jika Anda mencoba API ini dan memiliki masukan, kami ingin mendengarnya.

• Baca penjelasan, ajukan pertanyaan, dan berpartisipasi dalam diskusi.
• Tinjau penerapan untuk Chrome di Status Chrome.
• Bergabunglah ke program pratinjau awal untuk melihat lebih awal API baru dan mendapatkan akses ke milis kami.
• Jika Anda memiliki masukan tentang penerapan Chrome, laporkan bug Chromium.

Temukan semua API AI bawaan yang menggunakan model, termasuk Gemini Nano dan model pakar lainnya, di browser.