Mengingat Setiap Pengguna

Buka di CMS

Di langkah ini agent Anda mulai mengingat fakta-fakta berguna tentang setiap orang di antara percakapan, sehingga mereka tidak perlu mengulanginya. Yang sama pentingnya, Anda menentukan apa yang tidak pernah boleh diingatnya.

Di tutorial ini Anda memberi Atlas, asisten operasional Kirana Group, dua memory field: site tempat seseorang bekerja (home_site) dan departemennya (department). Jawaban Kirana soal persetujuan bergantung pada keduanya. Setelah Atlas mengingatnya, staf procurement di site Surabaya tidak perlu lagi menyebut "Surabaya" setiap kali bertanya cost centre mana yang dipakai untuk pengajuan capex.

Di CMS, buka Conversation → Personalization di sidebar kiri.

Tentukan apa saja yang boleh diingat agent ini tentang orang-orang yang diajaknya bicara. Apa pun di luar daftar itu tidak pernah disimpan. Itulah yang membuat agent tetap relevan, cepat, dan bisa dijelaskan.


Sebelum memulai


Cara kerjanya

Anda menentukan daftar singkat Memory Fields, yaitu slot bernama seperti home_site, department, atau language. Saat seseorang mengatakan sesuatu yang mengisi salah satu slot itu, agent mencatatnya di profil orang tersebut. Di percakapan berikutnya, agent membaca kembali nilai-nilai itu dan memakainya.

Ada tiga konsekuensi dari desain tersebut, dan ketiganya layak dipahami sebelum Anda mengonfigurasi apa pun:

  • Tidak ada yang direkam selain yang Anda minta. Atlas mendeklarasikan dua field tentang tempat orang bekerja. Atlas tidak akan diam-diam mulai menyimpan tim sepak bola favorit seseorang, karena tidak ada tempat untuk menyimpannya.
  • Membaca tidak menambah biaya. Field-field tersebut berupa daftar yang tetap dan sudah diketahui, sehingga mengingatnya cukup dengan satu lookup, bukan pencarian. Tidak ada panggilan AI saat membacanya.
  • Anda bisa menjelaskannya. Setiap nilai yang disimpan mencatat asal-usulnya, kutipan kata demi kata sumbernya, kapan direkam, dan kapan kedaluwarsa. Jika seseorang bertanya "dari mana kamu tahu itu tentang saya?", ada jawaban yang nyata.

Langkah 1: Nyalakan Remember things about each person

Di bagian atas halaman ada switch utama, Remember things about each person. Switch ini mati secara default:

Off by default. Nothing is stored until you declare below what may be remembered, and the person has agreed to it.

Jika organization mengaktifkan Mode Privasi, switch ini tidak berpengaruh. Tidak ada memori yang direkam untuk agent mana pun di organization tersebut, apa pun yang dideklarasikan di sini.

Nyalakan switch ini. Menyalakannya saja tidak merekam apa pun: tanpa field yang dideklarasikan, tidak ada tempat untuk menyimpan apa pun. Semua hal lain di halaman ini adalah konfigurasi untuk switch ini, sehingga sisanya baru muncul setelah switch dinyalakan.

Jika agent Anda masih mengaktifkan mekanisme personalisasi lama yang sudah dihentikan, sebuah peringatan muncul di sini dengan tombol Switch it off. Mekanisme lama itu menyimpan data secara terpisah, sedang dihentikan, dan tidak mengisi apa pun di halaman ini.

Di bawah switch, halaman terbagi menjadi dua tab:

TabIsinya
ConfigurationPrompt budget, dua switch perilaku, dan model ekstraksi. Diatur sekali dan jarang ditinjau ulang.
Memory FieldsField-field yang dideklarasikan, yaitu bagian yang paling sering Anda sempurnakan.

Switch dan tombol Save berada di luar kedua tab, karena satu kali Save menyimpan pengaturan dan daftar field sekaligus. Mengedit field di satu tab dan menyesuaikan pengaturan di tab lain cukup disimpan sekali, bukan dua kali.

Remember things about each person dinyalakan, dengan catatan 'Off by default. Nothing is stored until you declare below what may be remembered, and the person has agreed to it.' serta tab Configuration dan Memory Fields di bawahnya, tab Configuration terbuka

Langkah 2: Deklarasikan memory field

Buka tab Memory Fields dan klik Add field. Dialog New memory field terbuka. Isi untuk field pertama, home_site:

