# Rujukan pereka bentuk flow: setiap butang dan tetapan

Cari mana-mana butang atau medan dalam pereka bentuk flow di sini. Untuk panduan langkah demi langkah membina flow, mulakan dengan [Membina aliran perbualan](/flow-agents/building-the-conversation-flow).

## Pereka bentuk sepintas lalu

![Pereka bentuk flow: tab di kiri, kanvas di tengah, panel langkah di kanan](../../.gitbook/assets/guides/designer-overview.jpg)

* **Designer**, **Playground** dan **History** ialah tab di sebelah kiri. **Designer** ialah sembang tempat anda menerangkan perubahan dengan kata-kata sendiri; lihat [Mereka bentuk ejen anda melalui sembang](/flow-agents/designing-your-agent-by-chatting).
* **Kanvas** memaparkan flow sebagai langkah yang bersambung. Klik langkah untuk membuka panelnya di sebelah kanan.
* **Settings**, **Inboxes** dan **Publish** berada di pengepala. Lencana menunjukkan keadaan ejen: **Draft**, **Testers only** atau **Handling public**.

Jika pereka bentuk anda dibuka sebagai satu sembang besar, klik **Switch to classic view** di pengepala untuk mendapatkan susun atur ini.

## Bar alat kanvas

![Flow outline dibuka di sebelah bar alat kanvas](../../.gitbook/assets/guides/designer-canvas-toolbar.jpg){ width="500" }

| Butang | Fungsinya |
|---|---|
| **Search nodes (Ctrl+F)** | Cari langkah melalui perkataannya dan lompat ke situ |
| **Flow outline** | Setiap langkah sebagai pokok cabang; klik satu untuk melompat ke situ |
| **Show where customers went in the last 30 days** | Peta haba bilangan pelanggan yang sampai ke setiap langkah (pentadbir); lihat [Lihat ke mana pelanggan pergi](/flow-agents/building-the-conversation-flow) |
| **Collapse one branch level** / **Expand one branch level** / **Expand all branches** | Lipat flow yang besar satu aras menu pada satu masa; klik dua kali pil yang dilipat untuk membukanya |
| **Select nodes to comment** | Lukis kotak di sekeliling langkah dan taip apa yang perlu diubah; sembang pereka bentuk menyunting langkah itu sahaja |
| **Zoom in**, **Zoom out**, **Fit to view** | Ubah berapa banyak yang kelihatan; **Fit to view** membawa semua langkah kembali |
| **Download as PDF** | Simpan keseluruhan flow, bersama imejnya, sebagai PDF |
| **Show one image per step** | Muncul apabila langkah membawa lampiran; mengecilkannya kepada satu imej kecil dan bilangannya |
| **Show the path walked in the playground** | Muncul selepas larian Playground; menomborkan langkah yang dilaluinya |

## Tetapan yang dikongsi setiap langkah

Setiap panel langkah mempunyai yang berikut, dari atas ke bawah:

* **Label**: nama langkah di kanvas.
* **Run this step**: matikan langkah, atau jalankan hanya antara dua tarikh dengan **Only run between**. Semasa ia dimatikan, flow terus ke langkah seterusnya. Lihat [Matikan langkah, atau jalankannya untuk tempoh tertentu](/flow-agents/building-the-conversation-flow).
* **Next step**: ke mana flow pergi selepas langkah ini. Pilih langkah, atau tambah langkah baharu dan tulis seterusnya. Di kanvas, **+** kelabu pada penyambung kanan blok juga menambah langkah seterusnya, dan **+** kuning pada blok soalan menambah langkah pada laluan No reply-nya.
* **Actions → Add label**: labelkan perbualan dan kenalan apabila flow sampai ke langkah ini.
* **FAQ category scope**: sempitkan FAQ yang digunakan ejen untuk menjawab, dari langkah ini seterusnya. Lihat [Fokuskan ejen pada FAQ yang betul](/flow-agents/building-the-conversation-flow).
* **Save Changes** menyimpan suntingan anda. **Delete Node** membuang langkah; sambungkan semula langkah di sekelilingnya selepas itu.

