TanStack AI 1.0 mempermudah pergantian model dan memperjelas tanggung jawab aplikasi

Diagram editorial orisinal oleh Ken Jo, berdasarkan sumber yang tercantum di bawah.

Mengganti model seharusnya menjadi keputusan produk. Namun, dalam aplikasi yang menumpuk format pesan khusus penyedia, status peramban, dan callback alat, keputusan itu dapat berubah menjadi proyek migrasi sebelum siapa pun membandingkan jawaban baru.

TanStack AI 1.0, diumumkan pada 23 Oktober 2026, memberikan komitmen konkret pada batas tersebut: API inti yang stabil, 23 adaptor penyedia, dan dukungan beberapa framework UI. Kerangka eksekusi agen atau harness barunya masih eksperimental. Saat memilih dasar pengembangan hari ini, perbedaan ini lebih penting daripada nomor versi. Pengumuman TanStack.

TanStack mengembangkan pustaka sumber terbuka bagi pengembang aplikasi. Rilis ini membahas perangkat lunak antara model AI dan produk: respons streaming, alat, antarmuka, dan status aplikasi. Mari menilai janji portabilitasnya, manfaatnya dalam tiga proyek umum, dan persiapan aplikasi 0.x sebelum ditingkatkan.

Contoh resmi TanStack AG-UI, © 2025 Tanner Linsley, lisensi MIT. Gambar menunjukkan antarmuka contoh proyek dan model pilihannya, bukan eksekusi yang dilakukan untuk artikel ini.

Antarmuka bersama memperkecil perubahan penyedia

Adaptor menerjemahkan ekspektasi aplikasi ke API penyedia. Pengembang memperoleh titik yang konsisten untuk meminta respons model dan mengonsumsi hasilnya. Aplikasi dapat mempertahankan tampilan percakapan serta aturan bisnis sambil mengganti bagian yang menghadap penyedia.

Bayangkan lapisan ini sebagai sentral sambungan. Ia membuat koneksi mudah dipahami tanpa menjadikan seluruh sistem di ujung lain identik. Ini berguna justru karena model, hosting, dan kebutuhan produk berubah secara terpisah.

Pengumuman 23 Oktober menjelaskan 23 adaptor serta opsi kompatibel OpenAI untuk layanan dengan bentuk API tersebut. Pengumuman juga memisahkan inti stabil dari paket harness eksperimental. Ini adalah komitmen kompatibilitas dan pemeliharaan, bukan janji bahwa semua penyedia mendukung setiap fitur model. Cakupan rilis.

Karena itu, pertanyaan pertama harus spesifik: bagian aplikasi mana yang tetap bertahan setelah penyedia diganti? Perender respons mungkin mudah dipindahkan. Alur yang mengandalkan pengenal berkas penyedia, perilaku alat yang tidak biasa, atau asumsi keluaran khusus model masih dapat memerlukan perubahan yang disengaja.

Menurut kami, inilah ukuran kemajuan yang tepat. Portabilitas bernilai ketika mengurangi kode produk yang perlu diperiksa kembali. Jumlah penyedia yang didukung kurang berarti dibanding keberhasilan mengganti dependensi yang memang perlu diubah produk nyata.

Aplikasi tetap menentukan arti keberhasilan

API bersama tidak membuat dua model mengambil keputusan setara. Satu mungkin lebih patuh pada kontrak keluaran terstruktur; yang lain bereaksi berbeda terhadap percakapan panjang atau hasil alat yang ambigu. Adaptor menormalkan jalur permintaan tanpa membuktikan bahwa jawaban memenuhi kebutuhan aplikasi.

Ini berdampak pada pengujian. Pisahkan tes integrasi penyedia dari contoh yang mendefinisikan perilaku produk yang dapat diterima. Permintaan yang selesai dengan benar menguji satu kontrak; jawaban akurat, pemilihan alat yang tepat, dan antarmuka yang jelas menguji kontrak lain.

Misalnya, asisten dukungan memiliki alat untuk mencari pesanan dan alat untuk menyiapkan permintaan pengembalian dana. Kedua penyedia mungkin memanggilnya dengan benar di tingkat protokol. Yang penting adalah apakah setiap model memilih operasi tepat, mematuhi otorisasi yang sama, dan menjelaskan hasil secara akurat.

Sebelum berganti, gunakan kumpulan evaluasi kecil dengan nama yang jelas. Sertakan permintaan tidak lengkap, masukan tidak lazim, alat yang tidak tersedia, dan percakapan yang dilanjutkan setelah giliran sebelumnya. Ini prosedur rekayasa yang disarankan, bukan benchmark TanStack. Tujuannya adalah mengulang definisi keberhasilan tim sendiri.

Adaptor dapat mempertahankan kontrak koneksi. Evaluasi khusus aplikasi menentukan apakah perilaku di ujung lain masih dapat diterima.

