Middleware SDK

SDK Anthropic menyediakan hook "middleware" (perangkat lunak perantara) atau interceptor yang memungkinkan Anda menjalankan kode sebelum permintaan dikirim dan setelah respons diterima. Gunakan middleware untuk kebutuhan lintas fungsi seperti logging, percobaan ulang kustom, anotasi permintaan, dan penanganan fallback penolakan.

Setiap middleware dapat memeriksa atau mengganti permintaan sebelum memanggil next(), dan respons setelah next() mengembalikan hasil.

Mendaftarkan middleware

Setiap middleware adalah fungsi yang menerima permintaan keluar dan sebuah callable next. Panggil next untuk meneruskan permintaan ke bagian rantai berikutnya (atau langsung ke inti SDK jika ini adalah middleware terakhir), dan kembalikan responsnya. Apa pun yang ada sebelum pemanggilan next dijalankan saat permintaan keluar; apa pun yang ada setelahnya dijalankan saat respons kembali.

Urutan middleware

Ketika Anda mendaftarkan beberapa middleware, middleware tersebut diterapkan sesuai urutan yang diberikan: kode "before" dari middleware pertama dijalankan terlebih dahulu, dan kode "after"-nya dijalankan terakhir. Middleware yang didaftarkan pada klien dijalankan sebelum middleware yang diteruskan sebagai opsi per permintaan.

Di SDK Go, pemanggilan option.WithMiddleware yang berulang akan digabungkan (klien terlebih dahulu, kemudian metode). Di SDK lainnya, teruskan sebuah array; entri yang lebih belakang membungkus yang lebih dalam.

Mengganti klien HTTP

Setiap SDK juga menerima klien HTTP kustom (untuk konfigurasi proxy, TLS kustom, atau connection pooling). Hanya satu klien HTTP yang digunakan per klien SDK; mengaturnya akan menggantikan klien default. Klien HTTP kustom menerima permintaan setelah semua middleware selesai dijalankan.

Middleware bawaan

SDK menyertakan middleware refusal-fallback yang secara otomatis mencoba ulang permintaan yang ditolak oleh Claude Fable 5 pada model fallback. Lihat Mendeteksi dan mencoba ulang pada model fallback untuk pengaturan dan contoh per bahasa.