ThunderPhone v3 kini tersedia.Gunakan langsung secara mandiri, mulai 2¢/menit.Baca pengumumannya

Using the dashboard

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 ketikaPertahankan 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

FieldArti
idWajib. Huruf kecil, angka, dan garis bawah, diawali dengan huruf, hingga 40 karakter. Unik dalam agen.
nameNama tampilan wajib, 1 hingga 80 karakter.
instructionsWajib, hingga 20.000 karakter. Mendukung variabel panggilan {{var}}, seperti prompt.
sayBaris opsional yang diucapkan kata demi kata saat langkah dimasuki, hingga 1.000 karakter. Mendukung {{var}}.
toolsnull 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.
collectHingga 20 nilai yang dikumpulkan langkah. Masing-masing memiliki name, type, description, dan required (default true).
on_enter_toolNama alat opsional, dipanggil secara otomatis saat langkah dimasuki. Lihat langkah Webhook.
transitionsDaftar berurutan tujuan langkah berikutnya. Lihat Transisi.
global_whenOpsional. Membuat langkah dapat dijangkau dari langkah mana pun. Lihat Langkah global.
voiceID 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 alat go_to_step bawaan yang mencantumkan langkah yang dapat dituju, dengan setiap when sebagai 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, transisi condition atau always pertama yang cocok akan dipilih, sebelum model dapat memilih when. Jadi, letakkan always setelah kondisi sebagai fallback, atau gunakan sendiri untuk menghubungkan satu langkah langsung ke langkah berikutnya. Langkah dengan always tidak pernah menunggu pilihan when.

Sebuah condition adalah {"value": <collected name or dotted path>, "op": <op>, "target": <literal>}:

opBernilai benar ketika nilai
eq, nesama dengan, atau tidak sama dengan, target
lt, lte, gt, gtekurang dari, paling banyak, lebih besar dari, atau setidaknya target
in, not_inmerupakan, atau bukan merupakan, salah satu nilai dalam daftar target
exists, missingtelah, 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:

  1. Setiap nilai required dalam langkah harus ada. Jika ada yang belum tersedia, model diberi tahu nilai yang mana dan akan memintanya kepada penelepon.
  2. Nilai disimpan.
  3. Transisi condition dan always diperiksa secara berurutan. Kecocokan pertama yang dipilih.
  4. Jika tidak, agen berpindah ke langkah yang dipilih model.
  5. 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.

typeMenyimpan
stringTeks apa pun
numberAngka
booleantrue atau false
dateTanggal 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:

FieldBerisi
statusKode status HTTP yang dikembalikan endpoint Anda.
responseIsi 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:

viaArti
startPanggilan dimulai pada langkah ini.
modelModel memilih langkah melalui go_to_step, when, atau global_when.
conditionTransisi condition atau always cocok.
on_enterTransisi cocok berdasarkan hasil langkah webhook.
handoffAgen 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_id menggunakan langkah agen tersebut.

Batas

BatasNilai
Langkah per agen100
Nilai yang dikumpulkan per langkah20
Target serah-terima per agen8
Agen yang dapat dijangkau dalam satu panggilan8
Ukuran JSON steps200 KB
instructions langkah20.000 karakter
Baris say1.000 karakter
Hasil on_enter_tool yang disimpan4 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