Mengelola versi pemroses

Versi baru dirilis karena berbagai alasan, misalnya, untuk meningkatkan akurasi, meningkatkan ketersediaan, dan mendukung elemen dokumen baru, seperti tanda pilihan.

Mengingat Document AI didukung oleh AI generatif, versi mendatang akan menggunakan model dasar baru sehingga Anda dapat memanfaatkan peningkatan kualitas AI generatif.

Seiring peningkatan kualitas model dasar, model dasar sebelumnya akan dihentikan penggunaannya. Demikian pula, versi prosesor akan dihentikan enam bulan setelah versi baru dirilis.

Prosesor dapat memiliki salah satu versi berikut:

• Versi stabil
• Kandidat rilis (RC)
• Versi yang disesuaikan dan versi dasarnya

Halaman ini menjelaskan cara pemroses diberi versi, serta cara melihat dan memilih versi tertentu.

Ringkasan versi pemroses

Ada dua kategori versi prosesor:

• Versi Google bersifat stabil (untuk kasus penggunaan produksi) atau kandidat rilis (eksperimental dengan fungsi terbaru).
• Versi pengguna dibuat oleh Anda untuk menyesuaikan prediksi untuk dokumen Anda dan memiliki ID versi alfanumerik.

Versi Google

Setiap versi Google diidentifikasi oleh ID Versi, misalnya pretrained-TYPE-vX.X-YYYY-MM-DD. Setiap versi prosesor yang ditawarkan Google diberi nama Google Stable atau Google Release Candidate (RC).

Versi stabil Google

Versi stabil memiliki kualitas produksi dan siap digunakan.

• Google memprioritaskan stabilitas perilaku prosesor, tetapi tetap menyertakan perbaikan penting.
• Versi stabil Google yang lebih lama akan dihentikan enam bulan setelah versi stabil terbaru dirilis seperti yang digambarkan pada gambar berikut.

Kandidat rilis (RC) Google

Release candidate bersifat eksperimental dan diupgrade secara rutin dengan fitur terbaru. Versi ini bukan versi berkualitas produksi, dan stabilitasnya dapat bervariasi.

Versi khusus

Versi yang disesuaikan adalah versi pemroses yang dapat Anda buat berdasarkan dokumen untuk menyesuaikan prediksi. Versi yang disesuaikan memiliki Type, yang menunjukkan jenis model yang digunakan untuk prediksi. Jika Anda membuat versi menggunakan model dasar (baik dengan membuat versi atau melakukan penyesuaian), maka jenisnya adalah AI Generatif. Jika Anda membuat versi pemroses dengan melatih model kustom yang lebih kecil (berbasis model atau template), maka jenisnya adalah Kustom. Jika Anda membuat versi pemroses, Anda yang menentukan nama dan ID-nya.

Versi Base

Jika Anda membuat versi pemroses, "versi dasar" akan menunjukkan versi Google yang mendukung versi pengguna yang disesuaikan. Versi dasar menentukan siklus proses versi pengguna Anda. Anda perlu membuat keputusan tentang cara mengelola siklus proses versi pengguna yang disesuaikan.

Versi pemroses stabil yang tersedia

Anda dapat meninjau versi pemroses stabil yang tersedia untuk berbagai jenis pemroses dalam tabel berikut.

Siklus proses versi pemroses

Segera setelah versi Google baru tersedia, Anda harus membuat dan mengevaluasi versi pengguna baru dengan versi dasar baru. Kemudian, deploy versi baru Anda dan batalkan deployment (atau hapus) versi pengguna sebelumnya yang menggunakan versi stabil sebelumnya sebagai dasarnya. Versi stabil dihentikan setelah versi baru dirilis. Google akan memberi tahu Anda setidaknya enam bulan sebelumnya jika hal ini terjadi.

Apa yang terjadi jika versi dasar tidak digunakan lagi?

Versi pengguna yang bergantung pada versi dasar sebelumnya berhenti menampilkan prediksi saat versi dasar tidak digunakan lagi.

Bagaimana versi prosesor dipilih untuk permintaan Anda?

