CRMAI DocsAgent Tools
Tujuan
"Manage which tools this agent can use. Tools with a level above the agent's autonomy level require human approval." Setiap tool yang bisa dipanggil oleh agent terdaftar dengan Level yang dibutuhkan; apakah tool tersebut benar-benar dapat digunakan bergantung pada Authority Limit Level agent yang ditetapkan di Governance.
Tools yang tersedia
Tool | Level | Fungsinya |
|---|---|---|
Tag Customer | 4 | Menambahkan tag ke pelanggan saat ini. Berikan baik tagName maupun existingTagId; atur field yang tidak digunakan menjadi null. |
Fill Customer Data | 4 | Memperbarui profil pelanggan saat ini dengan detail yang diekstrak dari percakapan. Berikan name, email, dan company; gunakan null untuk field yang tidak ingin Anda ubah. |
Route Ticket | 7 | Menugaskan ulang tiket saat ini ke agent dan/atau queue lain. Berikan targetUserId dan targetQueueId; atur yang tidak digunakan menjadi null. Reason bersifat opsional dan dapat berupa null. |
Get Customer Info | 2 | Mengembalikan profil pelanggan saat ini, termasuk kontak email/WhatsApp, tags, company, dan custom fields. |
Load Chat History | 1 | Memuat riwayat chat yang lebih lama dari tiket saat ini ketika konteks percakapan yang tersedia tidak cukup. Berikan limit dan cursor; atur cursor menjadi null untuk mulai dari halaman terbaru. Mengembalikan message turns yang ringkas untuk digunakan oleh LLM. |
Describe Image | 1 | Mendeskripsikan isi sebuah gambar yang dikirim pelanggan. Berikan assetId dari gambar tersebut (tercantum dalam konteks percakapan). Mengembalikan deskripsi teks termasuk teks apapun yang terlihat. Digunakan ketika caption saja tidak cukup untuk memahami gambar tersebut. Selalu aktif — tidak dapat dinonaktifkan. |
Anotasi yang disarankan: beri kode warna berdasarkan state, bukan nomor urut — 🔴 garis luar merah di sekeliling setiap kartu yang menampilkan NOT ACCESSIBLE (Tag Customer, Fill Customer Data, Route Ticket dalam contoh), 🟢 garis luar hijau di sekeliling kartu yang accessible tetapi disabled (Get Customer Info, Load Chat History), 🔵 garis luar biru di sekeliling Always active (Describe Image). Tambahkan satu legenda bersama di bawah gambar yang memetakan ketiga warna ke ketiga state yang dijelaskan dalam "Accessibility and locking" di bawah — perbedaan state ini lebih penting di sini daripada urutan klik.
Accessibility dan locking
Setiap kartu tool menampilkan salah satu dari state berikut:
Toggle available, currently Disabled — tool dapat diakses (Authority Limit Level agent memenuhi persyaratan) tetapi belum diaktifkan.
🔒 NOT ACCESSIBLE — Authority Limit Level agent saat ini di bawah Level yang dibutuhkan tool tersebut. Kartu menampilkan: "Not accessible: agent authority limit (X) is below required level (Y). Increase the agent's Authority Limit Level to enable this tool." Anda harus menaikkan Authority Limit Level di Governance terlebih dahulu sebelum toggle ini menjadi tersedia.
Always active — saat ini hanya Describe Image yang bekerja seperti ini; tidak dapat dinonaktifkan.
Panduan operasional
Aktifkan hanya tools yang benar-benar dibutuhkan oleh role agent yang didefinisikan — Tag Customer, Fill Customer Data, dan Route Ticket semuanya mengubah data pelanggan/tiket, jadi tinjau dengan cermat sebelum memberikannya.
Route Ticket (Level 7) adalah tool dengan privilese tertinggi — cadangkan untuk agent yang Anda yakini seharusnya menugaskan ulang tiket secara mandiri, karena agent yang salah konfigurasi dengan tool ini dapat merutekan percakapan menjauh dari tim yang tepat.
Jika sebuah tool yang Anda butuhkan menampilkan NOT ACCESSIBLE, jangan begitu saja menaikkan Authority Limit Level untuk "membuka" tool tersebut tanpa berpikir — ingat bahwa Authority Limit Level juga membatasi panjang respons maksimum (level × 1000 token), sehingga menaikkannya memiliki efek samping di luar sekadar tool tersebut.
Load Chat History dan Get Customer Info adalah tools yang berisiko rendah dan hanya membaca (read-only) (Level 1–2) — default yang wajar untuk diaktifkan bagi kebanyakan agent yang memerlukan konteks percakapan.
Terkait: Governance & Autonomy · Shared Inbox (tautan belum tersedia) · Contact Management (tautan belum tersedia) · SmartForms (tautan belum tersedia)