# AI Agents (/agent)

**Agent** adalah AI yang membalas komentar dan DM atas nama akunmu. Kamu yang menulis instruksinya (gaya bahasa, apa yang boleh dan tidak boleh dijanjikan) dan memberinya **Knowledge**: FAQ, katalog, daftar harga, atau halaman web. Agent mencari jawabannya di sana sebelum membalas.

Agent bisa dipakai dengan tiga cara:

- **Automations "Dijawab AI"**: agent membalas sendiri setiap DM atau komentar baru (lihat [Membalas lewat Automations](#membalas-lewat-automations)).
- **Draft AI** di Inbox dan Komentar: agent menyiapkan balasan, kamu yang memeriksa lalu mengirimnya.
- **Uji coba**: mengobrol dengan agent di dashboard tanpa mengirim apa pun ke pelanggan.

## Yang dibutuhkan [#yang-dibutuhkan]

- **Paket berbayar.** Jumlah agent dan Knowledge tergantung paket:

  | Paket   | Agent | Knowledge | Total isi Knowledge | Tambah atau ubah Knowledge per hari |
  | ------- | ----- | --------- | ------------------- | ----------------------------------- |
  | Free    | -     | -         | -                   | -                                   |
  | Starter | 1     | 5         | 200 ribu karakter   | 20                                  |
  | Basic   | 2     | 15        | 500 ribu karakter   | 40                                  |
  | Pro     | 5     | 40        | 1,5 juta karakter   | 100                                 |
  | Agency  | 50    | 500       | 10 juta karakter    | 300                                 |

  Batas ini dihitung dari semua workspace di akun Tebar-mu.

- **API key Sumopod.** Agent memakai model AI lewat [Sumopod](https://sumopod.com), dan biaya modelnya dibayar dari saldo AI Sumopod milikmu, bukan dari Tebar.

<Callout type="warn">
  Di paket Free, agent tidak berjalan sama sekali: automation, Draft AI, dan Uji coba berhenti.
  Agent dan Knowledge-mu tetap tersimpan dan langsung jalan lagi setelah kamu upgrade.
</Callout>

## 1. Hubungkan API key Sumopod [#1-hubungkan-api-key-sumopod]

1. Di Sumopod, top up **AI Balance** dulu, lalu buka menu **AI** → **API Keys** → **+ API Key**. Key diawali `sk-` dan hanya ditampilkan sekali, jadi langsung salin. Langkah lengkapnya ada di [panduan Sumopod](https://docs.sumopod.com/guides/ai/create-api-key).
2. Di Tebar, buka menu **Agent** → **Hubungkan API key**, tempel key-nya, lalu **Simpan**.

Tebar mengecek key-nya dan menampilkan model yang bisa dipakai. Key disimpan terenkripsi dan berlaku untuk workspace itu. Kalau saldo Sumopod habis atau key dicabut, agent berhenti membalas sampai key-nya diperbaiki; tekan **Cek ulang** setelah top up.

Sisa **saldo AI Sumopod** terlihat di jendela **API key** (diperbarui setiap beberapa menit). Saat saldo tinggal kurang dari $1, tombol **API key** diberi tanda kuning supaya kamu sempat top up sebelum agent berhenti.

<Callout>
  Supaya pengeluaran terkendali, beri **batas kredit** pada key saat membuatnya di Sumopod.
</Callout>

## 2. Buat agent [#2-buat-agent]

Klik **Buat agent**, beri nama, lalu atur di tab **Pengaturan**:

- **Instruksi**: siapa agent ini dan bagaimana ia menjawab. Contoh: _"Kamu CS Toko Kaos. Jawab ramah dan singkat, pakai 'kak'. Jangan menjanjikan diskon. Kalau ditanya stok, cek Knowledge dulu."_ Belum tahu harus menulis apa? Klik **Buat dengan AI**: Tebar membaca tulisan akunmu sendiri, lalu menulis instruksinya.
- **Knowledge**: pilih sumber yang boleh dicari agent (lihat [Knowledge](#knowledge)). Tanpa Knowledge, agent hanya menjawab dari instruksinya.
- **Serahkan ke kamu**: kapan agent berhenti dan menandai percakapan **Butuh kamu** di Inbox. Pilihannya: pelanggan menulis kata tertentu (misalnya "komplain", "refund", "admin"), pelanggan terdengar kesal atau marah, dan jawabannya tidak ada di Knowledge.
- **Pemberitahuan AI**: DM dari agent diawali "🤖 Dibalas otomatis oleh AI." di awal percakapan, setelah lama tidak ada pesan, atau setelah kamu membalas. Biarkan menyala: aturan Meta mewajibkan pelanggan tahu kapan mereka dilayani bot.

Model AI dipilih di tab **Model & batas**. Coba agent di tab **Uji coba** sebelum dipakai ke pelanggan: kirim pertanyaan seperti pelanggan sungguhan, lalu lihat jawabannya. Riwayat setiap jawaban ada di tab **Riwayat run**.

## Knowledge [#knowledge]

Menu **Knowledge** menyimpan sumber yang bisa dipakai semua agent di workspace itu. Klik **Tambah**, lalu pilih jenisnya:

| Jenis                 | Isinya                                                                     |
| --------------------- | -------------------------------------------------------------------------- |
| **Teks**              | Tulis atau tempel langsung, misalnya FAQ atau kebijakan pengiriman         |
| **Link**              | Halaman web publik (`https`); isi utamanya dibaca, menu dan iklan dilewati |
| **File**              | PDF, DOCX, TXT, Markdown, atau CSV, maksimal 20 MB                         |
| **Post akun**         | Post yang sudah terbit, supaya gaya bahasa agent mirip akunmu              |
| **Balasan tersimpan** | Balasan tersimpan dari Inbox                                               |
| **Balasan komentar**  | Balasan komentar yang pernah kamu tulis                                    |

Tebar membaca sumbernya dalam beberapa detik sampai beberapa menit (status **Sedang dibaca**, lalu **Selesai**). Sumber yang lebih panjang dari batas paketmu hanya dibaca bagian awalnya. Kalau isi halaman web atau file berubah, tekan **Baca ulang**; menambah, mengubah, dan membaca ulang dihitung dalam batas harian di atas.

## Membalas lewat Automations [#membalas-lewat-automations]

Agent membalas pelanggan lewat [Automations](/automations). Ada dua cara:

- **Template "Dijawab AI"**: **Balas semua DM dengan AI** (Instagram) dan **Balas semua komentar dengan AI** (Instagram dan Threads). Agent menjawab setiap DM atau komentar yang tidak dijawab automation lain.
- **Balas dengan AI** di automation yang sudah ada (DM dengan kata kunci, balasan DM otomatis, dan balas komentar): pilih agent-nya, dan agent yang menjawab, bukan pesan tetap.

Pesan yang kamu tulis di automation tetap dipakai sebagai **cadangan**: dikirim bila agent dimatikan, saldo Sumopod habis, atau agent gagal menjawab.

Sebelum menjawab, agent membaca konteksnya: untuk komentar, isi post (teksnya, bukan gambar atau video), komentar yang sedang dibalas, dan balasanmu sebelumnya; untuk DM, pesan-pesan terakhir di percakapan itu.

**Saat kamu ikut membalas:** kalau kamu membalas percakapan sendiri, agent diam dulu. Atur berapa lama di automation lewat **Menjawab lagi setelah kamu diam** (15 menit sampai 7 hari, atau **Manual**). Di Inbox, tombol **Kembalikan ke AI** menyerahkan percakapan ke agent lagi kapan saja.

**Pelanggan bisa berhenti.** Kalau pelanggan menulis **stop**, **berhenti**, atau **unsubscribe**, automation yang memakai agent tidak mengirim pesan otomatis lagi ke percakapan itu selama 30 hari, baik dari agent maupun pesan cadangannya.

## Draft AI di Inbox dan Komentar [#draft-ai-di-inbox-dan-komentar]

Di percakapan Inbox atau di bawah komentar, klik **Draft AI** lalu pilih agent. Balasannya muncul di kotak balas: periksa, ubah bila perlu, lalu kirim sendiri. Draft AI tidak pernah mengirim apa pun tanpa kamu. Draft AI bisa dipakai di komentar semua platform yang komentarnya tampil di Tebar.

## Hal yang perlu diketahui [#hal-yang-perlu-diketahui]

- **AI bisa salah.** Agent menjawab fakta bisnis (harga, stok, jam buka) hanya dari Knowledge, tetapi tetap periksa Riwayat run sesekali, terutama di minggu pertama. Kamu bertanggung jawab atas balasan yang dikirim atas nama akunmu.
- **Komentar dan DM pelanggan** diberikan ke AI sebagai data, bukan perintah, jadi pelanggan tidak bisa menyuruh agent melakukan hal lain.
- **Data apa yang dikirim ke Sumopod** dan penyedia model dijelaskan di [Kebijakan Privasi](https://tebar.app/privacy#agent-ai).
- **Batas DM Instagram:** agent hanya bisa membalas DM dalam 24 jam sejak pesan terakhir pelanggan, sama seperti balasan dari Inbox.