Tiga proyek memperlihatkan portabilitas berbeda

Pertama, pertimbangkan aplikasi layanan pelanggan yang sudah memiliki akun, izin, dan riwayat percakapan. Respons streaming harus sesuai dengan produk tanpa mengganti navigasi atau tanggung jawab data. Lapisan AI bersama menarik jika tim dapat mempertahankan struktur tersebut dan mengevaluasi penyedia di belakangnya.

Dalam proyek ilustratif ini, mulailah dengan pencarian bantuan hanya-baca. Periksa apakah jawaban mengutip bahan yang diberikan dan apakah pembatalan meninggalkan status percakapan yang masuk akal. Tambahkan tindakan setelah antarmuka membedakan usulan dari operasi yang selesai. Pergantian model nantinya harus memakai pemeriksaan yang sama.

Skenario kedua adalah alat penulisan internal. Tim ingin pengguna memilih paragraf, meminta revisi, lalu membandingkannya dengan versi asli. Antarmukanya editor, bukan jendela chat biasa. Integrasi tanpa UI yang dipaksakan berguna karena produk harus menentukan tempat teks muncul dan kapan seseorang menerimanya.

Di sini, portabilitas harus menjaga pekerjaan pengguna. Jangan menimpa paragraf asli hanya karena streaming selesai. Pisahkan saran, izinkan pemeriksaan, dan tetapkan cara membuang generasi yang dihentikan atau gagal. Pilihan ini tetap menjadi tanggung jawab aplikasi, apa pun SDK penyedia alirannya.

Skenario ketiga melibatkan backend yang sudah ditulis dalam bahasa lain. Contoh AG-UI resmi TanStack menghubungkan klien React ke enam bahasa backend melalui Server-Sent Events. README menjelaskan bahwa server menerapkan protokol komunikasi tanpa paket TanStack di sisi server. Contoh resmi multibahasa.

Contoh ini membuat portabilitas konkret. Tim dapat mengevaluasi antarmuka peramban tanpa segera menulis ulang backend yang berfungsi. Mereka tetap harus menerapkan peristiwa yang diharapkan, melindungi endpoint, dan menghubungkan status percakapan dengan pengguna sendiri. Demonstrasi protokol kompatibel adalah awal pekerjaan itu.

Skenario ini menjelaskan mengapa keputusan tersebut lebih luas daripada membandingkan pustaka chat. Pertanyaannya adalah seberapa banyak produk tetap koheren ketika satu komponen berubah. Meski memakai model sama, tim berbeda mementingkan batas yang berbeda.

Inti stabil dan harness eksperimental memerlukan keputusan terpisah

Rilis ini menegaskan komitmen inti 1.0, sementara harness agen baru tetap memakai API eksperimental 0.x. Catat keduanya sebagai pilihan dependensi berbeda. Memasang keduanya tidak memperluas jaminan stabilitas inti ke harness. Pengumuman 23 Oktober.

Untuk fungsi terbatas, siklus hidup sederhana sering lebih mudah dipahami: permintaan datang, model bekerja, aplikasi menangani hasil. Agen yang berjalan lebih lama menambah pertanyaan tentang pesan serentak, pemulihan, status tersimpan, dan tindakan yang melampaui koneksi peramban. Harness menawarkan tempat untuk mengatur masalah tersebut.

Label eksperimental adalah fakta pemeliharaan, bukan alasan menghindari semua percobaan. Pisahkan evaluasi dari jalur kritis produk, tetapkan penanggung jawab, dan sediakan ruang untuk perubahan API. Prototipe dapat menunjukkan manfaat interaksi panjang sebelum tim berkomitmen mengoperasikannya.

Jika tujuan saat ini hanya jawaban streaming pada layar yang ada, mulailah dari sana. Tambahkan orkestrasi ketika alur pengguna memerlukannya. Abstraksi yang lebih kaya harus menyelesaikan masalah siklus hidup konkret, bukan menjadi syarat setiap fitur AI kecil.

Mulai dengan interaksi kecil yang lengkap

Panduan saat ini menghubungkan rute server, kredensial penyedia, dan antarmuka framework. Contoh React memakai panggilan model di server dan SSE dengan pengenal percakapan eksplisit. Kunci API dijauhkan dari peramban. Panduan awal, diperiksa 27 Oktober 2026.

Untuk evaluasi awal, jalankan urutan berikut di cabang pengembangan terpisah. Sasarannya adalah satu interaksi yang dapat diperiksa dari permintaan sampai hasil. Tidak perlu memigrasikan infrastruktur yang tidak terkait hanya untuk mengetahui kecocokan integrasi.

