Apa itu Alat (Tools) Capitão dan Bagaimana Cara Menggunakannya?

Q: Apakah saya perlu tahu cara memprogram untuk menggunakan Alat?

Untuk Alat Natif, seperti integrasi dengan Google Agenda, tidak diperlukan pengetahuan pemrograman. Konfigurasi dilakukan melalui antarmuka yang sederhana. Untuk Alat Kustom (HTTP), diperlukan pengetahuan teknis tentang cara kerja API, termasuk metode HTTP, autentikasi, dan format JSON.

Q: Bagaimana AI tahu Alat mana yang harus digunakan?

AI memutuskan alat mana yang akan digunakan berdasarkan deskripsi yang Anda berikan saat mengkonfigurasinya. Deskripsi yang jelas dan terperinci, yang menjelaskan tujuan alat dan informasi apa yang dibutuhkannya, sangat penting. Capitão menganalisis niat pelanggan dan membandingkannya dengan deskripsi semua alat yang tersedia untuk memilih yang paling sesuai.

Alat (Tools) Capitão adalah tindakan yang dapat dijalankan oleh asisten kecerdasan buatan Papo (https://papo.global/) untuk mengotomatiskan tugas dan berinteraksi dengan sistem lain. Alat ini memungkinkan AI untuk tidak hanya menjawab pertanyaan, tetapi juga melakukan tindakan praktis seperti menjadwalkan rapat, memeriksa status pesanan di sistem eksternal, atau membuat peluang bisnis baru di CRM Anda, semuanya langsung dari percakapan dengan pelanggan.

Dengan Alat, Anda mengubah asisten Capitão Anda dari informan pasif menjadi agen proaktif. Ia dapat memahami niat pelanggan dan menggunakan alat tertentu untuk menyelesaikan permintaan secara langsung, tanpa perlu intervensi manusia. Ini membuka berbagai kemungkinan untuk otomatisasi yang kompleks dan efisien.

Jenis Alat	Deskripsi	Contoh Penggunaan	Pengetahuan Teknis
Natif	Integrasi yang sudah dikonfigurasi sebelumnya dan siap digunakan, tersedia di platform Papo.	Menjadwalkan demo di Google Agenda milik seorang sales.	Rendah (hanya perlu mengaktifkan dan menghubungkan akun).
Kustom (HTTP)	Tindakan yang disesuaikan yang terhubung ke sistem eksternal (ERP, CRM) atau API Papo itu sendiri.	Memeriksa status pesanan di sistem e-commerce perusahaan.	Tingkat Lanjut (membutuhkan pengetahuan tentang API dan permintaan HTTP).

Bagaimana Alat Capitão Bekerja?

Proses kerja sebuah Alat (Tool) adalah siklus cerdas yang menghubungkan percakapan pelanggan dengan tindakan konkret:

Interpretasi Niat: Pelanggan mengirim pesan seperti "Saya ingin tahu di mana pesanan saya 12345" atau "Saya ingin menjadwalkan rapat dengan konsultan".
Pemilihan Alat: Capitão menganalisis pesan dan, berdasarkan instruksi serta deskripsi alat yang telah Anda konfigurasikan, mengidentifikasi alat mana yang paling sesuai untuk menyelesaikan permintaan tersebut.
Eksekusi Tindakan: AI mengaktifkan alat yang dipilih. Jika itu adalah alat untuk memeriksa pesanan, ia akan mengirim nomor "12345" ke sistem eksternal Anda. Jika untuk menjadwalkan, ia akan memeriksa waktu luang di agenda.
Pengembalian Respons: Sistem eksternal atau alat natif mengembalikan hasil (misalnya: "Pesanan dalam pengiriman" atau "Waktu yang tersedia: 14.00 dan 15.00").
Komunikasi ke Pelanggan: Capitão menggunakan informasi ini untuk merumuskan respons yang alami dan lengkap kepada pelanggan, menyelesaikan permintaan secara mandiri.

Alur ini mengubah layanan pelanggan, memungkinkan AI untuk menyelesaikan masalah dari awal hingga akhir, dan tidak hanya memberikan informasi dasar.

Jenis Alat: Natif vs. Kustom

Anda dapat melengkapi asisten Capitão Anda dengan dua jenis alat, masing-masing dengan tujuan yang berbeda.

Alat Natif

Ini adalah integrasi siap pakai, yang dikembangkan dan dikelola oleh Papo. Tujuannya adalah untuk menyederhanakan koneksi dengan layanan populer tanpa Anda perlu khawatir tentang detail teknis.

Contoh utamanya adalah integrasi dengan Google Agenda. Dengan mengaktifkannya, Anda memungkinkan Capitão untuk:

Memeriksa ketersediaan secara real-time di agenda satu atau lebih anggota tim.
Menawarkan waktu luang kepada pelanggan selama percakapan.
Membuat acara secara otomatis di agenda segera setelah pelanggan mengkonfirmasi waktu yang diinginkan.

Konfigurasi biasanya hanya melibatkan otorisasi Papo untuk mengakses akun Anda di layanan eksternal dan mengaktifkan alat untuk asisten Anda.

Alat Kustom (HTTP)

Alat kustom menawarkan fleksibilitas penuh, memungkinkan Capitão untuk berkomunikasi dengan hampir semua sistem yang memiliki API (Application Programming Interface). Ini termasuk ERP, CRM, platform e-commerce Anda, atau bahkan modul lain dari Papo itu sendiri.

Untuk mengkonfigurasi alat kustom, Anda perlu memberikan detail permintaan HTTP yang harus dilakukan AI:

URL Endpoint: Alamat API yang akan dipanggil (misalnya: https://api.meusistema.com/v1/pedidos).
Metode HTTP: Tindakan yang akan dilakukan (GET untuk mengambil data, POST untuk membuat, PUT untuk memperbarui, dll.).
Headers (Header): Informasi tambahan, seperti kunci autentikasi (Authorization: Bearer sk_sua_chave_secreta) untuk memastikan permintaan aman dan terotorisasi.
Body (Isi Permintaan): Data yang akan dikirim, biasanya dalam format JSON. Anda dapat menggunakan variabel dari percakapan untuk membuat tindakan menjadi dinamis (misalnya: {"id_pedido": "{variavel_numero_pedido}"}).

Dengan ini, Anda dapat membuat otomatisasi seperti "memeriksa saldo poin loyalitas", "membuat prospek baru di CRM Papo", atau "membuka tiket dukungan di sistem internal Anda".

Langkah demi Langkah: Cara Mengkonfigurasi Alat di Capitão

Meskipun nama menu yang tepat dapat bervariasi, proses konseptual untuk mengaktifkan alat bagi asisten Anda mengikuti logika yang jelas:

Akses Pengaturan Asisten: Di panel Papo, navigasikan ke area konfigurasi Capitão yang ingin Anda tingkatkan.
Temukan Bagian Alat: Di dalam opsi konfigurasi asisten, temukan area yang didedikasikan untuk "Alat" (Tools).
Tambahkan Alat Baru: Pilih antara menambahkan alat "Natif" atau "Kustom (HTTP)".
Untuk Alat Natif: Pilih layanan yang diinginkan (seperti Google Agenda) dari daftar integrasi yang tersedia. Ikuti instruksi di layar untuk menghubungkan dan mengotorisasi akun Anda.
Untuk Alat Kustom:
- Berikan Nama dan Deskripsi: Buat nama yang jelas (misalnya: "Periksa Status Pesanan") dan deskripsi terperinci untuk AI. Deskripsi sangat penting, karena mengajarkan Capitão kapan dan bagaimana menggunakan alat tersebut (misalnya: "Gunakan alat ini untuk memeriksa status pesanan pelanggan ketika ia memberikan nomor pesanan").
- Konfigurasi Permintaan HTTP: Isi kolom URL endpoint, metode HTTP, header (untuk autentikasi), dan isi permintaan, jika diperlukan.
Aktifkan dan Uji: Setelah konfigurasi, aktifkan alat agar Capitão dapat mulai menggunakannya. Lakukan pengujian dengan mengirim pesan yang seharusnya memicu alat baru untuk memastikan semuanya berfungsi seperti yang diharapkan.

Pertanyaan yang Sering Diajukan (FAQ)

Apa perbedaan antara Alat (Tools) dan Skenario?

Alat (Tools) dirancang untuk menjalankan tindakan di sistem eksternal atau bagian lain dari API Papo, seperti memeriksa database atau menjadwalkan acara. Sedangkan Skenario adalah instruksi bagi Capitão untuk menjalankan tindakan internal di platform, seperti mentransfer percakapan ke agen manusia (transbordo) dalam situasi tertentu.

Apakah saya perlu tahu cara memprogram untuk menggunakan Alat?

Untuk Alat Natif, seperti integrasi dengan Google Agenda, tidak diperlukan pengetahuan pemrograman. Konfigurasi dilakukan melalui antarmuka yang sederhana. Untuk Alat Kustom (HTTP), diperlukan pengetahuan teknis tentang cara kerja API, termasuk metode HTTP, autentikasi, dan format JSON.

Bagaimana AI tahu Alat mana yang harus digunakan?

AI memutuskan alat mana yang akan digunakan berdasarkan deskripsi yang Anda berikan saat mengkonfigurasinya. Deskripsi yang jelas dan terperinci, yang menjelaskan tujuan alat dan informasi apa yang dibutuhkannya, sangat penting. Capitão menganalisis niat pelanggan dan membandingkannya dengan deskripsi semua alat yang tersedia untuk memilih yang paling sesuai.

Bisakah saya menggunakan Alat untuk berinteraksi dengan API Papo itu sendiri?

Ya. Anda dapat mengkonfigurasi Alat Kustom (HTTP) untuk melakukan panggilan ke API Papo. Ini memungkinkan Anda membuat otomatisasi tingkat lanjut, seperti menggunakan AI untuk membuat kontak baru di CRM, mengirim pesan melalui saluran lain, atau memperbarui atribut pelanggan, semuanya dari instruksi dalam percakapan.

Apakah aman menggunakan Alat Kustom dengan kunci API saya?

Ya. Informasi autentikasi, seperti kunci API (token), disimpan dengan aman di platform Papo dan digunakan dalam komunikasi server-ke-server, yang lebih aman. Merupakan praktik keamanan yang baik untuk membuat kunci API dengan izin terbatas khusus untuk integrasi ini, daripada menggunakan kunci dengan akses penuh.