# Menguji dan menyambungkan ejen

## Tonton tutorial

{% embed url="https://youtu.be/On9uz4-b-9A" %}

## Uji dalam playground

Buka tab **Playground** dalam pereka bentuk dan berbual dengan ejen anda seolah-olah anda adalah pelanggan. Setiap perbualan yang anda jalankan disimpan secara automatik — klik **History** untuk menyemak semula 20 sesi ujian terakhir untuk ejen tersebut, supaya anda boleh membandingkan tingkah laku sebelum dan selepas perubahan.

Di bawah setiap balasan, **Nodes visited** menyenaraikan langkah yang dilalui ejen, dan **FAQs used** menyenaraikan soalan daripada AI Knowledge anda yang digunakan oleh balasan itu — hanya yang benar-benar digunakan, supaya anda boleh menyemak bahawa sesuatu soalan dijawab daripada FAQ yang anda jangkakan. Dua perkara yang sama dipaparkan di bawah balasan ejen dalam perbualan sebenar — lihat [Membalas dan menambah nota peribadi](/conversations/replying-and-private-notes). Jika ejen mengesan masalah dalam aliran anda semasa itu — contohnya langkah produk yang mencari katalog dengan pemboleh ubah yang menyimpan jawapan ya/tidak dan bukan produk — baris **Flow warning** turut dipaparkan di sana, menamakan langkah dan pemboleh ubah tersebut supaya anda boleh membetulkannya sebelum menerbitkan.

![Nodes visited dan FAQs used di bawah balasan Playground](../../.gitbook/assets/guides/playground-faqs-used.jpg)

![Sejarah ujian playground](../../.gitbook/assets/guides/test-history.jpg)

## Uji dengan foto, nota suara dan dokumen PDF

Lampirkan foto, nota suara atau PDF dalam Playground, sama seperti pelanggan menghantarnya. Di bawah fail tersebut, sembang menunjukkan apa yang dibaca oleh ejen: **AI description** tentang apa yang ada dalam gambar, transkripsi apa yang diucapkan, atau **AI summary** bagi dokumen itu. Ia adalah teks yang sama yang dilihat pasukan anda dalam perbualan sebenar, jadi anda boleh memastikan ejen memahami senarai pesanan, tangkapan skrin, permintaan lisan atau sebut harga sebelum ia membalas. Perbualan ujian seterusnya juga menggunakan bacaan itu, jadi mesej susulan berkelakuan sama seperti dengan pelanggan sebenar.

![Penerangan foto dan transkripsi nota suara dalam Playground](../../.gitbook/assets/guides/playground-media-transcripts.jpg)

Dokumen PDF sesuai untuk sebut harga, borang pesanan, invois, resit, slip bank dan pengesahan tempahan: ejen mengambil item, jumlah, tarikh dan nombor rujukan, dan langkah **Kumpul** boleh mengambil jawapannya terus daripada dokumen. PDF yang diimbas juga dibaca. Jenis fail lain seperti Word, Excel atau ZIP sampai kepada pasukan anda sebagai fail tetapi tidak dibaca oleh ejen, dan PDF yang sangat besar diserahkan tanpa ringkasan. Fail yang rosak, dilindungi kata laluan atau bukan PDF sebenar tidak diteka: ejen diberitahu bahawa fail itu tidak dapat dibaca, dan tiada ringkasan dipaparkan di bawahnya.

![AI summary bagi sebut harga PDF dalam Playground](../../.gitbook/assets/guides/playground-pdf-ai-summary.jpg)

## Uji sebagai pelanggan sebenar

Secara lalai, Playground memainkan pelanggan tanpa nama yang tiada rekod, jadi setiap laluan kekal kelihatan dan ejen tidak tahu apa-apa tentang siapa yang bertanya. Untuk menguji aliran tepat seperti yang dialami seseorang pelanggan, klik **Scenario** di atas sembang dan nyatakan siapa yang anda mainkan:

* **Load from a conversation** — taip nombor perbualan dan butiran kenalan pelanggan, labelnya serta iklan yang membawanya masuk akan diisi untuk anda.
* **Contact** — cari kenalan sedia ada, atau taip nama, nombor telefon, e-mel dan sebarang atribut kenalan secara manual.
* **Ad** — iklan Meta yang diklik pelanggan, supaya laluan yang dikhaskan untuk iklan berkelakuan seperti secara langsung.
* **Labels** — label pada perbualan atau kenalan pelanggan.
* **Inbox** — peti masuk tempat perbualan itu tiba. Aliran mengira waktu mengikut zon waktu peti masuk itu, dan mesej **Outside business hours** pada langkah Tamat mengikut waktu perniagaan peti masuk tersebut.
* **Time** — waktu olok-olok untuk perbualan itu, supaya sapaan, waktu buka dan balasan lain yang bergantung pada waktu berkelakuan seperti pada waktu itu. Jalur **Testing as** menunjukkan peti masuk dan waktu yang anda pilih.

Tekan **Apply** dan perbualan dimulakan semula sebagai pelanggan itu. Jalur **Testing as** di atas sembang menunjukkan siapa yang anda mainkan, dan setiap kali syarat laluan anda menyembunyikan satu cabang atau menghantar pelanggan terus ke satu cabang, satu nota dalam sembang menyatakan laluan mana yang terjejas. Syarat yang membaca butiran kenalan — seperti melangkau soalan telefon apabila nombor sudah ada dalam rekod — menggunakan rekod yang anda masukkan.

![Dialog Scenario dalam Playground](../../.gitbook/assets/guides/playground-scenario-dialog.jpg)

![Peti masuk dan waktu dalam dialog Scenario](../../.gitbook/assets/guides/playground-scenario-inbox-time.jpg)

* **Reset** mengekalkan senario, jadi anda boleh menjalankan semula pelanggan yang sama dengan satu klik; **Clear scenario** dalam dialog kembali kepada penguji tanpa nama.
* Menukar senario memulakan semula perbualan ujian — butiran pelanggan sebenar tetap dari mesej pertama mereka.
* **History** menunjukkan pelanggan yang dimainkan oleh setiap sesi ujian yang disimpan.

![Laluan yang disembunyikan atau dipaksa untuk senario](../../.gitbook/assets/guides/playground-scenario-routes.jpg)

## Sambungkan peti masuk

Klik **Inboxes** pada pengepala pereka bentuk dan pilih peti masuk mana yang perlu dikendalikan oleh ejen — setiap peti masuk hanya boleh ditugaskan kepada satu ejen flow. Bagi setiap peti masuk anda juga boleh menetapkan:

* **Pause when a human replies** — apabila rakan sepasukan menjawab (daripada papan pemuka atau aplikasi yang disambungkan), ejen berundur secara automatik dan bukannya bercakap bertindih dengan mereka.
* **Active hours** — ejen mengendalikan peti masuk ini hanya antara waktu mula dan waktu tamat yang anda tetapkan, setiap hari, mengikut zon waktu peti masuk itu. Tempoh yang melangkaui tengah malam, seperti 6:00 PM hingga 8:00 AM, tidak menjadi masalah.
* **Don't reply to these labels** — ejen melangkau mana-mana perbualan atau kenalan yang ditanda dengan label yang anda pilih, supaya kes VIP atau aduan kekal dikendalikan oleh manusia.
* **Only reply to specific ads** — hadkan ejen kepada sembang yang bermula daripada ID iklan Meta tertentu.
* **Ignore WhatsApp group chats** — ejen tidak melibatkan diri dalam perbualan kumpulan.

![Waktu aktif pada peti masuk dalam dialog Inboxes](../../.gitbook/assets/guides/flow-inbox-active-hours.jpg)

Di luar waktu aktif peti masuk, ejen kekal senyap untuk semua orang di peti masuk itu: pelanggan baharu tidak dibawa masuk ke dalam flow, pelanggan yang sudah separuh jalan tidak menerima balasan lanjut daripada ejen, dan tiada susulan dihantar. Jika peti masuk itu mempunyai mesej luar pejabat, mesej itulah yang dimainkan. Lencana ejen di bahagian atas setiap perbualan memaparkan **Outside active hours** bersama tempohnya, supaya pasukan anda tahu ejen memang sengaja senyap, dan butang bot dalam kotak balasan masih boleh membuat ejen menjawab apabila anda mahu — lihat [Membalas dan menambah nota peribadi](/conversations/replying-and-private-notes).