Dalam mana-mana mesej, `{name}` atau `{email}` memasukkan nilai yang dikumpul sebelumnya, dan `{collection:key}` menyenaraikan item daripada bahagian berulang. Ikon kembang pada medan teks yang panjang membuka editor yang lebih besar.

## Send message

![Panel Send Message, atas dan bawah](../../.gitbook/assets/guides/designer-send-message-panel.jpg){ width="640" }

* **Message**: apa yang dikatakan ejen.
* **Add attachment** (di atas atau di bawah mesej) menambah imej, video, fail audio atau dokumen, dihantar **Before message** atau **After message**. Anda juga boleh melepaskan fail ke atas kotak itu. Terangkan setiap fail di bawah **What is this?** dan gunakan **When to send** untuk masa, contohnya *hanya selepas pelanggan menunjukkan minat*.

## Collect

![Panel Collect: pemboleh ubah, pengesahan, susulan](../../.gitbook/assets/guides/designer-collect-panel.jpg){ width="640" }

* **Question to ask**: apa yang ditanya ejen.
* **Variable names**: butiran yang ditangkap oleh soalan ini. Tandakan setiap satu **Required** (ditanya semula sehingga diberi) atau **Optional** (ditanya sekali). **Add variable** untuk lebih.
* **Validation**: **None**, **Email**, **Number** atau **Date**.
* **Always stop and ask first**: sentiasa bertanya dan menunggu, walaupun mesej awal kelihatan sudah menjawabnya.
* **Confirm a value the customer gave before**: tunjukkan kepada pelanggan yang kembali jawapan kali lepas untuk disahkan atau dibetulkan.
* **Answer buttons**: sehingga 13 jawapan yang boleh ditekan, 20 aksara setiap satu. Lihat [Biarkan pelanggan menekan jawapan](/flow-agents/building-the-conversation-flow).
* **Follow up**: lihat bahagian Susulan di bawah.

Berapa kali butiran wajib ditanya semula ditetapkan oleh **Re-ask limit for collect nodes** dalam Settings; panel memautkannya dengan **Change in Settings**.

## Condition dan peraturan laluan

![Panel Condition dengan peraturan laluan dibuka pada satu cabang, dan butang jawapan di bawah](../../.gitbook/assets/guides/designer-condition-panel.jpg){ width="640" }

* **Question** (pilihan) ditanya sebelum pelanggan memilih cabang. **Classification description** menyatakan tujuan cabang-cabang itu.
* **Branches**: taip nama dan tekan Enter. Setiap nama mesti sepadan dengan label pada garisan yang keluar dari langkah. Tandakan satu cabang untuk menjadikannya **Default branch**, diambil apabila tiada balasan.
* Ikon penapis pada cabang membuka **peraturan laluan**nya. **Add condition** menawarkan:

| Syarat | Memaparkan atau memilih cabang apabila |
|---|---|
| **Meta ad IDs** | Pelanggan datang daripada salah satu iklan Click-to-Message ini |
| **Customer labels** | Perbualan atau kenalan mempunyai salah satu label ini |
| **Message keywords** | Mesej terkini mengandungi salah satu perkataan ini |
| **Must go here on match** | Langkau soalan dan sentiasa hantar pelanggan yang sepadan ke sini (memerlukan ID iklan atau label) |

Syarat yang digabungkan mesti semuanya sepadan. Lihat [Paparkan laluan hanya kepada pelanggan yang betul](/flow-agents/building-the-conversation-flow).

## AI conversation

Ejen bersembang bebas mengikut arahan anda sehingga satu jalan keluar terpakai.

| Medan | Fungsinya |
|---|---|
| **How it should talk** | Arahan anda untuk langkah ini |
| **What this step handles** | Ringkasan satu baris pilihan, sehingga 200 aksara |
| **Knowledge this step answers from** | Topik AI Knowledge yang digunakan; kosong bermaksud semua |
| **Exit routes** | Jalan keluar: **Add route**, namakannya, terangkan bila ia terpakai. **Done**, **Handoff** dan **Unresolved** ialah nama terpelihara |
| **Variable names** | Butiran untuk ditangkap semasa bersembang |
| **Advanced settings → Turn limit** | Keluar melalui **Unresolved** selepas sekian banyak balasan pelanggan |

