---
title: "Panduan gaya Prompt"
description: "Cara menulis dan mengedit Prompt agen suara ThunderPhone: pemeriksaan tinjauan Prompt berdasarkan panduan, beserta ID yang dirujuk oleh temuannya."
---

{/*
  FILE YANG DIGENERASI: jangan edit secara manual.
  Sumber: api/agents/prompt_style_guide.md
  Buat ulang: python3 scripts/docs-freshness/generate_prompt_style_guide.py
  CI membuat ulang halaman ini dan gagal jika ada perbedaan
  (scripts/docs-freshness/generators.d/50-prompt-style-guide.sh).
*/}

<Note>
  Ini adalah panduan yang digunakan [peninjauan Prompt](/api-reference/agents#review-a-prompt) untuk memeriksa Prompt, dan
  temuannya merujuk pada ID di bawah. Agen pengodean yang terhubung ke
  [server MCP](/id/guides/thunderphone-mcp-server) membaca teks yang sama sebagai resource
  `thunderphone://guides/prompt-style`. Untuk template dan contoh, lihat
  [panduan Prompt](/id/guides/prompting).
</Note>

Panduan ini ditujukan untuk siapa pun yang menulis atau mengedit Prompt agen suara: seseorang di builder, Copilot, atau agen
pengodean yang bekerja melalui API. Alat peninjauan Prompt menggunakannya sebagai rubrik dan merujuk pada ID panduannya (P1, W2,
dan seterusnya).

Penelepon mendengar agen satu kali, dengan kecepatan berbicara, dan tidak dapat menggulir kembali. Agen membaca Prompt pada setiap
giliran dan mengikuti susunan katanya dengan cermat. Kedua fakta ini membentuk seluruh panduan di bawah.

## Struktur

**P1. Tulis dengan cara seseorang akan memberi pengarahan kepada resepsionis baru.** Pembukaan singkat menjelaskan siapa agen tersebut dan untuk siapa agen tersebut bekerja. Panggilan kemudian mengikuti urutan terjadinya: cara panggilan dimulai, hal yang perlu diketahui, hal yang perlu dikonfirmasi, dan cara panggilan diakhiri. Setiap aturan ditempatkan di bagian panggilan tempat aturan tersebut berlaku. Pembaca seharusnya dapat menanyakan tentang setiap paragraf, "apakah seseorang yang menjalankan bisnis ini bisa mengetik ini?" Hal yang perlu diketahui mencakup hal yang dibutuhkan bisnis untuk menindaklanjuti
permintaan, bukan hanya siapa yang menelepon dan cara menghubungi mereka.

**P2. Judul sederhana, prosa di bawahnya.** Judul seperti "Siapa Anda", "Panggilan", "Fakta", dan "Meneruskan"
membantu. Struktur bergaya mesin tidak membantu: panduan aturan bernomor, judul camelCase atau bergaya kode, daftar panjang
aturan dengan butir tanda pisah, referensi alat di awal, dan rujukan silang seperti "lihat bagian 4 di bawah". Daftar dapat digunakan untuk
data yang dicari agen (jam operasional, harga, alamat).

**P3. Cara berbicara, sekali saja dan singkat.** Cara agen berbicara sepanjang panggilan (tuturan singkat dengan sudut pandang orang pertama,
hangat, kata-kata sederhana; lihat S2) cukup dimuat dalam satu paragraf pendek di dekat bagian atas. Semua hal yang khusus untuk satu langkah ditempatkan di
langkah tersebut.

**P4. Pisahkan fakta dari perilaku.** Jam operasional, harga, lokasi, kebijakan, dan fakta lainnya ditempatkan dalam bagian fakta
pada Prompt atau dalam basis pengetahuan, bukan tersebar di seluruh alur panggilan. Katalog panjang dan FAQ sebaiknya berada dalam
basis pengetahuan. Agen hanya boleh menyampaikan fakta yang diberikan kepadanya.

## Konten

**C1. Prinsip dan fakta, bukan skrip.** Jelaskan apa yang ingin dicapai agen dan apa yang perlu
diketahuinya. Jangan sertakan cabang "jika penelepon mengatakan X, katakan Y", jawaban terskrip untuk pertanyaan yang
diperkirakan, dan kalimat siap pakai. Salam pembuka yang dikonfigurasi adalah satu-satunya elemen terskrip.

**C2. Perbaikan menyatakan prinsip umum.** Saat perubahan Prompt menanggapi kegagalan yang teramati, perubahan tersebut menambahkan
prinsip umum atau fakta yang belum ada, bukan perbaikan untuk satu kasus itu. Detail panggilan yang gagal (nama,
nomor, kata-kata persisnya) tidak dimasukkan ke dalam Prompt.

**C3. Lebih baik mengurangi daripada menambahkan.** Saat kegagalan dapat ditelusuri ke aturan yang ada dan terlalu spesifik, terlalu luas,
atau ditempatkan dengan buruk, ubah atau hapus aturan tersebut alih-alih menambahkan aturan tandingan di sebelahnya.

**C4. Pengaturan menentukan beberapa hal, bukan Prompt.** Ini adalah pengaturan agen, dan teks Prompt tentang hal-hal tersebut
diabaikan atau bertentangan dengannya: apa yang dikatakan saat alat berjalan (kalimat saat alat dimulai, frasa pengisi), pemeriksaan
setelah hening dan tindakan akhir setelah hening, bagaimana pengulangan dibacakan, gaya pergantian bahasa, pemberitahuan
perekaman, serta apakah agen atau penelepon yang berbicara lebih dahulu. Arahkan Prompt pada hasilnya
("konfirmasikan alamat email sebelum Anda menyimpannya"), lalu atur pengaturannya. Salam pembuka itu sendiri ditulis dalam
Prompt.

**C5. Contoh adalah kalimat yang akan diucapkan agen.** Agen menyalin pilihan kata dalam contoh hampir kata demi kata, sehingga setiap
contoh harus berupa kalimat lengkap dan alami untuk diucapkan, dan beberapa contoh yang bervariasi lebih baik daripada satu contoh.
Perkenalkan sebagai contoh ("Misalnya, Anda dapat mengatakan ..."), bukan sebagai kalimat yang wajib diucapkan. Tag singkat seperti
"Masih akurat?" terdengar ringkas saat diucapkan.

**C6. Jangan gunakan contoh dari panggilan pelanggan kami sendiri.** Contoh menjelaskan jenis situasi secara umum atau
menggunakan bisnis rekaan.

**C7. Prompt ditujukan untuk penelepon, bukan tentang proses pembuatan.** Penelepon mendengar apa pun yang dikatakan prompt setelah aktif, jadi jangan sertakan catatan tentang pembuatan, pengujian, atau status kepatuhan ("versi ini untuk pengujian", "TEST" dalam nama pemesanan, "hingga perjanjian ditandatangani"). Jangan sertakan pula penafian, batasan tanggung jawab, dan rangkuman penutup yang tidak diminta bisnis, seperti hal yang tidak ditetapkan oleh penerimaan suatu paket atau ringkasan tentang hal yang masih belum dikonfirmasi. Agen menjawab hal yang ditanyakan penelepon lalu berhenti; bisnis menambahkan batasan jika menginginkannya. Fakta yang belum tersedia atau batasan sistem ditulis sebagai tindakan agen ("untuk harga, tawarkan panggilan balik dari kantor"), bukan sebagai catatan bahwa informasi tersebut tidak diberikan atau tentang cara permintaan dicatat, dan jangan sisakan apa pun dari proses penyusunan, seperti nama atau judul yang tertinggal.

## Perumusan

**W1. Nyatakan apa yang harus dilakukan, dengan jelas, satu kali.** Nyatakan perilaku yang diinginkan sebagai instruksi dengan kata-kata biasa: "Bacakan kembali nomor pesanan digit demi digit agar penelepon dapat mengoreksinya." Nyatakan satu kali, di bagian yang relevan.

**W2. Tanpa penekanan.** Jangan gunakan label IMPORTANT, NOTE, atau CRITICAL, kata-kata berhuruf kapital untuk memberi penekanan, tanda seru,
pasangan "Buruk:" dan "Baik:", atau blok tentang apa yang tidak boleh dilakukan. Kata-kata seperti "tidak pernah", "selalu", dan "harus"
yang digunakan untuk memberi penekanan juga termasuk di sini. Penekanan menarik perhatian Model ke satu aturan dan membuatnya lebih buruk dalam menjalankan sisa
panggilan. Saat agen mengabaikan instruksi, buat instruksi tersebut lebih jelas, lebih spesifik, atau ditempatkan lebih baik, bukan
lebih keras.

**W3. Perbaiki struktur yang menyebabkan perilaku.** Sebelum menambahkan aturan yang melarang sesuatu yang dilakukan agen, temukan
rumusan atau struktur yang mengarahkannya ke sana: template yang diisi Model secara harfiah, istilah yang memiliki dua makna, cabang
if-else yang dibaca secara longgar oleh Model yang cepat. Ubah hal tersebut.

**W4. Spesifik lebih baik daripada umum.** "Tawarkan dua waktu kosong paling awal, lalu tanyakan mana yang cocok" lebih baik daripada "bantu dengan
penjadwalan". Instruksi yang samar menghasilkan perilaku yang samar.

**W5. Cari sebelum menanyakannya.** Saat penelepon menyebut sesuatu yang dapat diperiksa oleh alat pencarian hanya-baca (produk, pesanan, reservasi yang sudah ada), agen memeriksa menggunakan kata-kata yang diberikan penelepon, lalu mengajukan pertanyaan lanjutan hanya jika hasilnya memerlukannya. "Periksa stok produk yang disebutkan penelepon dan sampaikan hasilnya" lebih baik daripada "klarifikasi merek, ukuran, dan varian, lalu periksa stok": agen yang diberi instruksi untuk melakukan klarifikasi terlebih dahulu akan terus bertanya dan pemeriksaan tidak pernah dijalankan. Ini hanya berlaku untuk pencarian. Sebelum menggunakan alat yang membuat reservasi, mengubah, membatalkan, atau menyimpan sesuatu, agen tetap mengonfirmasi detailnya dengan penelepon.

## Ucapan

**S1. Satu pertanyaan per giliran, dan pertanyaan mengakhiri giliran.** Apa pun yang dikatakan setelah pertanyaan akan menimpa jawaban
penelepon. Sampaikan penjelasan apa pun sebelum pertanyaan.

**S2. Giliran singkat, dalam kalimat lisan lengkap.** Gunakan satu atau dua kalimat pendek kecuali penelepon meminta perincian.
Pilihan yang diucapkan dibatasi hanya beberapa. Singkat berarti sedikit kata, bukan terpotong-potong: agen berbicara seperti resepsionis yang baik
di telepon, dalam kalimat lengkap orang pertama, seperti "Saya akan memesankannya untuk Anda sekarang" atau
"Saya sudah menjadwalkan Anda untuk hari Senin pukul sepuluh." Fragmen bergaya catatan ("Memesankannya untuk Anda.", "Selesai.", "Dicatat.")
terdengar ketus saat diucapkan, dan frasa email ("Harap diperhatikan bahwa ...", "Mohon ...", "Semoga ini membantu") terdengar seperti dibacakan,
bukan diucapkan. Paragraf cara berbicara dalam Prompt meminta hal ini secara lugas, misalnya: "Buat setiap giliran terdiri dari satu
atau dua kalimat, dan berbicaralah sebagai orang pertama, seperti resepsionis di telepon."

**S3. Tulis untuk didengar.** Dalam ucapan agen, hindari markdown, simbol, dan notasi yang akan dibaca suara secara aneh
(garis miring, ampersand, "@", ".com", pemisah ribuan, nomor telepon tanpa spasi). Fakta dan nilai yang diteruskan agen
ke alat, seperti alamat email atau nomor akun, tetap dalam bentuk tertulis persisnya; saat nilai tersebut juga harus
diucapkan, tambahkan cara pengucapannya di sebelahnya alih-alih menulis ulang. Tuliskan cara mengucapkan nama atau akronim yang tidak biasa,
dan dengarkan istilah baru dalam suara agen sebelum mempertahankannya.

**S4. Konfirmasikan hal yang akan merugikan jika salah.** Nomor, alamat email, alamat, dan kode dibacakan ulang dalam bentuk
sebagaimana diberikan, satu kali, dalam respons tepat setelah penelepon memberikannya dan sebelum pertanyaan berikutnya, satu nilai per
pembacaan ulang. Secara default, nama diterima sebagaimana diucapkan, tanpa pembacaan ulang, dan agen meminta ejaannya hanya jika nama tersebut
tidak biasa atau tidak jelas, dan hanya sekali. Jika bisnis memerlukan nama yang tepat, misalnya untuk mencocokkannya dengan catatan
atau untuk pemesanan atas nama tersebut, Prompt menyatakannya dan agen mengeja kembali nama itu. Pembacaan ulang adalah kesempatan penelepon untuk
mengoreksi suatu nilai, bukan permintaan konfirmasi wajib: penelepon yang menjawab dengan detail berikutnya atau melanjutkan tanpa mengoreksinya telah
menerimanya, dan nilai yang telah diterima tidak ditanyakan lagi. Nomor telepon yang akan digunakan bisnis untuk menelepon atau mengirim pesan teks kembali adalah
pengecualian: pembacaan ulangnya mengakhiri giliran dan menunggu jawaban penelepon. Prompt yang meminta pembacaan digit demi digit hanya mencantumkan
nilai yang dibaca dengan cara itu (nomor telepon, kode); nomor rumah, harga, waktu, atau tanggal diucapkan sebagaimana orang biasa mengucapkannya.
Prompt menyatakan apa yang perlu dikonfirmasi; Platform mengatur tempo pembacaan ulang.

## Iterasi

**I1. Uji sebelum mempertahankan perubahan.** Putar ulang set dev agen pada draf yang diedit dan bandingkan dengan
versi saat ini: contoh mana yang diperbaiki oleh perubahan, dan mana yang dirusaknya. Baca balasan seperti yang
akan didengar oleh penelepon. Apa pun yang akan disadari oleh penelepon adalah masalah, bukan detail.

**I2. Set hold-out diperiksa sekali.** Lakukan penyetelan hanya pada set dev. Jalankan set pengujian saat perubahan sudah siap, dan
laporkan hasilnya apa adanya. Perubahan yang dibuat setelah melihat hasil pengujian memerlukan contoh pengujian baru.

**I3. Refaktor saat patch menumpuk.** Prompt yang telah mengumpulkan banyak perbaikan kecil menyimpang dari P1: aturan
berulang, bertentangan, atau berada jauh dari langkah yang diaturnya. Kemudian tulis ulang menjadi bentuk ini, sambil mempertahankan setiap perilaku
yang dimintanya. Cantumkan setiap perilaku sebagai dipertahankan, digabungkan, dirumuskan ulang, atau dihapus, dan jangan hapus apa pun secara diam-diam. Putar ulang set dev sebelum dan sesudahnya; refaktor seharusnya mengubah perumusan, bukan perilaku.

**I4. Periksa konfigurasi sebelum Prompt.** Beberapa kegagalan bukan disebabkan oleh Prompt: salah dengar huruf yang dieja adalah batas pendengaran (coba pendengaran Plus), respons yang lambat mungkin disebabkan oleh tingkat kecerdasan atau pendengaran, atau pengaturan endpointing. Singkirkan kemungkinan masalah konfigurasi sebelum menulis ulang teks.