Saat Anda memanggil endpoint pemroses tanpa menentukan versi pemroses, versi pemroses default akan digunakan. Jika versi pemroses default berubah, Anda mungkin perlu memperbarui kode.

Contoh penghentian penggunaan versi yang disesuaikan

Pertimbangkan skenario berikut yang menjelaskan urutan peristiwa dalam penghentian penggunaan versi yang disesuaikan:

1. Sebagai developer, Anda menggunakan Pengekstrak Kustom untuk mendapatkan data dari dokumen. Mengingat kompleksitas dan volume dokumen yang Anda proses, Anda menyetel model dasar untuk membuat versi bernama fine-tune-A. Anda menetapkan versi fine-tune-A sebagai versi default untuk pemroses dan menggunakannya untuk memproses dokumen. Versi dasar yang mendukung model fine-tune-A adalah versi stabil pretrained-foundation-model-v1.0-2023-08-22 (v1.0).

2. Google memublikasikan versi stabil baru bernama pretrained-foundation-model-v1.2-2024-05-10 (v1.2) dan mengumumkan bahwa versi stabil v1.0 akan dihentikan pada 9 April 2025.

3. Karena Anda menyimpan dokumen pelatihan dan pengujian di set data prosesor, Anda menyetel versi lain berdasarkan versi stabil Google terbaru, v1.2, dan menamainya fine-tune-B. Setelah mengevaluasi performanya, Anda menetapkan versi fine-tune-B sebagai versi default baru untuk pemroses dan menonaktifkan versi fine-tune-A. Versi baru Anda kini menggunakan versi stabil Google terbaru yang didukung.

Di sisi lain, jika Anda tidak membuat dan mengevaluasi versi fine-tune-B yang disesuaikan, Google akan memperbarui versi default prosesor Anda ke v1.2 pada 9 April 2025. Karena Anda memanggil endpoint prosesor dan tidak menentukan versi prosesor, versi v1.2 baru akan digunakan sebagai default baru untuk memproses permintaan Anda.

Resource penghentian penggunaan dan migrasi

Untuk parser dan pemroses yang tidak digunakan lagi, Anda dapat melihat penghentian penggunaan Document AI.

Lihat referensi berikut untuk migrasi:

• Untuk pembuatan dan pelatihan Expense Parser baru, Anda dapat melihat uptrain pretrained processor.

• Untuk pembuatan dan penyesuaian prosesor Custom Extractor baru, Anda dapat melihat Custom Extractor dengan GenAI.

Pilih versi pemroses

Ada tiga cara untuk menentukan versi pemroses yang akan digunakan untuk pemrosesan online dan batch:

• Jika Anda tidak menentukan versi, default pemroses akan digunakan.

  • Contoh: projects/my-proj/locations/us/processors/my-processor:process

• Jika Anda menentukan versi, versi spesifik tersebut akan digunakan. Jika versi tertentu tidak ada, permintaan akan gagal dengan error.

  • Contoh: projects/my-proj/locations/us/processors/my-processor/processorVersions/pretrained-invoice-v1.2-2022-02-18:process

• Jika Anda menentukan saluran, maka versi terbaru di saluran tersebut akan digunakan. (Opsi: stable, rc)

  • Contoh: projects/my-proj/locations/us/processors/my-processor/processorVersions/stable:process

Melihat versi yang tersedia

GET https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://LOCATION-documentai.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions" | Select-Object -Expand Content

{
  "processorVersions": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.1-2022-09-12",
      "displayName": "Google Release Candidate",
      "state": "DEPLOYED",
      "createTime": "2022-09-13T23:39:12.156648Z",
      "googleManaged": true
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/processors/PROCESSOR_ID/processorVersions/pretrained-ocr-v1.0-2020-09-23",
      "displayName": "Google Stable",
      "state": "DEPLOYED",
      "createTime": "2022-09-12T23:35:09.829557Z",
      "googleManaged": true,
      "deprecationInfo": {
        "deprecationTime": "1970-01-01T00:00:00Z"
      }
    }
  ]
}