PengaturanNilai untuk AtlasFungsinya
Keyhome_siteIdentitas yang stabil. Huruf kecil, angka, dan garis bawah. Mengubahnya berarti membuat field yang berbeda.
LabelHome siteDitampilkan kepada orang yang diingat datanya.
PurposeTo answer for the site you work at without asking every time.Wajib. Kalimat inilah yang disampaikan kepada orang tersebut, dan kalimat ini membatasi untuk apa data boleh dipakai.
TypeTextTeks bebas yang singkat. Type lainnya ada di Pengaturan field.
Retention (days)180Setelah jangka waktu ini, nilai dihapus. Tidak bisa tanpa batas. Default 180, maksimum 3650.
When it is includedAlwaysAtlas membutuhkan site di sebagian besar jawaban, jadi field ini selalu tersedia.
Priority100Saat token budget terlampaui, angka tertinggi dibuang lebih dulu.
How it may be capturedOnly when stated outrightDefault. Atlas menyimpan site hanya jika orang tersebut menyebutkannya, tidak pernah dari tebakan.
When the value changesKeep the newestOrang yang pindah ke site lain cukup mengatakannya.
Lawful basisLegitimate interestDipilih oleh Anda sebagai pengendali data, per field.
SensitivityOrdinary personal dataLokasi kerja bukan data kategori khusus.

Biarkan Core field mati. Biarkan Show prominently dan The person may correct it menyala. Klik Apply.

Dialog New memory field yang diisi untuk Atlas: Key home_site, Label Home site, Purpose 'To answer for the site you work at without asking every time.', Type Text, Retention (days) 180, When it is included Always, Priority 100, How it may be captured Only when stated outright, When the value changes Keep the newest, Lawful basis Legitimate interest, Sensitivity Ordinary personal data, Core field mati, Show prominently dan The person may correct it menyala, dengan tombol Cancel dan Apply

Klik Add field lagi dan deklarasikan field kedua dengan pengaturan yang sama, kecuali:

PengaturanNilai untuk Atlas
Keydepartment
LabelDepartment
PurposeTo name the right Department Head and cost centre in approval answers.

Daftar kini menampilkan kedua field. Judulnya menghitung field yang dideklarasikan terhadap batas organization Anda (2 of 12 declared). Setiap baris menampilkan label dan key, ringkasan satu baris (Text · kept 180d · always included), purpose, dan kolom Filled. Filled menampilkan jumlah agregat, misalnya "38 of 210", tidak pernah nilai individual. Kolom ini menampilkan tanda strip sampai ada nilai seseorang yang tersimpan. Field diberi chip core jika merupakan core field, dan chip oranye sensitive untuk data kategori khusus. Pakai ikon pensil untuk mengedit field dan ikon tempat sampah untuk menghapusnya.

Tab Memory Fields yang menampilkan 2 of 12 declared dan tombol Add field. Baris: Home site (home_site, Text · kept 180d · always included) dengan purpose 'To answer for the site you work at without asking every time.', dan Department (department, Text · kept 180d · always included) dengan purpose 'To name the right Department Head and cost centre in approval answers.'. Filled menampilkan tanda strip untuk keduanya, dengan tombol edit dan hapus

Pengaturan field

Dialog ini juga menawarkan opsi berikut:

PengaturanOpsi
TypeText, Number, Date, Choice (salah satu dari set tetap), Yes / No, atau List (sekumpulan item, masing-masing dengan riwayatnya sendiri).
When it is includedAlways · When the conversation mentions a keyword · When a particular tool is available · Only on request. Field on-demand tidak pernah disisipkan: agent hanya mengambilnya saat benar-benar membutuhkannya.
How it may be capturedOnly when stated outright (default) · May be inferred from context. Mode eksplisit berarti tidak ada tebakan tentang orang tersebut.
When the value changesKeep the newest · Keep the first · Ask before replacing. Koreksi yang dibuat orang itu sendiri tidak pernah ditimpa oleh tebakan.
Lawful basisConsent · Necessary for a contract · Legitimate interest. Dipilih oleh Anda sebagai pengendali data, per field.
SensitivityOrdinary personal data · Special category (kesehatan, keyakinan, …). Nonaktif kecuali organization Anda mengizinkan data kategori khusus ("Your organization has not enabled special-category data."); memilihnya memaksa lawful basis menjadi Consent.

Field Choice dan List memakai daftar Options yang dipisahkan koma. Field List juga menentukan item mana yang masuk ke prompt (yang terakhir dikonfirmasi, semuanya, atau yang paling dekat dengan percakapan) dan berapa banyak. Maksimumnya 25, dan angka ini mengatur berapa banyak item yang masuk ke prompt, bukan berapa banyak yang disimpan.