1. Pilih satu layar yang ada dan satu tugas terbatas. Pertanyaan hanya-baca tentang bahan bantuan lebih mudah diperiksa daripada alur yang langsung mengubah catatan pelanggan.
2. Pasang paket stabil antarmuka tersebut bersama-sama. Untuk titik awal React/OpenAI yang didokumentasikan, gunakan npm i @tanstack/ai@^1 @tanstack/ai-react@^1 @tanstack/ai-openai@^1. Commit lockfile agar versi yang dievaluasi dapat dikenali.
3. Terapkan batas server dari panduan terbaru. Simpan kredensial di lingkungan server. Hubungkan permintaan dengan pengguna terautentikasi dan pengenal percakapan milik aplikasi.
4. Tampilkan streaming, penyelesaian, dan pembatalan dengan jelas. Pengguna harus tahu apakah jawaban masih datang, selesai, atau terputus. Pertahankan masukannya ketika permintaan gagal.
5. Jalankan tugas sama dengan penyedia kedua yang didukung. Jangan ubah sumber dan kasus evaluasi. Catat perbedaan perilaku terpisah dari perubahan integrasi.
6. Tinjau hasil sebagai fitur produk. Sebelum memperluas, periksa tampilan pengguna, data yang disimpan, dan kegagalan yang membutuhkan intervensi.

Prosedurnya sengaja kecil agar dapat diulang. Jawaban berhasil menggembirakan, tetapi kegagalan yang dapat dipahami sama informatifnya. Abstraksi yang berguna memudahkan pemeliharaan kedua jalur.

Peningkatan dari 0.x juga mencakup data

Panduan migrasi menghapus API yang telah dinyatakan usang pada 0.x dan menjelaskan pembaruan paket terkoordinasi. Percakapan, eksekusi, dan berkas tersimpan juga menjadi persoalan terpisah. Karena itu, lolos pemeriksaan tipe hanya membuktikan sebagian kesiapan. Panduan 1.0, diperiksa 27 Oktober.

Ini mudah terlewat ketika aplikasi tampak sehat pada sesi peramban baru. Percakapan baru dapat berhasil sementara percakapan lama memiliki status yang tidak dapat dilanjutkan klien baru. Migrasi harus mencakup catatan tersimpan yang representatif, bukan hanya permintaan baru.

Panduan membedakan penggantian nama properti dari pemberian nilai yang benar. threadId eksplisit membutuhkan model kepemilikan nyata; penyuntingan otomatis tidak bisa menentukan cara rute atau basis data mengidentifikasi percakapan. Opsi body yang mirip di bagian API lain juga tidak boleh diubah melalui penggantian teks sembarangan.

Gunakan codemod terdokumentasi dalam mode pratinjau, periksa diff, dan tingkatkan paket stabil klien serta server bersama. Kemudian ikuti langkah data tersimpan dalam lingkungan uji sebelum penerapan. Pertahankan paket harness eksperimental di jalur rilis yang didokumentasikan, tanpa menganggap semua paket terkait memiliki versi utama sama.

Peningkatan selesai ketika percakapan lama dan antarmuka masih bekerja, selain kode baru yang berhasil dikompilasi.

Definisikan pemeriksaan rilis melalui perilaku yang terlihat pengguna. Buka dan lanjutkan percakapan lama, batalkan respons lain, dan jalankan alur alat yang diizinkan serta ditolak. Pastikan keputusan izin masih terkait pengguna yang tepat. Ini membuat dampak migrasi dapat ditinjau tanpa menjadikan versi SDK sebagai skor kualitas.

Portabilitas adalah kemampuan berubah yang dipelihara

TanStack AI 1.0 memberikan arah berguna bagi tim yang ingin memilih model dan antarmuka secara sadar. Alasan adopsi terkuat adalah aplikasi dengan batas jelas yang bisa disederhanakan pustaka. Yang terlemah mengharapkan adaptor menghapus seluruh perbedaan perilaku penyedia.

Ujian praktis datang pada perubahan kedua: penyedia lain, percakapan dilanjutkan, kontrak alat diperbarui, atau catatan lama dibuka klien baru. Jaga perubahan tersebut tetap teramati, maka portabilitas menjadi kemampuan operasional, bukan janji dalam dokumen arsitektur.

Sumber

• Pengumuman TanStack AI 1.0, 23 Oktober 2026.
• Panduan awal TanStack AI, diperiksa 27 Oktober 2026.
• Peningkatan ke 1.0, diperiksa 27 Oktober 2026.
• Contoh AG-UI resmi multibahasa dan lisensi MIT, diperiksa 27 Oktober 2026. Skenario dan prosedur bersifat ilustratif; tidak dilakukan benchmark perbandingan penyedia.

Rekomendasi dari Telli.sh

Simpan permintaan, sumber, dan keputusan di balik integrasi AI dalam koleksi referensi yang bisa dicari. Buat akun Telli.sh untuk mengatur catatan proyek dan bahan peninjauan.