## AI task dan langkah alat

| Medan | Fungsinya |
|---|---|
| **AI task → Result variable** | Berjalan secara senyap dan menyimpan jawapannya untuk langkah kemudian |
| **Tool type** | Data langsung untuk langkah: slot kalendar, produk katalog atau salah satu alat API anda |
| **If the request fails** | Katakan ia tidak dapat menyemak dan teruskan, atau katakan begitu dan serahkan. Tidak pernah mereka-reka nilai |
| **Search from variable** | Cari produk melalui butiran yang dikumpul; kosong menggunakan mesej terkini |
| **Which products to use** | Cadangkan padanan terdekat, atau hanya yang tepat dan serahkan apabila tiada yang sepadan. Lihat [Katalog produk dan cadangan](/flow-agents/product-catalogue-and-recommendations) |
| **If the time was just taken** | Permohonan maaf yang dihantar langkah tempahan apabila slot telah diambil dahulu. Lihat [Menyediakan kalendar](/calendar/setting-up-a-calendar) |

## Susulan

Di bawah **Follow up** pada langkah Collect, klik **+ Add follow-up step** untuk bertindak apabila pelanggan berhenti membalas. Langkah dijalankan satu demi satu. Setiap satu menunggu masa di bawah **Follow up after**, kemudian melakukan apa yang anda pilih di bawah **Then**: **Send a reminder and keep waiting**, **Continue to the next step**, **Hand off to a human agent** atau **Continue on the No reply path**.