Tiga switch melengkapi dialog ini:

  • Core field: selalu disertakan, dan tidak pernah dipangkas oleh token budget.
  • Show prominently: mendapat tempat tersendiri di halaman memori orang tersebut, bukan hanya berada di daftar lengkap.
  • The person may correct it: orang tersebut bisa mengubah nilainya sendiri, dan koreksinya tidak pernah ditimpa oleh tebakan.

Dua yang terakhir hanya mengubah tampilan. Setiap field selalu muncul di akses data dan ekspor milik orang tersebut, apa pun pengaturannya.

Apply menyiapkan perubahan; satu tombol Save di halaman yang menyimpannya.

Sebuah field layak ada jika merupakan fakta yang akan Anda tindak lanjuti dan cukup stabil sehingga masih benar di lain waktu. Kandidat yang baik adalah hal yang akan sedikit mengganggu jika seseorang harus mengulanginya: site tempat mereka bekerja, departemen mereka, bahasa yang mereka sukai. Kandidat yang buruk adalah apa pun yang berubah di setiap percakapan, misalnya nilai pengajuan yang sedang mereka tanyakan. Untuk itulah ada konteks percakapan.

Jaga nilainya tetap singkat; sebuah slot menyimpan fakta, bukan catatan. Utamakan Choice daripada Text jika jawabannya memang terbatas, agar tidak menumpuk tiga ejaan berbeda untuk site yang sama. Kirana bisa menjadikan home_site field Choice yang berisi daftar site-nya; tutorial ini memakai Text agar tetap singkat. Dan atur priority dengan sengaja: itulah urutan agent melupakan sesuatu saat ruangnya terbatas.

Mengubah field di kemudian hari

Mengedit skema agent yang sudah punya profil adalah cara termudah untuk merusak data tanpa disadari.

PerubahanYang terjadi
Menghapus fieldNilainya langsung berhenti dipakai dan dihapus setelah masa tenggang 30 hari. Sampai saat itu field berada di bawah Scheduled for deletion dengan tombol Restore, dan mendeklarasikan ulang key yang sama akan memulihkannya, bukan menduplikasinya.
Mengubah typeSebaiknya dihindari. Perlakukan key dan type bersama-sama sebagai identitas field, seperti kolom database.
Mengubah purpose atau sensitivityBukan perubahan kosmetik. Data yang dikumpulkan untuk satu tujuan tidak boleh dialihkan ke tujuan lain, sehingga perubahan yang material diperlakukan seperti membuat field baru.
Mengubah retentionMemperpendek berlaku seketika. Memperpanjang tidak berlaku surut: nilai yang sudah dikumpulkan tetap memakai retention yang disampaikan kepada orang tersebut.
Mengubah label atau deskripsiKosmetik dan aman.

Memory Fields mengikuti versi draft dan versi published agent Anda, sehingga Anda bisa menambahkan field di draft dan mencobanya sebelum publish. Namun data yang tersimpan dipakai bersama oleh keduanya, artinya menguji draft agent menulis ke profil sungguhan. Uji dengan akun uji, bukan akun rekan kerja.


Langkah 3: Periksa tab Configuration

Buka tab Configuration. Untuk Atlas nilai default-nya sudah tepat, jadi Anda cukup memeriksanya.

Tab Configuration: Prompt Budget (tokens) 400 dengan catatan 'Your organization allows up to 800.', Confirm Before Storing mati, Say Where It Came From menyala, dan Personalization AI Model berisi Organization default (→ Light), yang mewarisi model default organization, Light

Prompt Budget (tokens)

The limit that actually binds: fields are trimmed by priority once memory exceeds this.

Default 400. Catatan di bawah field menunjukkan batas atas yang diizinkan organization Anda (di sini, hingga 800). Inilah batasan sebenarnya, bukan jumlah field, karena satu field List bisa tumbuh jauh lebih besar daripada field bernilai tunggal. Dua field Text pendek seperti milik Atlas muat dengan mudah.

Berapa banyak field yang boleh Anda deklarasikan tidak diatur di sini. Itu adalah pengaturan organization. Lihat Batas yang ditetapkan organization Anda di bawah.

Confirm Before Storing

The agent asks the person before it writes anything down, rather than capturing it silently.