![Lencana perbualan memaparkan Outside active hours](../../.gitbook/assets/guides/flow-agent-badge-outside-active-hours.jpg)

## Terbitkan

Klik **Publish** dan pilih siapa yang boleh bercakap dengan ejen:

* **Public** — semua orang yang menghantar mesej ke peti masuk yang disambungkan.
* **Testers only** — hanya nombor telefon, e-mel atau nama pengguna WhatsApp yang anda senaraikan di bawah **Tester phone numbers, emails or WhatsApp usernames**, supaya anda boleh menguji ejen pada saluran langsung sebelum membukanya kepada umum.

Jika ejen ditetapkan untuk [menyerah tugas secara senyap](/flow-agents/building-the-conversation-flow) (mesej serah tugas kosong), penerbitan pertama akan menunjukkan apa yang akan dialami oleh pelanggan dan meminta anda mengesahkan sebelum ia langsung.

Setelah pelanggan mula berbual dengan ejen, butang api pada bar alat pereka bentuk menunjukkan langkah mana yang mereka capai dan di mana mereka berhenti — lihat [Lihat ke mana pelanggan pergi](/flow-agents/building-the-conversation-flow).

![Dialog penerbitan](../../.gitbook/assets/guides/publish-dialog.jpg)

### Mulakan semula ujian dengan ##reset

Sesiapa sahaja dalam senarai penguji ejen boleh memulakan semula ujian daripada telefon mereka sendiri. Hantar **##reset** sebagai satu mesej tersendiri dalam sembang dengan ejen (huruf besar atau kecil tidak penting). Ejen mengesahkan dengan "Flow reset — your next message starts the flow from the beginning.", dan mesej anda yang seterusnya dianggap sebagai mesej pertama pelanggan baharu, dalam sembang yang sama. Anda tidak memerlukan nombor baharu atau sembang baharu untuk melihat pembukaan sekali lagi.

Tetapan semula ini mengosongkan label yang ditambah oleh langkah-langkah flow, lajur AI yang diisi daripada larian ujian itu, dan penyerahan yang direkodkannya. Label lain dan butiran kenalan kekal seperti sedia ada.

**##reset** berfungsi sama ada ejen diterbitkan kepada **Testers only** atau **Public**, selagi anda berada dalam senarai penguji. Daripada sesiapa yang tiada dalam senarai, ia hanyalah mesej biasa.

## Tetapan tingkah laku

Butang **Settings** pada pengepala pereka bentuk mengawal bagaimana ejen bertindak dalam perbualan:

* **Keep answering after the flow ends** — ejen kekal tersedia untuk menjawab soalan selepas aliran tamat, bukannya senyap terus.
* **Answer FAQs on the first message** — jika mesej pertama pelanggan sepadan dengan AI Knowledge anda, ejen menjawabnya sebelum pembukaan aliran dimainkan.
* **Continue the flow after an FAQ answer** — dihidupkan secara lalai: selepas menjawab soalan daripada AI Knowledge atau katalog produk anda, ejen meneruskan aliran — ia bertanya semula soalan yang masih menunggu, atau memainkan sapaan dan soalan pembukaan jika soalan itu ialah mesej pertama pelanggan. Matikannya supaya ejen berhenti selepas menjawab dan menunggu mesej pelanggan yang seterusnya; aliran kemudian bermula (atau disambung) pada mesej seterusnya yang bukan soalan.
* **Let AI rewrite messages** — ejen menyusun semula ayat mesej aliran dan soalan lazim mengikut nada yang anda tetapkan dalam AI Knowledge → Behaviour. Fakta, harga, tarikh dan pautan tidak sekali-kali diubah.
* **Try to help before handing off** — sebelum menyerahkan perbualan kepada pasukan anda, ejen menyemak sama ada ia masih boleh membantu: ia mungkin bertanya satu soalan penjelasan, atau menjawab hanya berdasarkan kandungan aliran dan AI Knowledge anda. Ia tidak sekali-kali mereka-reka maklumat, dan pelanggan yang meminta manusia sentiasa diserahkan serta-merta. Dimatikan secara lalai — hidupkan untuk setiap ejen apabila anda bersedia. Anda juga boleh menyenaraikan butiran untuk dikumpul terlebih dahulu oleh ejen — lihat di bawah.
* **Pause duration after handoff** — berapa lama ejen berhenti seketika selepas serah tugas sebelum menyambung semula (15 minit hingga 24 jam, atau tidak sama sekali).
* **Re-ask limit for collect steps** — berapa kali ejen bertanya semula untuk maklumat yang diperlukan sebelum meneruskan.
* **Delay before replying** — kelewatan pilihan supaya respons terasa kurang serta-merta.
* **Quiet hours for follow-ups** — tiada mesej susulan antara masa mula dan tamat yang anda tetapkan, dalam zon waktu peti masuk. Susulan yang jatuh dalam tempoh itu dihantar apabila ia tamat.
* **Facebook post context** — berapa banyak teks kiriman yang dilihat ejen semasa membalas komen pada kiriman itu.

