Open in
Langkah dan handoff agen
Bagi agen menjadi beberapa langkah dengan instruksi, alat, dan nilai yang dikumpulkan masing-masing, serta alihkan panggilan antaragen di tengah panggilan.
Satu Prompt memberi model seluruh tugas sekaligus. Langkah memberinya satu fase panggilan dalam satu waktu: setiap langkah memiliki instruksi, alat, baris opsional yang diucapkan kata demi kata, serta nilai yang harus dikumpulkan sebelum berlanjut. Serah terima memungkinkan agen lain di organisasi Anda mengambil alih di tengah panggilan, dengan transkrip tetap utuh, sehingga penelepon tidak perlu mengulanginya.
Setiap agen dimulai sebagai satu Prompt. Tidak ada yang berubah hingga Anda menambahkan langkah atau serah terima.
Langkah atau satu Prompt?
| Gunakan langkah ketika | Pertahankan satu Prompt ketika |
|---|---|
| Panggilan memiliki fase yang harus terjadi secara berurutan: verifikasi, lalu jadwalkan. | Percakapan bersifat terbuka: FAQ, resepsionis, dukungan umum. |
| Nilai harus dikumpulkan sebelum agen melanjutkan. | Tidak ada yang harus dikumpulkan dalam urutan tetap. |
| Aturan tidak boleh dilanggar, seperti "penelepon di bawah 18 tahun dialihkan ke wali". | Pertimbangan model cukup baik untuk setiap cabang. |
| Pencarian harus dijalankan pada titik tertentu dalam panggilan. | Alat dapat dipanggil kapan pun penelepon meminta. |
| Sebagian panggilan menjadi tanggung jawab agen lain, dengan Prompt dan suara sendiri. | Satu persona menangani semuanya. |
Langkah bukanlah pohon telepon berskrip. Dalam sebuah langkah, model menjalankan percakapan seperti saat menggunakan satu Prompt. Langkah menentukan hal yang sedang dikerjakan, alat yang dapat digunakan, dan hal yang diperlukan sebelum dapat keluar.
Cara agen dengan langkah dibuat
Saat agen memiliki langkah, prompt menyimpan instruksi bersama: persona
dan aturan yang berlaku di setiap langkah. Setiap langkah menambahkan
instruksinya sendiri di atasnya. Pada setiap giliran, model melihat instruksi
bersama, nama dan instruksi langkah saat ini, serta nilai yang telah
dikumpulkan.
Di Editor agen, buka Instruksi dan pilih Pisahkan menjadi langkah di bawah judul Prompt. Zeus mengusulkan langkah-langkah tersebut, menampilkan setiap bagian Prompt di samping langkah yang dihasilkan; Gunakan langkah ini mempertahankannya dan Pertahankan satu Prompt kembali ke tampilan sebelumnya. Setelah itu, kerangka menampilkan Instruksi bersama dan setiap langkah. Halaman langkah memuat namanya, baris pertamanya secara persis, instruksinya, nilai yang dikumpulkannya, serta alat yang dapat digunakannya, dan di sampingnya tujuan langkah berikutnya serta asal transisinya. Alur menampilkan langkah-langkah sebagai grafik. Serah-terima ke agen lain tersedia di Alat & serah-terima.
Simpan pada sebuah langkah menyimpan langkah tersebut dalam draf; penelepon mendapatkannya setelah Anda memilih Terapkan di header agen. Sakelar Satu Prompt / Langkah pada Instruksi bersama mengembalikan agen menjadi satu Prompt yang menggabungkan instruksi bersama dan setiap langkah. Dalam tampilan lama, sakelar Prompt tunggal / Langkah di builder melakukan hal yang sama.
Melalui API, steps dan handoffs adalah properti pada
agen. Seperti setiap properti agen, PATCH menyimpannya
dalam draf; POST /v1/agents/{agent_id}/deploy menerapkannya. Mengirim
"steps": null mengembalikan agen ke satu Prompt. Panggilan pengujian
menjalankan draf.
Field langkah
| Field | Arti |
|---|---|
id | Wajib. Huruf kecil, angka, dan garis bawah, diawali dengan huruf, hingga 40 karakter. Unik dalam agen. |
name | Nama tampilan wajib, 1 hingga 80 karakter. |
instructions | Wajib, hingga 20.000 karakter. Mendukung variabel panggilan {{var}}, seperti prompt. |
say | Baris opsional yang diucapkan kata demi kata saat langkah dimasuki, hingga 1.000 karakter. Mendukung {{var}}. |
tools | null memberi langkah setiap alat yang terpasang pada agen. Daftar membatasi langkah pada alat tersebut, berdasarkan nama. Tindakan bawaan seperti end_call dan transfer_call mengikuti pengaturan agen di setiap langkah. |
collect | Hingga 20 nilai yang dikumpulkan langkah. Masing-masing memiliki name, type, description, dan required (default true). |
on_enter_tool | Nama alat opsional, dipanggil secara otomatis saat langkah dimasuki. Lihat langkah Webhook. |
transitions | Daftar berurutan tujuan langkah berikutnya. Lihat Transisi. |
global_when | Opsional. Membuat langkah dapat dijangkau dari langkah mana pun. Lihat Langkah global. |
voice | ID suara opsional untuk langkah ini. Diabaikan saat agen menggunakan konfigurasi suara kustom. |
Grafik itu sendiri adalah {"start_step": "<step id>", "steps": [...]}. Panggilan
dimulai di start_step.
Transisi
Setiap transisi memiliki to, ID langkah, dan tepat satu dari:
when: bahasa biasa, dan model yang memutuskan. Agen mendapatkan alatgo_to_stepbawaan yang mencantumkan langkah yang dapat dituju, dengan setiapwhensebagai alasan untuk memilihnya.condition: aturan pada nilai yang dikumpulkan, dan kode yang memutuskan. Model tidak dapat melewatinya atau mengakalinya melalui percakapan."always": true: lanjut tanpa pemeriksaan. Kode memutuskan terlebih dahulu: segera setelah sebuah langkah dimasuki, atau setelah nilai wajibnya dikumpulkan, transisiconditionataualwayspertama yang cocok akan dipilih, sebelum model dapat memilihwhen. Jadi, letakkanalwayssetelah kondisi sebagai fallback, atau gunakan sendiri untuk menghubungkan satu langkah langsung ke langkah berikutnya. Langkah denganalwaystidak pernah menunggu pilihanwhen.
Sebuah condition adalah {"value": <collected name or dotted path>, "op": <op>, "target": <literal>}:
op | Bernilai benar ketika nilai |
|---|---|
eq, ne | sama dengan, atau tidak sama dengan, target |
lt, lte, gt, gte | kurang dari, paling banyak, lebih besar dari, atau setidaknya target |
in, not_in | merupakan, atau bukan merupakan, salah satu nilai dalam daftar target |
exists, missing | telah, atau belum, dikumpulkan (tanpa target) |
eq, ne, in, dan not_in membandingkan teks tanpa membedakan huruf besar-kecil
setelah spasi dihapus. Angka dibandingkan sebagai angka dan tanggal sebagai string
YYYY-MM-DD. Nilai yang belum pernah dikumpulkan membuat setiap op bernilai salah,
kecuali missing.
Tulis when dan global_when sebagai kondisi, seperti "Penelepon ingin
membuat janji temu", bukan sebagai sesuatu untuk diucapkan. Agen melihatnya sebagai
catatan perutean internal dan diinstruksikan untuk tidak pernah membacakannya atau
menyebutkan bahwa ia sedang mengubah langkah.
Saat model memanggil go_to_step:
- Setiap nilai
requireddalam langkah harus ada. Jika ada yang belum tersedia, model diberi tahu nilai yang mana dan akan memintanya kepada penelepon. - Nilai disimpan.
- Transisi
conditiondanalwaysdiperiksa secara berurutan. Kecocokan pertama yang dipilih. - Jika tidak, agen berpindah ke langkah yang dipilih model.
- Jika tidak ada yang cocok dan model tidak menyebutkan langkah, agen tetap berada di langkah saat ini.
Lompatan ke langkah global adalah pengecualian: penelepon telah mengubah topik, sehingga agen tetap melanjutkan meskipun langkah saat ini masih memiliki nilai wajib yang belum tersedia, dan sebelum kondisi langkah tersebut diperiksa.
Transisi condition dan always juga diperiksa setiap kali sebuah langkah dimasuki,
sehingga rangkaian langkah yang diputuskan oleh kode berjalan sekaligus. Rangkaian berhenti:
- pada langkah yang sudah dikunjungi dalam eksekusi ini;
- setelah 8 lompatan;
- pada langkah yang masih memiliki nilai wajib untuk dikumpulkan, kecuali langkah tersebut memiliki
on_enter_tool(langkah webhook selalu merutekan berdasarkan hasilnya).
Hanya baris say dari langkah tempat rangkaian berhenti yang diucapkan.
Langkah tanpa transisi bersifat terminal. Agen selesai di sana dan mengakhiri atau mentransfer panggilan dengan tindakan bawaan normalnya.
Mengumpulkan nilai
Cantumkan kebutuhan sebuah langkah dalam collect. Model meneruskan nilainya saat memanggil
go_to_step, dan nilainya tetap tersedia selama sisa panggilan.
type | Menyimpan |
|---|---|
string | Teks apa pun |
number | Angka |
boolean | true atau false |
date | Tanggal sebagai YYYY-MM-DD |
Nilai yang dikumpulkan merupakan konten panggilan. Nilai tersebut muncul pada panggilan di samping transkrip dan mengikuti aturan retensi, penghapusan, dan penyuntingan yang sama. Saat perekaman panggilan agen dinonaktifkan, nilai yang dikumpulkan tidak disimpan maupun dikirim dalam webhook; linimasa langkah tetap tersedia. Lihat Tempat melihatnya dalam panggilan.
Baris say
say diucapkan persis seperti yang tertulis saat agen memasuki langkah tersebut. Model
kemudian melanjutkan di langkah baru dalam balasan yang sama, dengan mengetahui bahwa baris tersebut baru saja
diucapkan, sehingga tidak mengulanginya. Gunakan say untuk salam, pengungkapan yang
wajib, dan frasa tetap, lalu serahkan sisa balasan kepada Model.
say pada langkah awal adalah baris pembuka agen saat agen berbicara terlebih dahulu, setelah
pengumuman persetujuan apa pun. Saat penelepon berbicara terlebih dahulu, ini membuka balasan pertama agen
kepada seseorang, bukan kepada IVR atau salam pesan suara.
say pada suatu langkah tidak diucapkan lagi saat panggilan kembali ke langkah tersebut melalui
__previous__ atau serah kembali. Tulis sesuai bunyinya: eja semua hal yang mungkin
salah dibaca oleh suara. Baris say mendukung variabel panggilan {{var}}, tetapi bukan nilai
yang dikumpulkan.
Langkah webhook
Atur on_enter_tool ke salah satu tool agen dan tool tersebut akan berjalan segera setelah langkah
dimasuki, tanpa menunggu Model. Argumennya adalah nilai yang dikumpulkan dengan
nama yang sesuai dengan nama parameter tool. Hasilnya disimpan sebagai nilai yang
dikumpulkan bernama <tool>_result, dipangkas hingga 4 KB, dan transisi
condition serta always pada langkah tersebut langsung diperiksa, sehingga pencarian
dapat merutekan panggilan berdasarkan hasilnya sendiri.
Nilai yang disimpan memiliki dua field:
| Field | Berisi |
|---|---|
status | Kode status HTTP yang dikembalikan endpoint Anda. |
response | Isi respons. |
Rutekan berdasarkan field isi dengan lookup_account_result.response.<field>, dan berdasarkan
kode status dengan lookup_account_result.status.
Pencarian berjalan hingga 8 detik, atau timeout tool itu sendiri jika lebih singkat. Jika membutuhkan waktu lebih dari 3 detik, agen mengucapkan baris singkat agar penelepon tidak dibiarkan dalam keheningan. Jika endpoint Anda mengembalikan status 400 atau lebih tinggi, atau tidak menjawab tepat waktu, agen memberi tahu penelepon bahwa agen tidak dapat memeriksanya saat ini dan melanjutkan dengan hal yang dapat dilakukan.
Langkah global
Langkah dengan global_when dapat dicapai dari langkah mana pun setiap kali
deskripsi tersebut berlaku. Model yang memutuskan, seperti pada when. Gunakan ini untuk topik yang
dapat diajukan penelepon kapan saja: pertanyaan tagihan, permintaan untuk manusia, atau
keluhan.
Transisi dengan "to": "__previous__" pada langkah global mengembalikan panggilan ke
langkah yang aktif sebelumnya, sehingga penelepon melanjutkan dari tempat mereka berhenti.
Langkah tersebut dilanjutkan: on_enter_tool-nya tidak berjalan lagi, say-nya
tidak diulang, dan agen melanjutkannya tanpa memulai dari awal.
Pengalihan
handoffs mencantumkan agen lain di organisasi Anda yang dapat mengambil alih panggilan:
[{"agent_id": 413, "when": "The caller asks about billing or a refund"}]Agen mendapatkan alat hand_off bawaan dengan agen dan alasan tersebut. Seperti
transisi, setiap when adalah catatan perutean internal dan tidak pernah dibacakan.
Saat mengalihkan, agen mengucapkan satu kalimat singkat yang memberi tahu penelepon ke mana mereka akan dialihkan, seperti "Tentu, saya akan mengalihkan Anda ke tim penagihan kami", dengan suaranya sendiri. Kemudian Prompt, langkah, alat, dan suara agen tujuan mengambil alih, dan panggilan berlanjut dengan transkrip yang sama. Agen baru memperkenalkan dirinya secara singkat dan menjawab permintaan terakhir penelepon; agen tersebut tidak mengumumkan pengalihan. Basis pengetahuan agen tujuan tersedia sejak saat itu.
Saat pertama kali panggilan mencapai suatu agen, panggilan dimulai pada
start_step agen tersebut: on_enter_tool langkah dijalankan dan say-nya diucapkan. Saat
panggilan dialihkan kembali ke agen yang sudah pernah dikunjungi, agen tersebut melanjutkan
langkah yang sedang dijalankannya, tanpa menjalankan on_enter_tool, mengulangi say-nya,
atau memperkenalkan diri lagi. Nilai yang dikumpulkan dibagikan kepada setiap agen dalam
panggilan.
- Agen tujuan harus merupakan agen dalam organisasi yang sama, dan agen tidak dapat melakukan handoff ke dirinya sendiri.
- Semua pengaturan tingkat panggilan tetap pada agen yang menjawab: produk, bahasa, siapa yang berbicara terlebih dahulu, pesan suara, pengumuman persetujuan, dan setiap pengaturan panggilan lainnya.
- Agen tujuan dapat melakukan handoff lebih lanjut, termasuk kembali. Satu panggilan dapat menjangkau hingga 8 agen.
- Panggilan uji menjalankan draf agen yang Anda uji. Agen yang menerima handoff menjalankan versi yang telah di-deploy.
- Jika dua agen memiliki tool dengan nama yang sama tetapi definisi berbeda, hanya satu yang dipertahankan untuk panggilan, dan tool milik agen yang menjawab selalu diprioritaskan. Aplikasi memberi peringatan saat Anda menyimpan.
- Agen dapat memiliki handoff tanpa langkah. Seluruh Prompt-nya digunakan apa adanya.
go_to_step dan hand_off dicadangkan pada agen dengan langkah atau pengalihan, sehingga
alat Anda sendiri tidak dapat menggunakan nama tersebut.
Tempat melihatnya pada panggilan
Buka panggilan di Riwayat Panggilan. Linimasa langkah di samping transkrip menampilkan setiap langkah yang dimasuki panggilan beserta alasannya, dan nilai yang dikumpulkan tercantum bersamanya.
Objek panggilan dan webhook penyelesaian panggilan
(telephony.complete / web.complete) memuat
data yang sama sebagai steps_trace dan collected_values. Keduanya tidak ada pada panggilan
tanpa langkah.
"steps_trace": [
{"t_ms": 0, "agent": "a412", "step": "greet", "via": "start"},
{"t_ms": 51230, "agent": "a412", "step": "verify", "via": "model"},
{"t_ms": 98410, "agent": "a412", "step": "minor", "via": "condition"}
],
"collected_values": {"full_name": "Dana Reyes", "dob": "2010-04-02", "age": 15}agent adalah a yang diikuti ID agen. via menjelaskan apa yang memindahkan panggilan:
via | Arti |
|---|---|
start | Panggilan dimulai pada langkah ini. |
model | Model memilih langkah melalui go_to_step, when, atau global_when. |
condition | Transisi condition atau always cocok. |
on_enter | Transisi cocok berdasarkan hasil langkah webhook. |
handoff | Agen lain mengambil alih. |
Tempat langkah dijalankan
Langkah berjalan secara native pada setiap agen (dan pada nilai produk versi lama), pada panggilan masuk, keluar, dan kampanye, panggilan uji, serta panggilan web dan widget.
Di tempat lain, agen tetap berfungsi, hanya tanpa struktur: agen menjalankan Prompt yang diratakan yang menggabungkan instruksi bersama dan setiap langkah, secara berurutan. Ini mencakup:
- sesi Realtime, termasuk sesi untuk agen tersimpan;
- konfigurasi inline yang dikembalikan oleh webhook konfigurasi panggilan dinamis.
Webhook yang mengembalikan
agent_idmenggunakan langkah agen tersebut.
Batas
| Batas | Nilai |
|---|---|
| Langkah per agen | 100 |
| Nilai yang dikumpulkan per langkah | 20 |
| Target serah-terima per agen | 8 |
| Agen yang dapat dijangkau dalam satu panggilan | 8 |
Ukuran JSON steps | 200 KB |
instructions langkah | 20.000 karakter |
Baris say | 1.000 karakter |
Hasil on_enter_tool yang disimpan | 4 KB |
Penyimpanan yang melanggar aturan akan mengembalikan 400 dengan jalur kolom
yang bermasalah, seperti steps.steps[2].transitions[0].to. Nama tool di tools dan
on_enter_tool harus merupakan tool yang terpasang pada agen.
Bahasa per langkah, langkah terskrip yang melewati model, dan nilai yang dikumpulkan di dalam baris say tidak didukung.
Agen yang diimpor
Mengimpor dari Retell, Bland, Vapi, atau ElevenLabs membawa agen multi-Prompt, alur, jalur, dan alur kerja sebagai langkah, serta skuad dan transfer agen sebagai serah-terima antara agen yang diimpor. Halaman tinjauan menampilkan keduanya sebelum Anda mengimpor.
Contoh: penerimaan pasien gigi
Tiga langkah berurutan: menyapa, mengumpulkan detail pasien, menjadwalkan.
{
"prompt": "You are Ava, the front desk assistant at Acme Dental. Be warm and brief. Ask one question at a time.",
"steps": {
"start_step": "greet",
"steps": [
{
"id": "greet",
"name": "Greeting",
"instructions": "Greet the caller and ask how you can help.",
"say": "Thanks for calling Acme Dental, this is Ava. How can I help you today?",
"tools": null,
"collect": [],
"transitions": [
{"to": "details", "when": "The caller wants to book an appointment"}
]
},
{
"id": "details",
"name": "Patient details",
"instructions": "Ask for the caller's full name, date of birth and the reason for the visit. Read the date of birth back and ask the caller to confirm it.",
"tools": null,
"collect": [
{"name": "full_name", "type": "string", "description": "Caller's full name", "required": true},
{"name": "dob", "type": "date", "description": "Date of birth", "required": true},
{"name": "reason", "type": "string", "description": "Reason for the visit", "required": true},
{"name": "new_patient", "type": "boolean", "description": "First visit to the practice", "required": false}
],
"transitions": [
{"to": "book", "when": "The caller has confirmed their details"}
]
},
{
"id": "book",
"name": "Book",
"instructions": "Offer the two earliest open slots from book_slot and book the one the caller picks. Confirm the date and time, then say goodbye and end the call.",
"tools": ["book_slot"],
"collect": [],
"transitions": []
}
]
}
}Siapkan dengan PATCH /v1/agents/{agent_id}, uji dengan panggilan percobaan, lalu deploy.
Langkah details tidak dapat beralih ke pemesanan hingga nama, tanggal lahir,
dan alasan dikumpulkan; new_patient bersifat opsional.
Contoh: cabang dengan batas usia
Model dapat berbicara dengan siapa pun, tetapi kode menentukan siapa yang dapat dijadwalkan. Kumpulkan usia, lalu arahkan berdasarkan usia tersebut sebelum pilihan model sendiri dipertimbangkan.
{
"id": "verify",
"name": "Verify age",
"instructions": "Ask for the caller's age.",
"tools": null,
"collect": [
{"name": "age", "type": "number", "description": "Caller's age in years", "required": true}
],
"transitions": [
{"to": "guardian", "condition": {"value": "age", "op": "lt", "target": 18}},
{"to": "book", "when": "The caller has given their age"}
]
}Penelepon yang mengatakan lima belas akan menuju guardian, apa pun keputusan
model. Semua yang lain menuju book. Keduanya adalah langkah biasa di bagian
lain dalam grafik.
Contoh: langkah webhook pencarian akun
Penelepon memberikan nomor akun, pencarian berjalan saat memasuki langkah berikutnya,
dan hasilnya menentukan rute. Langkah not_found, collections, dan support
tidak disertakan demi ringkasnya.
[
{
"id": "identify",
"name": "Identify",
"instructions": "Ask for the caller's account number and read it back digit by digit.",
"tools": null,
"collect": [
{"name": "account_number", "type": "string", "description": "Account number", "required": true}
],
"transitions": [
{"to": "lookup", "when": "The caller has confirmed their account number"}
]
},
{
"id": "lookup",
"name": "Look up account",
"instructions": "Tell the caller what you found on their account and ask how you can help.",
"tools": ["lookup_account"],
"collect": [],
"on_enter_tool": "lookup_account",
"transitions": [
{"to": "not_found", "condition": {"value": "lookup_account_result.response.found", "op": "eq", "target": false}},
{"to": "collections", "condition": {"value": "lookup_account_result.response.account_status", "op": "in", "target": ["past_due", "suspended"]}},
{"to": "support", "when": "The caller needs help with an active account"}
]
}
]lookup_account menerima account_number karena parameternya memiliki nama tersebut. Jika isi respons memiliki "found": false, panggilan beralih ke
not_found. Jika account_status-nya adalah past_due atau suspended, panggilan beralih ke
collections. Akun aktif tetap berada di lookup, tempat model membantu dan
melanjutkan ke support. Untuk mengirim pencarian yang gagal ke langkah khususnya, tambahkan
kondisi pada status terlebih dahulu: respons error menyimpan kode statusnya, sehingga
{"value": "lookup_account_result.status", "op": "gte", "target": 400}
menangkapnya, dan waktu habis atau tidak ada jawaban menyimpan "error", sehingga
{"value": "lookup_account_result.status", "op": "eq", "target": "error"}
menangkapnya.
Contoh: meja depan ke penagihan
Dua agen. Meja depan (agen 412) menjawab setiap panggilan dan meneruskan pertanyaan
penagihan ke agen penagihan (agen 413) dengan Prompt, tools, dan suara miliknya sendiri.
Di meja depan:
{
"handoffs": [
{"agent_id": 413, "when": "The caller asks about a bill, a payment or a refund"}
]
}Di agen penagihan, agar dapat meneruskan penelepon kembali:
{
"handoffs": [
{"agent_id": 412, "when": "The billing question is resolved and the caller needs something else"}
]
}Meja depan mengucapkan kalimat singkat seperti "Biarkan saya menghubungkan Anda ke tim penagihan kami", dan agen penagihan memperkenalkan diri serta melanjutkan percakapan dari tempat meja depan berhenti. Saat penagihan meneruskan kembali, meja depan melanjutkan dari tempat sebelumnya, tanpa menyapa penelepon lagi. Produk panggilan, bahasa, pengumuman persetujuan, dan pengaturan panggilan lainnya tetap berada di meja depan karena meja depan yang menjawabnya.
Jika penagihan hanya memerlukan instruksinya sendiri dan bukan agennya sendiri, gunakan langkah global di meja depan sebagai gantinya. Saat pertanyaan sudah terjawab, panggilan kembali ke langkah apa pun tempat penelepon berada:
{
"id": "billing",
"name": "Billing questions",
"instructions": "Answer questions about bills and payments. Offer to send a payment link by email.",
"tools": null,
"collect": [],
"transitions": [
{"to": "__previous__", "when": "The billing question is answered"}
],
"global_when": "The caller asks about a bill or payment at any point"
}Langkah berikutnya
Tulis instruksi bersama dan instruksi langkah yang efektif digunakan melalui telepon.
Buat alat yang dipanggil oleh langkah dan langkah webhook Anda.
Jalankan skenario yang sama pada setiap cabang sebelum Anda menerapkan.
Setiap field agen, draf, dan penerapan.