Mati secara default. Menyalakannya membuat setiap perekaman terlihat saat itu juga tetapi lebih lambat; membiarkannya mati berarti orang tersebut melihatnya setelahnya, di halaman memorinya sendiri. Mana yang tepat bergantung pada seberapa sensitif field yang Anda deklarasikan. Atlas membiarkannya mati. Orang tersebut tetap memberi persetujuan sekali sebelum apa pun disimpan (lihat Apa yang dilihat orang tersebut).

Say Where It Came From

The agent says "based on what you told me earlier" when something it remembers shapes a reply.

Aktif secara default, dan sebaiknya dibiarkan aktif. Agent yang diam-diam tahu banyak hal terasa mengganggu, sedangkan agent yang menjelaskan dirinya tidak.

Personalization AI Model

Used to pick out declared details from what the person says. It runs only when a turn actually contains something you asked the agent to remember.

Klausa terakhir itulah inti soal biaya: giliran yang jelas tidak berisi hal relevan disaring sebelum ada panggilan AI, sehingga sebagian besar giliran tidak menambah biaya. Biarkan di Organization default kecuali Anda punya alasan lain. Tugasnya kecil dan terstruktur, dan tidak membutuhkan model Anda yang paling canggih. Di bawah dropdown, CMS menampilkan model yang saat ini dipakai sebagai default.


Langkah 4: Simpan

Klik Save. Switch, angka-angka, dan daftar field disimpan bersamaan. Jika backend menolak sesuatu, semua masalah dilaporkan sekaligus dengan menyebut field-nya, misalnya "purpose is required on 'home_site'".


Langkah 5: Biarkan Atlas mengingat Anda di preview

Buka preview sambil login dengan akun uji, mulai percakapan baru, lalu beri tahu Atlas tempat Anda bekerja:

I'm based at the Surabaya site and I work in Procurement.

Atlas tidak langsung menyimpannya. Atlas lebih dulu meminta izin, kurang lebih "May I remember those details?", dan memberi tahu apa yang akan disimpannya. Setujui, misalnya dengan:

Yes, please remember that.

Detail yang Anda sampaikan sebelum menyetujui tidak disimpan. Izin berlaku untuk apa yang Anda katakan sejak saat itu. Atlas tidak kembali menyimpan kalimat yang Anda ucapkan sebelum menyetujui. Sampaikan detailnya lagi setelah Anda setuju.

Mulai percakapan baru dan sampaikan lagi:

I'm based at the Surabaya site and I work in Procurement.

Persetujuan diminta sekali per agent, jadi Atlas tidak bertanya lagi. Atlas mengonfirmasi bahwa Anda bekerja di Procurement di site Surabaya dan menanyakan apa yang bisa dibantunya. Kedua field kini tersimpan di profil Anda.

Preview Atlas di percakapan baru, di bawah welcome message dan contoh pertanyaan. User menulis 'I'm based at the Surabaya site and I work in Procurement.' dan Atlas mengonfirmasi bahwa user bekerja di Procurement di site Surabaya, lalu bertanya 'What operational task can I help with?'

Periksa hasilnya

  1. Mulai percakapan baru lagi dan ajukan pertanyaan yang jawabannya bergantung pada site, tanpa menyebut site-nya:

    Which cost centre should my next capex request use?
    

    Atlas menyebut site Surabaya dengan sendirinya dan menyebut cost centre-nya, CC-210. Karena sebuah pengajuan bisa untuk site proyek yang berbeda, Atlas tetap memastikan site mana yang dimaksud, sesuai instruksi Interaction-nya untuk bertanya lebih dulu jika site mengubah jawaban.

    Preview Atlas di percakapan baru. User bertanya 'Which cost centre should my next capex request use?' dan Atlas menjawab: 'Which site is this capex request for? The cost centre depends on the project site (for Surabaya, it's CC-210).' dengan rujukan KG-F12 checklist, Cost centres
  2. Tanyakan "what do you remember about me?". Atlas seharusnya menyebutkan home site dan departemen Anda.

  3. Buka tautan Your memory di sidebar untuk melihat kedua nilai beserta purpose, masa kedaluwarsa, dan kutipan asalnya. Di CMS, kolom Filled pada setiap field menghitung berapa banyak orang yang punya nilainya.

  4. Publish agent setelah field-field berperilaku sesuai keinginan Anda.

Jika sebuah nilai tidak ada, pastikan Anda mengulang detailnya setelah menyetujui, Anda dalam keadaan login, serta Purpose dan Type field tersebut sudah tersimpan.


Batas yang ditetapkan organization Anda

Dua angka yang membatasi halaman ini berada di level organization, bukan agent, di Organization → Personalization. Keduanya diatur oleh Owner atau Admin organization.

