# Katalog produk dan cadangan

Jubin **Product** dalam **Flow Agents → AI Knowledge Hub** menyimpan katalog anda — nama, harga dan butiran segala yang anda jual. Setelah diisi, Ejen Flow anda akan mencadangkan produk sebenar dengan harga sebenar setiap kali pelanggan bertanya — "ada tak…", "berapa harga…", "yang mana paling murah?" — dalam apa jua bahasa yang ditulis pelanggan, walaupun mereka tersalah eja nama produk.

## Menambah produk satu demi satu

Buka jubin **Product** dan klik **Add entry**. Setiap produk mempunyai:

* **Product name** — nama item itu, cth. *Widget Pro 2024*.
* **Description** — penerangan ringkas tentang produk itu.
* **Price** dan **Currency**.
* **Remarks** — spesifikasi dan atribut, cth. *Color: Red, Year: 2023, Aluminium*.

Letakkan butiran yang membezakan item serupa — tahun model, warna, saiz, storan — dalam nama atau remarks. Itulah yang membolehkan AI memilih varian yang tepat apabila pelanggan bertanya secara spesifik, dan bertanya varian mana yang dimaksudkan apabila mereka tidak spesifik.

## Mengimport senarai harga anda

Untuk katalog yang lebih besar, klik **Import CSV/Excel** dan muat naik fail sedia ada anda — senarai harga CSV atau Excel (.xlsx) yang dieksport daripada POS anda atau diselenggara dalam hamparan. Anda tidak perlu memformatnya semula dahulu:

1. **Choose file** — atau klik **Download example CSV** jika anda bermula dari kosong.

2. **Padankan lajur.** Setiap lajur daripada fail anda dipadankan dengan medan produk — **Product name**, **SKU / item code**, **Price**, **Currency**, **Description**, **Remarks**. Padanan diteka untuk anda; lajur yang tidak sepadan ditetapkan kepada **Add to remarks** supaya tiada data hilang, dan lajur yang tidak diperlukan boleh ditetapkan kepada **Skip this column**.

   ![Memadankan lajur fail dengan medan produk](../../.gitbook/assets/guides/product-import-mapping.jpg)

3. **Preview changes.** Sebelum apa-apa berlaku, anda melihat dengan tepat apa yang akan dilakukan oleh muat naik itu.

   ![Pratonton perubahan yang akan dibuat oleh muat naik](../../.gitbook/assets/guides/product-import-preview.jpg)

4. **Apply changes.** Import berjalan di latar belakang — pemberitahuan akan memaklumkan anda apabila ia selesai, cth. *Product import finished: 24 added, 3 updated, 1 removed.*

Harga boleh kekal dalam format asal fail anda (cth. *RM 3,299.00*) — ia dikemaskan semasa import.

## Memastikan katalog kekal selari

Fail anda ialah sumber kebenaran. Apabila harga berubah atau item datang dan pergi, muat naik sahaja versi terkini fail yang sama:

* Produk yang sudah ada dalam katalog **dikemas kini di tempatnya**.
* Produk yang **tiada dalam fail akan dibuang** — pratonton menyenaraikan namanya satu persatu sebelum anda mengesahkan.
* Tiada apa-apa yang berubah sehingga anda klik **Apply changes**.

Dua petua untuk penyelarasan yang boleh dipercayai:

* **Sertakan lajur SKU / item code.** SKU ialah cara muat naik semula mengenali produk yang telah anda namakan semula. Tanpa SKU, produk dipadankan mengikut nama yang sama persis.
* **Pastikan nama unik** (atau gunakan SKU). Jika dua baris berkongsi nama dan tiada SKU, hanya baris pertama diimport — pratonton menandakan baris selebihnya di bawah *row(s) can't be imported*, berserta nombor baris, supaya anda boleh membetulkan fail.

## Mencadangkan produk dalam aliran

Anda tidak perlu mengubah aliran anda langsung — setelah katalog wujud, ejen menjawab soalan produk setiap kali pelanggan bertanya, kemudian meneruskan aliran.

Untuk mencadangkan pada saat tertentu — contohnya sejurus selepas bertanya apa yang dicari pelanggan — buka pereka aliran, pilih langkah itu, dan tetapkan **Tool type** kepada **Product** dalam bahagian **Tool** langkah tersebut. Langkah itu kemudian mencadangkan secara langsung daripada katalog produk anda: nama dan harga sebenar, berdasarkan keperluan pelanggan. Secara pilihan, tetapkan **Search from variable** kepada pemboleh ubah yang dikumpul oleh aliran anda (cth. *product\_need*); biarkan kosong untuk mencari daripada mesej terkini pelanggan.

Nota: kunci API OpenAI (ditambah di bawah **Settings → Integrations → AI Providers**) diperlukan supaya AI dapat mencari dan menggunakan katalog anda.

## Berkaitan

* [Menguruskan Pengetahuan AI](/flow-agents/managing-ai-knowledge)
* [Membina aliran perbualan](/flow-agents/building-the-conversation-flow)
* [Ejen Flow dan Pengetahuan AI](/flow-agents/flow-agents-ai-knowledge)

---
Source: https://help.mampuai.com/ms/flow-agents/product-catalogue-and-recommendations