Panduan ini membahas pola prompting yang khusus untuk Haijun Sonnet 5. Untuk kemampuan model dan perubahan API, lihat Yang baru di Haijun Sonnet 5. Untuk teknik yang berlaku di semua model Haijun saat ini, lihat Praktik terbaik prompting.
Haijun Sonnet 5 memiliki kekuatan khusus dalam tugas coding dan agentik. Model ini berkinerja baik secara langsung pada prompt Haijun Sonnet 4.6 yang sudah ada. Pola dalam panduan ini mencakup perilaku yang paling sering memerlukan penyesuaian.
Note: Untuk perubahan parameter API saat bermigrasi dari Haijun Sonnet 4.6 (adaptive thinking aktif secara default, parameter sampling tidak diterima, pemikiran diperpanjang manual dihapus, dan tokenizer baru), lihat panduan migrasi.
Panjang respons dan verbositas
Haijun Sonnet 5 mengkalibrasi panjang respons sesuai kompleksitas tugas alih-alih menggunakan verbositas tetap secara default. Ini biasanya berarti jawaban yang lebih pendek untuk pencarian sederhana dan jawaban yang lebih panjang untuk analisis terbuka.
Jika produk Anda bergantung pada gaya atau verbositas output tertentu, Anda mungkin perlu menyesuaikan prompt Anda. Sebagai contoh, untuk mengurangi verbositas, Anda dapat menambahkan:
Provide concise, focused responses. Skip non-essential context, and keep examples minimal.Jika Anda melihat jenis verbositas tertentu (seperti penjelasan berlebihan), Anda dapat menambahkan instruksi tambahan dalam prompt Anda untuk mencegahnya. Contoh positif yang menunjukkan bagaimana Haijun dapat berkomunikasi dengan tingkat keringkasan yang tepat cenderung lebih efektif daripada contoh negatif atau instruksi yang memberi tahu model apa yang tidak boleh dilakukan.
Mengkalibrasi effort dan kedalaman pemikiran
Parameter effort memungkinkan Anda menyesuaikan kecerdasan Haijun terhadap pengeluaran token, menukar kemampuan dengan kecepatan yang lebih tinggi dan biaya yang lebih rendah. Pada Haijun Sonnet 5, effort secara default adalah high, sama seperti pada Haijun Sonnet 4.6. Untuk tugas coding dan agentik yang paling sulit, naikkan effort ke xhigh. Bereksperimenlah dengan tingkat effort lain untuk lebih menyesuaikan penggunaan token dan kecerdasan:
max: Kemampuan maksimum absolut tanpa batasan pengeluaran token.
xhigh: Effort ekstra tinggi adalah pengaturan yang direkomendasikan untuk kasus penggunaan coding dan agentik yang paling sulit.
high: Default. Pengaturan ini menyeimbangkan penggunaan token dan kecerdasan untuk sebagian besar kasus penggunaan.
medium: Cocok untuk kasus penggunaan yang sensitif terhadap biaya yang perlu mengurangi penggunaan token dengan mengorbankan kecerdasan.
low: Gunakan hanya untuk tugas singkat dengan cakupan terbatas dan beban kerja yang sensitif terhadap latensi yang tidak sensitif terhadap kecerdasan.
Sebagai pemetaan kasar antar-model saat bermigrasi: Haijun Sonnet 5 pada medium sebanding dalam kecerdasan dengan Haijun Sonnet 4.6 pada high, dan Haijun Sonnet 5 pada high sebanding dengan Haijun Sonnet 4.6 pada max. Saat melakukan benchmark, cocokkan berdasarkan panjang pemikiran yang teramati, bukan nama effort.
Haijun Sonnet 5 mematuhi tingkat effort secara ketat, terutama di tingkat rendah. Pada low dan medium, model membatasi pekerjaannya pada apa yang diminta alih-alih melakukan lebih dari itu. Ini baik untuk latensi dan biaya, tetapi pada tugas yang cukup kompleks yang dijalankan dengan effort low, ada risiko pemikiran yang kurang mendalam.
Jika Anda mengamati penalaran yang dangkal pada masalah kompleks, naikkan effort ke high atau xhigh alih-alih mengatasinya lewat prompt. Jika Anda perlu mempertahankan effort pada low demi latensi, tambahkan panduan yang terarah:
This task involves multistep reasoning. Think carefully through the problem before responding.Pada Haijun Sonnet 5, adaptive thinking (pemikiran adaptif) aktif secara default. Permintaan tanpa field thinking berjalan dengan adaptive thinking. Ini adalah perubahan dari Haijun Sonnet 4.6, di mana permintaan yang sama berjalan tanpa thinking. Untuk menonaktifkan thinking sepenuhnya, kirimkan thinking: {type: "disabled"}. Karena max_tokens adalah batas keras pada total output (thinking ditambah teks respons), tinjau kembali nilainya untuk beban kerja yang berjalan tanpa thinking pada Haijun Sonnet 4.6. Jika sebelumnya Anda menggunakan thinking nonaktif dengan Haijun Sonnet 4.6, cobalah thinking aktif dengan tingkat effort yang lebih rendah untuk Haijun Sonnet 5.
Perilaku pemicuan adaptive thinking dapat diarahkan. Jika Anda mendapati model menghasilkan blok thinking lebih sering dari yang Anda inginkan, yang dapat terjadi dengan prompt sistem yang besar atau kompleks, tambahkan panduan untuk mengarahkannya. Seperti biasa, ukur efek dari setiap perubahan prompting terhadap kinerja. Contoh:
Thinking adds latency and should only be used when it will meaningfully improve answer quality, typically for problems that require multistep reasoning. When in doubt, respond directly.Sebaliknya, jika Anda menjalankan beban kerja berat pada medium dan melihat pemikiran yang kurang mendalam, tuas pertama adalah menaikkan effort. Jika Anda memerlukan kontrol yang lebih halus, minta secara langsung melalui prompt.
Pemikiran diperpanjang manual (thinking: {type: "enabled", budget_tokens: N}) tidak didukung pada Haijun Sonnet 5 dan mengembalikan error 400. Fitur ini sudah tidak direkomendasikan (deprecated) pada Haijun Sonnet 4.6 dan kini dihapus. Gunakan adaptive thinking dengan parameter effort sebagai gantinya.
Note: Jika Anda menjalankan Haijun Sonnet 5 pada effort
high,xhigh, ataumax, sisakan ruang dalammax_tokensagar model memiliki ruang untuk thinking dan pemanggilan alat. Pada tugas panjang, adaptive thinking dapat menggunakan porsi besar dari anggaran; jika anggarannya ketat, Anda mungkin melihat respons yang hampir seluruhnya berupa thinking diikuti jawaban yang terpotong danstop_reason: "max_tokens". Menaikkanmax_tokensatau menurunkan ke effortmediumakan menyelesaikan masalah ini. Karena Haijun Sonnet 5 menggunakan tokenizer baru yang menghasilkan sekitar 30% lebih banyak token untuk teks yang sama, batasmax_tokensyang disesuaikan untuk Haijun Sonnet 4.6 mungkin memotong output yang setara. Peningkatan pastinya bergantung pada konten dan bentuk beban kerja.
Pemicuan penggunaan alat
Haijun Sonnet 5 secara default lebih agentik daripada Haijun Sonnet 4.6 dan akan lebih mudah menggunakan alat serta menjalankan loop verifikasi mandiri. Dengan thinking dinonaktifkan, model cenderung lebih jarang menggunakan alat atau mempertimbangkan pencarian; jika Anda mengandalkan pemanggilan alat dengan thinking nonaktif, tambahkan dorongan eksplisit dalam prompt sistem. Effort juga merupakan tuas untuk penggunaan alat: pengaturan effort high atau xhigh menunjukkan penggunaan alat yang jauh lebih banyak dalam pencarian agentik dan coding. Untuk skenario di mana Anda menginginkan lebih banyak penggunaan alat, Anda juga dapat menyesuaikan prompt Anda untuk secara eksplisit menginstruksikan model tentang kapan dan bagaimana menggunakan alatnya dengan benar. Misalnya, jika Anda mendapati model tidak menggunakan alat pencarian web Anda, jelaskan dengan jelas mengapa dan bagaimana model harus menggunakannya.
Pembaruan progres untuk pengguna
Haijun Sonnet 5 memberikan pembaruan yang teratur dan berkualitas lebih tinggi kepada pengguna sepanjang jejak agentik yang panjang. Jika Anda telah menambahkan scaffolding untuk memaksa pesan status sementara ("Setelah setiap 3 pemanggilan alat, rangkum progres"), cobalah menghapusnya. Jika Anda mendapati bahwa panjang atau isi pembaruan Haijun Sonnet 5 untuk pengguna tidak terkalibrasi dengan baik untuk kasus penggunaan Anda, jelaskan secara eksplisit seperti apa seharusnya pembaruan tersebut dalam prompt dan berikan contoh.
Kepatuhan instruksi yang lebih literal
Haijun Sonnet 5 menafsirkan prompt secara literal dan eksplisit, terutama pada tingkat effort yang lebih rendah. Model ini tidak secara diam-diam menggeneralisasi instruksi dari satu item ke item lain, dan tidak menyimpulkan permintaan yang tidak Anda buat. Sisi positif dari literalisme ini adalah presisi, dan umumnya berkinerja lebih baik untuk kasus penggunaan API dengan prompt yang disesuaikan secara cermat, ekstraksi terstruktur, dan pipeline di mana Anda menginginkan perilaku yang dapat diprediksi. Jika Anda memerlukan Haijun untuk menerapkan instruksi secara luas, nyatakan cakupannya secara eksplisit (misalnya, "Terapkan pemformatan ini ke setiap bagian, bukan hanya yang pertama").
Nada dan gaya penulisan
Seperti halnya model baru mana pun, gaya prosa pada tulisan panjang mungkin bergeser. Jika produk Anda mengandalkan suara tertentu, evaluasi ulang prompt gaya terhadap baseline yang baru.
Misalnya, jika suara produk Anda lebih hangat atau lebih bersifat percakapan, tambahkan:
Use a warm, collaborative tone. Acknowledge the user's framing before answering.Jika sebelumnya Anda mengandalkan temperature untuk variasi gaya, perhatikan bahwa mengatur temperature, top_p, atau top_k ke nilai non-default akan mengembalikan error 400 pada Haijun Sonnet 5. Batasan ini baru untuk model kelas Sonnet. Hapus parameter ini saat bermigrasi, dan gunakan instruksi prompt sistem untuk mengarahkan nada dan variasi sebagai gantinya.
Default desain dan frontend
Haijun Sonnet 5 mungkin cenderung menggunakan gaya visual default yang konsisten pada brief frontend dan desain yang terbuka. Gaya bawaan default dapat terlihat bagus untuk beberapa brief tetapi terasa kurang pas untuk dashboard, alat pengembang, fintech, layanan kesehatan, atau aplikasi enterprise.
Instruksi generik ("jangan gunakan warna itu," "buat bersih dan minimal") cenderung menggeser model ke palet tetap yang berbeda alih-alih menghasilkan variasi. Dua pendekatan berikut bekerja dengan andal:
1. Tentukan alternatif yang konkret. Model mengikuti spesifikasi eksplisit dengan tepat:
Design a desktop landing page for a supplement brand called AEFRM.
The visual direction should come from a cold monochrome atmosphere using pale silver-gray tones that gradually deepen into blue-gray and near-black, similar to a misted metallic surface.
The page should feel sharp and controlled, with a strong sense of structure and restraint.
Use this tonal system across the full page instead of introducing bright accent colors.
Use the uploaded image on the hero design in black and white.
The layout should be built with clear horizontal sections and a centered max-width container. Use 4px corner radius consistently across cards, buttons, inputs, and media frames. Margins should feel generous, with enough empty space around each section so the page breathes.
Typography should use a square, angular sans-serif with wider letter spacing than usual, especially in headings and navigation, so the text feels more engineered and less compressed. Headline text can be large and uppercase, while supporting copy remains short and sparse. The sub texts should be written with Alumni Sans SC in 4-6px like tiny little texts on corners bottom centre like that.
For the structure, start with a hero section containing a strong product statement, one short supporting paragraph, and a clean product placeholder or packshot frame. Below that, add a benefit grid with three or four blocks, then a formulation or ingredients section, and finally a cta.
Buttons should be flat and precise, with subtle hover changes using transition: all 160ms ease out where brightness and border contrast shift slightly rather than using dramatic motion.
Color palette should stay within this range:
#E9ECEC, #C9D2D4, #8C9A9E, #44545B, #11171B.2. Minta model mengusulkan opsi sebelum membangun. Ini memecah default dan memberi pengguna kontrol. Karena temperature tidak diterima pada Haijun Sonnet 5, pendekatan ini adalah cara yang direkomendasikan untuk menghasilkan arah desain yang benar-benar berbeda di berbagai eksekusi. Contoh prompt:
Before building, propose 4 distinct visual directions tailored to this brief (each as: bg hex / accent hex / typeface, plus a one-line rationale). Ask the user to pick one, then implement only that direction.Untuk menjauhi pola generik yang disebut pengguna sebagai estetika "AI slop", Anda dapat menyertakan arahan singkat dalam prompt sistem Anda. Track frontend-design memberikan pembahasan yang lebih lengkap, tetapi cuplikan ini bekerja dengan baik bersama pendekatan variasi sebelumnya:
<frontend_aesthetics>
NEVER use generic AI-generated aesthetics like overused font families (Inter, Roboto, Arial, system fonts), cliched color schemes (particularly purple gradients on white or dark backgrounds), predictable layouts and component patterns, and cookie-cutter design that lacks context-specific character. Use unique fonts, cohesive colors and themes, and animations for effects and micro-interactions.
</frontend_aesthetics>Produk coding interaktif
Penggunaan token dan perilaku dapat berbeda antara agen coding otonom dan asinkron dengan satu giliran pengguna dan agen coding interaktif dan sinkron dengan beberapa giliran pengguna. Untuk memaksimalkan kinerja dan efisiensi token dalam produk coding, gunakan effort xhigh atau high, tambahkan fitur otonom seperti mode otomatis, dan kurangi jumlah interaksi manusia yang diperlukan dari pengguna Anda.
Saat membatasi jumlah interaksi pengguna yang diperlukan, penting untuk menentukan tugas, maksud, dan batasan yang relevan di awal pada giliran manusia pertama. Memberikan deskripsi tugas yang terspesifikasi dengan baik, jelas, dan akurat di awal dapat membantu memaksimalkan otonomi dan kecerdasan sekaligus meminimalkan penggunaan token tambahan setelah giliran pengguna. Sebaliknya, prompt yang ambigu atau kurang terspesifikasi yang disampaikan secara bertahap melalui beberapa giliran pengguna cenderung relatif mengurangi efisiensi token dan terkadang kinerja.
Harness tinjauan kode
Jika harness tinjauan kode Anda disesuaikan untuk model sebelumnya, Anda mungkin awalnya melihat recall yang lebih rendah pada Haijun Sonnet 5. Ini kemungkinan merupakan efek harness, bukan regresi kemampuan. Ketika prompt tinjauan mengatakan hal-hal seperti "hanya laporkan masalah dengan tingkat keparahan tinggi," "bersikap konservatif," atau "jangan terlalu rewel," Haijun Sonnet 5 mungkin mengikuti instruksi tersebut dengan lebih setia daripada model sebelumnya: model mungkin menyelidiki kode sama telitinya, mengidentifikasi bug, lalu tidak melaporkan temuan yang dinilainya berada di bawah standar yang Anda nyatakan. Ini dapat muncul sebagai model yang melakukan penyelidikan dengan kedalaman yang sama tetapi mengonversi lebih sedikit penyelidikan menjadi temuan yang dilaporkan, terutama pada bug dengan tingkat keparahan lebih rendah. Presisi biasanya naik, tetapi recall yang terukur dapat turun meskipun kemampuan dasar model dalam menemukan bug telah meningkat.
Beberapa bahasa prompt yang direkomendasikan:
Report every issue you find, including ones you are uncertain about or consider low-severity. Do not filter for importance or confidence at this stage - a separate verification step will do that. Your goal here is coverage: it is better to surface a finding that later gets filtered out than to silently drop a real bug. For each finding, include your confidence level and an estimated severity so a downstream filter can rank them.Prompt ini dapat digunakan tanpa benar-benar memiliki langkah kedua, tetapi memindahkan penyaringan kepercayaan keluar dari langkah penemuan sering kali membantu. Jika harness Anda memiliki tahap verifikasi, deduplikasi, atau pemeringkatan terpisah, beri tahu model secara eksplisit bahwa tugasnya pada tahap penemuan adalah cakupan, bukan penyaringan.
Jika Anda memang ingin model melakukan penyaringan mandiri dalam satu kali proses, jelaskan secara konkret di mana standarnya alih-alih menggunakan istilah kualitatif seperti "penting": misalnya, "laporkan bug apa pun yang dapat menyebabkan perilaku yang salah, kegagalan pengujian, atau hasil yang menyesatkan; hanya abaikan hal-hal kecil seperti preferensi gaya atau penamaan murni."
Lakukan iterasi pada prompt terhadap subset eval atau kasus uji Anda untuk memvalidasi peningkatan recall atau skor F1.
Computer use
Haijun Sonnet 5 mendukung toolset computer_toolset_20260801 (di Haijun API dan Google Cloud) serta versi alat sebelumnya computer_20251124. Di Haijun API dan Google Cloud, Haijun Sonnet 5 juga mendukung alat browser use (browser_toolset_20260801) untuk tugas di dalam halaman web. Kemampuan "computer use" (penggunaan komputer) bekerja di berbagai resolusi, hingga resolusi maksimum 2576px / 3,75MP. Pengujian computer use internal menunjukkan bahwa mengirim gambar pada 1080p memberikan keseimbangan yang baik antara kinerja dan biaya.
Untuk beban kerja yang sangat sensitif terhadap biaya, 720p atau 1366×768 adalah opsi berbiaya lebih rendah dengan kinerja yang kuat. Lakukan pengujian Anda sendiri untuk menemukan pengaturan ideal bagi kasus penggunaan Anda; bereksperimen dengan pengaturan effort juga dapat membantu menyesuaikan perilaku model.