* Mesejnya pilihan. Tanpa mesej, langkah berjalan secara senyap. Pada langkah peringatan anda boleh melepaskan imej, video, audio atau fail ke **Media** untuk dihantar bersama.
* **Continue on the No reply path** melukis garisan **No reply** berwarna kuning dari langkah ini di kanvas dan bertanya ke mana ia menuju di bawah **Go to step**: langkah sedia ada, atau **+ New message step**, **+ New question step** atau **+ New end**. Jika pelanggan masih belum membalas pada masa itu, flow mengikut garisan itu dan bukannya langkah seterusnya yang biasa. Lihat [Susuli apabila pelanggan senyap](/flow-agents/building-the-conversation-flow#susuli-apabila-pelanggan-senyap).
* Setiap langkah memerlukan masa menunggu. Langkah selepas langkah continue, hand off atau No reply tidak akan berjalan.
* Susulan tidak pernah dihantar dalam **Quiet hours for follow-ups** dalam Settings ejen.

## End

![Panel End](../../.gitbook/assets/guides/designer-end-panel.jpg){ width="330" }

* **Final message**: dikatakan apabila perbualan berakhir.
* **Hand off to human agent**: serahkan sembang kepada pasukan anda dan bukannya menutupnya. End lalai sentiasa menyerahkan.
* **Handoff message**: dihantar semasa penyerahan. Tandakan **Leave handoff message blank (silent handoff)** untuk tidak menghantar apa-apa.
* **Outside business hours**: dihantar sebaliknya apabila peti masuk berada di luar waktu perniagaannya.

Lihat [Mesej penyerahan](/flow-agents/building-the-conversation-flow).

## Playground

![Tab Playground](../../.gitbook/assets/guides/designer-playground.jpg){ width="420" }

Taip sebagai pelanggan untuk menjalankan flow. Klip kertas menghantar foto, nota suara atau PDF. **History** menyenaraikan larian ujian terdahulu.

![Dialog Test scenario](../../.gitbook/assets/guides/designer-playground-scenario.jpg){ width="460" }

**Scenario** memainkan pelanggan sebenar: kenalan mereka, **Ad** yang diklik, **Labels** mereka, **Inbox** tempat mereka menulis dan **Time** perbualan. Peraturan laluan dan waktu operasi kemudian berkelakuan seperti secara langsung. **Load from a conversation** mengisinya daripada nombor perbualan; simpan satu set di bawah **Saved scenarios** untuk digunakan semula.

* Susulan dihantar selepas masa menunggu sebenar, jadi biarkan ujian terbuka.
* Apabila ujian berakhir dan urutan mesej dipautkan kepada ejen, **Simulate inactivity** memulakan urutan dan **Deliver** menghantar mesej seterusnya. Lihat [Urutan mesej](/campaigns/message-sequences).

## History

![Snapshot History](../../.gitbook/assets/guides/designer-history.jpg){ width="420" }

Setiap perubahan mencipta snapshot. **Restore** kembali kepada satu snapshot. Yang sedang disiarkan membawa lencana **Published**.

## Publish dan Inboxes

![Dialog Publish flow agent](../../.gitbook/assets/guides/designer-publish-dialog.jpg){ width="460" }

**Publish** bertanya **Who can talk to this agent?**: **Public** (semua orang di peti masuk yang disambungkan) atau **Testers only** (nombor telefon, e-mel atau nama pengguna WhatsApp yang anda senaraikan).

![Dialog Assign Inboxes](../../.gitbook/assets/guides/designer-inboxes-dialog.jpg){ width="460" }

**Inboxes** memilih peti masuk yang dijawab ejen; setiap peti masuk boleh mempunyai satu ejen flow. **Add new inbox** menyambungkan saluran tanpa meninggalkan pereka bentuk. **Save collected phone to contact** menjadikan nombor yang dikumpul ejen sebagai telefon kenalan; tandakan **I understand and accept this risk** untuk menghidupkannya, kerana ia tidak boleh dibuat asal.

## Tetapan ejen

![Flow Agent Settings](../../.gitbook/assets/guides/designer-agent-settings.jpg)

| Tetapan | Fungsinya |
|---|---|
| **Keep answering after the flow ends** | Jawab soalan selepas flow selesai dan bukannya bermula semula |
| **Answer FAQs on the first message** | Mesej pertama yang sepadan dengan AI Knowledge dijawab sebelum pembukaan |
| **Continue the flow after an FAQ answer** | Selepas jawapan FAQ, tanya semula soalan yang belum dijawab atau mulakan flow |
| **Let AI rewrite messages** | Ubah kata mesej mengikut nada anda; fakta, harga, tarikh dan pautan tidak pernah berubah |
| **Try to help before handing off** | Satu soalan penjelasan atau jawapan dahulu; meminta orang sentiasa diserahkan serta-merta |
| **Details to collect before handing off** | Dipaparkan apabila **Try to help before handing off** dihidupkan. Ditanya sekali sebelum penyerahan biasa; jawapan masuk ke nota peribadi |
| **Pause duration after handoff** | Berapa lama ejen senyap selepas penyerahan; **Custom** atau **No auto-resume** |
| **Re-ask limit for collect nodes** | Berapa kali butiran wajib ditanya semula |
| **Delay before replying (seconds)** | 0 hingga 300; mesej yang dihantar semasa menunggu mendapat satu balasan |
| **Facebook post context (characters)** | Berapa banyak siaran dibaca ejen untuk satu komen; 300 disyorkan |
| **Quiet hours for follow-ups** | Tiada susulan dalam tempoh ini, mengikut zon waktu peti masuk |
| **Business hours** | Waktu setiap peti masuk yang disambungkan, digunakan oleh **Outside business hours** |

Lebih lanjut dalam [Tetapan tingkah laku](/flow-agents/testing-and-connecting-an-agent).

## Berkaitan

* [Membina aliran perbualan](/flow-agents/building-the-conversation-flow)
* [Mereka bentuk ejen anda melalui sembang](/flow-agents/designing-your-agent-by-chatting)
* [Menguji dan menyambungkan ejen](/flow-agents/testing-and-connecting-an-agent)
* [Katalog produk dan cadangan](/flow-agents/product-catalogue-and-recommendations)
* [Mengurus AI Knowledge](/flow-agents/managing-ai-knowledge)

---
Source: https://help.mampuai.com/ms/flow-agents/designer-reference