Dialog ini juga menyenaraikan **Business hours** bagi setiap peti masuk yang disambungkan kepada ejen, dengan jadual dan zon waktunya, supaya anda boleh menetapkan waktu yang diikuti oleh mesej **Outside business hours** sesuatu langkah Tamat tanpa meninggalkan pereka bentuk — lihat [Mesej serah tugas](/flow-agents/building-the-conversation-flow).

![Tetapan ejen flow](../../.gitbook/assets/guides/flow-agent-settings.jpg)

### Butiran untuk dikumpul sebelum serah tugas

Apabila **Try to help before handing off** dihidupkan, senarai bernama **Details to collect before handing off** muncul di bawahnya. Tambahkan butiran yang diperlukan pasukan anda untuk bertindak selepas serah tugas — nombor telefon, waktu panggilan balik yang sesuai, rujukan pesanan — setiap satu dengan nota ringkas tentang apa yang perlu ditanya, lalu tekan **Save**.

Apabila ejen perlu menyerahkan soalan biasa yang tidak dapat dijawabnya, ia meminta butiran ini sekali sahaja, semuanya dalam satu mesej, dalam bahasa pelanggan, dan menjelaskan bahawa butiran itu pilihan. Apa sahaja balasan pelanggan, perbualan itu diserahkan kepada pasukan anda seterusnya, bersama nota peribadi **Collected before handoff** yang memaparkan soalan mereka dan setiap butiran; yang dilangkau ditanda *not provided*. Butiran ini juga muncul dalam penyerahan aliran seperti butiran lain yang dikumpul.

Ejen tidak sekali-kali mengajukan permintaan ini kepada pelanggan yang memerlukan bantuan segera: sesiapa yang meminta manusia, atau jelas kecewa, diserahkan serta-merta. Butiran yang sudah dikumpul oleh aliran tidak ditanya lagi, dan jika pelanggan senyap selama 15 minit, serah tugas tetap berlaku dengan apa sahaja yang telah dikongsi.

![Butiran untuk dikumpul sebelum serah tugas dalam Settings ejen](../../.gitbook/assets/guides/flow-settings-details-before-handoff.jpg)

Jika ejen berhenti membalas dengan ralat tentang had, semak penggunaan kredit AI pelan anda — ejen berhenti seketika apabila had kredit akaun dicapai dan menyambung semula sebaik sahaja ia diperbaharui atau dinaikkan.

Jika sesuatu balasan gagal kerana gangguan perkhidmatan sementara, ejen menyerahkan perbualan kepada pasukan anda dengan satu nota dalam perbualan, kemudian mencuba sekali lagi secara senyap beberapa minit kemudian — kecuali seseorang telah membalas atau menjedanya. Anda juga boleh membuat ejen membalas atas permintaan dengan butang bot dalam kotak balasan perbualan — lihat [Membalas dan menambah nota peribadi](/conversations/replying-and-private-notes).

---
Source: https://help.mampuai.com/ms/flow-agents/testing-and-connecting-an-agent