BatasFungsinya
Memory fields per agentBerapa banyak field yang boleh dideklarasikan setiap agent di organization, hingga batas platform 30. Begitu daftar mencapainya, Add field dinonaktifkan.
Prompt budget ceilingJumlah maksimum yang boleh dipakai agent mana pun untuk data yang diingat, hingga 800. Setiap agent menetapkan budget-nya sendiri di bawah angka ini.

Jumlah field sengaja tidak dijadikan pengaturan agent. Tujuannya adalah membatasi apa yang boleh dideklarasikan contributor, dan batas yang bisa dinaikkan sendiri oleh contributor bukanlah batas. Karena itu agent tidak menyimpan angkanya sendiri, dan angka organization adalah satu-satunya.

Menurunkan salah satunya di kemudian hari aman bagi data yang sudah direkam. Field yang sudah dideklarasikan tidak pernah dihapus oleh batas yang diturunkan belakangan; agent hanya tidak bisa menambah field lagi sampai jumlahnya kembali di bawah batas. Prompt budget yang melebihi batas atas yang diturunkan akan diturunkan mengikutinya.

Sebagai catatan, biaya mengikuti field yang benar-benar terisi, bukan jumlah yang dideklarasikan: dua belas field dideklarasikan dengan tiga yang terisi berarti biaya untuk tiga.


Apa yang dilihat orang tersebut

Orang yang diingat datanya tidak pasif di sini, dan sebagian besar hal berikut adalah hak mereka, bukan sekadar kebaikan hati. User yang login pada agent yang memorinya aktif mendapat tautan Your memory di sidebar. Tautan itu membuka halaman berisi semua yang disimpan tentang mereka: setiap nilai dengan "Kept because: {tujuan Anda}", masa kedaluwarsanya, dan kutipan asalnya.

Di sana mereka bisa mengoreksi field (jika Anda mengizinkannya), melupakan salah satunya, Download a copy, Erase everything, atau Pause remembering, yang menghentikan pembacaan dan penulisan tanpa menghapus apa pun.

Mereka juga bisa melakukan semuanya lewat percakapan biasa, cukup dengan meminta: "apa yang kamu ingat tentang saya?", "lupakan home site saya", "berhenti mengingat hal tentang saya". Jalur ini penting bagi orang di WhatsApp dan channel pesan lainnya, yang tidak punya halaman untuk dikunjungi. Cara ini berfungsi sejak giliran pertama: seseorang berhak bertanya apa yang Anda ketahui dan diberi tahu "tidak ada".

Persetujuan diminta sekali per agent. Alih-alih menyela dengan dialog, agent menanyakannya di dalam percakapan saat salah satu detail yang Anda deklarasikan muncul, memberi tahu orang tersebut apa yang akan disimpan dan mengapa, lalu bertanya. Tidak ada yang ditulis sampai mereka menjawab, dan apa yang mereka katakan sebelum menyetujui tidak disimpan setelahnya. Agent tidak memaksa jika mereka menolak.

Tautan maupun kontrol lewat percakapan hanya muncul untuk orang yang login; participant anonim tidak punya profil untuk disimpan.


Siapa di tim Anda yang bisa melihatnya

Secara default tidak ada yang melihat nilai individual: contributor hanya melihat jumlah agregat Filled. Ini disengaja. Menyempurnakan skema, tugas yang paling umum, tidak membutuhkan membaca data pribadi siapa pun.

Melihat data yang diingat tentang satu orang membutuhkan izin eksplisit, dibuka dari participant tertentu tersebut (bukan dijelajahi sebagai tabel), dan dicatat setiap kali. Dua switch di level organization berada di atasnya, keduanya tertutup secara default dan hanya bisa diubah oleh Owner organization:

  • Staff may view what agents remember about individual participants: selama mati, tidak ada contributor yang bisa membuka data participant, apa pun level aksesnya.
  • Agents may declare special-category memory fields: selama mati, dropdown Sensitivity di sini dinonaktifkan.

Kedua switch itu punya syarat yang lebih tinggi daripada batas di atas, yang juga boleh diatur oleh Admin. Perbedaannya ada pada apa yang diputuskan: switch menentukan data pribadi apa yang bersedia diproses organization sama sekali, sedangkan batas hanya membatasi seberapa banyak yang boleh dibawa sebuah agent.

Lihat Mengelola Akses Agent untuk kelima level akses dan siapa yang boleh memberikannya.


Langkah berikutnya