Praktik terbaik untuk membuat dan mengoptimalkan Agent Kustom

Dalam dokumen bantuan ini

Praktik terbaik untuk membuat Agent Kustom Anda lebih andal dengan memperjelas tujuan, memperketat sumber, dan melakukan iterasi pada hasil.


Agent Kustom yang dirancang dengan baik menggunakan lebih sedikit kredit dan memberikan hasil yang lebih baik. Berikut cara memaksimalkan setiap proses:

  • Gunakan Agent Kustom untuk pekerjaan berulang. Untuk permintaan satu kali, gunakan Notion Agent saja—fitur ini sudah termasuk dalam paket Anda. Agent Kustom berjalan menggunakan Kredit Notion karena mereka bekerja secara otonom di latar belakang, baik Anda sedang online maupun tidak.

  • Pilih pemicu tertentu. Piculah pada @mentions atau perubahan properti tertentu, bukan setiap pesan atau update database. Lebih sedikit proses yang salah, lebih sedikit proses yang terbuang.

  • Jaga konteks tetap ketat. Arahkan Agent Kustom Anda ke halaman atau database tertentu yang dibutuhkannya. Dengan begitu, Agent Kustom hanya membaca apa yang diperlukan, dan setiap proses tetap terfokus.

  • Definisikan “selesai” di awal. Beri tahu agen Anda dengan tepat seperti apa proses yang lengkap itu. Semakin bersih instruksinya, semakin cepat agen mencapai hasilnya.

  • Kelompokkan tugas yang tidak bergantung satu sama lain. Misalnya, minta agen Anda untuk membaca beberapa sumber sekaligus alih-alih satu per satu.

    • "Baca basis data Proyek dan saluran Slack #support, lalu tulis pembaruan mingguan."

    • 🚫 "Baca basis data Proyek, lalu tulis pembaruan mingguan. Kemudian baca saluran Slack #support dan tambahkan ke pembaruan mingguan."

  • Mulai dari agen yang sudah ada jika alur kerjanya serupa. Jika alur kerja yang Anda butuhkan sudah ada sebagai Agent Kustom, duplikasikan alur kerja tersebut alih-alih membuatnya dari awal. Buka agen, pilih ••• dan pilih Duplikat.

    • Salin bersifat pribadi secara default.

    • Setelah menduplikasi, autentikasi ulang alat seperti Slack, periksa apakah pemicu terbawa sesuai harapan, dan terapkan ulang Workers apa pun — Workers tersebut tidak disertakan dalam duplikat. Ini sangat berguna untuk membuat varian tim dari agent yang berfungsi dengan cepat. Pelajari lebih lanjut tentang menduplikasi Agent Kustom dalam artikel ini.

Baru menggunakan Agent Kustom?

Mulai dengan Agent Kustom untuk mempelajari apa itu, cara kerjanya, dan apa saja yang dapat Anda hubungkan dengannya.

Agent Kustom paling andal jika memiliki tugas yang jelas, sumber yang tepat, dan definisi "selesai" yang ketat. Artikel praktik terbaik ini membahas cara menulis instruksi yang lebih baik, memilih pemicu yang tepat, dan meningkatkan hasil seiring waktu.

Jika Anda tidak yakin harus mulai dari mana, mulailah dengan pekerjaan yang sering diulang oleh tim Anda. Agen Kustom paling efektif jika alur kerjanya dapat diprediksi dan mudah ditinjau.

Cari alur kerja yang:

  • Dapat diulang, seperti menyusun laporan, melakukan triase permintaan masuk, atau menjawab pertanyaan umum di Slack

  • Sering, artinya terjadi setiap hari atau setiap minggu

  • Mudah dievaluasi, sehingga Anda dapat dengan cepat mengetahui apakah keluarannya benar

Setelah Anda memilih alur kerja, buat versi agen Anda yang paling sederhana terlebih dahulu. Jalankan dengan andal sebelum menambahkan kompleksitas.

Ketika proses terasa stabil dan dapat diprediksi, Anda dapat menambahkan pemicu atau jadwal untuk mengotomatiskannya sepenuhnya.

Saat Anda memberikan instruksi yang jelas kepada Agent Kustom Anda, agent tersebut menghasilkan hasil yang lebih konsisten dan andal. Fokuslah pada seperti apa kesuksesan itu dan berikan konteks yang dibutuhkannya untuk mencapainya.

Mulai dengan hasil yang Anda inginkan

  • Jelaskan seperti apa keluaran akhir seharusnya, alih-alih mencantumkan setiap langkah

  • Biarkan agen menentukan cara untuk mencapainya

  • Contoh: “Buat pembaruan status mingguan yang merangkum tugas yang telah selesai, hambatan, dan langkah selanjutnya.”

Bagikan contoh nyata

  • Tempel pembaruan status, laporan terformat, atau permintaan yang telah dipilah sebelumnya

  • Gunakan contoh konkret alih-alih deskripsi abstrak

Jelaskan format dan tujuan

  • Tentukan ke mana keluaran harus dikirim (Slack, database, atau halaman yang sudah ada)

  • Sebutkan properti atau bagian mana yang harus diisi

  • Contoh: “Posting ringkasan di #team-updates dan tambahkan ke database Laporan Mingguan.”

Tetapkan batasan sederhana

  • Perjelas apa yang harus dilakukan agen dan apa yang harus dihindari olehnya

  • Contoh: “Perbarui halaman laporan mingguan yang sudah ada, bukan yang baru,” atau “Hanya tanggapi di #support.”

Sebutkan kasus ekstrem

  • Jelaskan apa yang harus terjadi jika tidak ada data atau tidak ada hal baru untuk dilaporkan

  • Contoh: “Jika tidak ada pembaruan minggu ini, posting ‘Tidak ada pembaruan’ alih-alih melewatkannya.”

Buat instruksi tetap singkat dan terfokus

  • Instruksi yang lebih singkat menghasilkan hasil yang lebih konsisten

  • Jika pengaturan Anda menjadi panjang, pecahlah alur kerja menjadi beberapa agen

Saat menyiapkan Agent Kustom Anda, tentukan apakah pekerjaan harus berjalan sesuai Jadwal, sebagai respons terhadap suatu tindakan, atau keduanya.

Gunakan Jadwal untuk pekerjaan yang dapat diprediksi

  • Pilih Jadwal jika tugas harus dijalankan pada irama yang ditetapkan, terlepas dari aktivitas.

  • Ideal untuk pekerjaan berulang seperti laporan mingguan, ringkasan harian, atau rangkuman bulanan

Gunakan pemicu untuk pekerjaan yang responsif

  • Pilih pemicu jika tugas harus dijalankan sebagai respons terhadap sesuatu yang terjadi

  • Contohnya termasuk bug yang dilaporkan di Slack, halaman baru yang ditambahkan ke database, atau email dari pengirim tertentu

Gabungkan Jadwal dan pemicu jika diperlukan

  • Beberapa alur kerja memiliki dua pola

  • Sebagai contoh, satu agen berbasis pemicu dapat melakukan triase bug saat masuk, sementara agen terjadwal terpisah menyusun ringkasan mingguan dari bug yang telah ditriase tersebut

Mulai dengan frekuensi yang lebih rendah dan cakupan terbatas

  • Mulailah dengan jadwal mingguan alih-alih harian

  • Mulailah dengan satu saluran alih-alih lima

  • Tingkatkan skala setelah Anda memastikan hasilnya konsisten dan dapat diandalkan

Sebelum mengaktifkan alur kerja Anda sepenuhnya, luangkan waktu untuk menguji dan menyesuaikan pengaturan Anda.

Uji sebelum mengaktifkan pemicu atau Jadwal

  • Klik Jalankan untuk mengeksekusi agen secara manual

  • Tinjau output untuk mengonfirmasi bahwa agen berperilaku seperti yang diharapkan

  • Aktifkan pemicu atau jadwal hanya setelah hasilnya terlihat benar

Uji dengan kelompok kecil

  • Bagikan agent dengan beberapa rekan tim untuk mengumpulkan umpan balik.

  • Gunakan umpan balik awal untuk menangkap masalah sebelum meluncurkannya secara lebih luas

Harapkan iterasi

  • Sebagian besar agen memerlukan beberapa kali uji coba agar berfungsi dengan benar

  • Sempurnakan instruksi berdasarkan apa yang sebenarnya ditampilkan oleh output, bukan berdasarkan apa yang Anda maksudkan dalam instruksi tersebut

Periksa log aktivitas terlebih dahulu

  • Klik ikon jam untuk melihat apa yang memicu eksekusi tersebut

  • Tinjau apa yang dilakukan agen dan di mana agen mungkin gagal

  • Gunakan log untuk mendiagnosis masalah dan memastikan agen berperilaku seperti yang diharapkan sebelum memperluas akses

Ketahui perbaikan umum

  • "Output tidak tepat" biasanya berarti instruksi memerlukan spesifikasi lebih lanjut.

  • "Data hilang" sering kali berarti agent memerlukan akses ke halaman atau database tambahan.

    Alat dan akses

  • "Proses gagal" biasanya menunjukkan celah izin atau instruksi yang tidak jelas.

Agen yang dirancang dengan baik berjalan lebih cepat dan menghindari pekerjaan yang tidak perlu. Tiga faktor memengaruhi efisiensi:

  • Seberapa sering agen berjalan,

  • Seberapa banyak konten yang dibacanya, dan

  • Berapa banyak langkah yang diperlukan untuk menyelesaikan tugas

1. Kurangi seberapa sering agen Anda berjalan

Cara termudah untuk meningkatkan kinerja adalah dengan membatasi proses yang tidak perlu. Rancang pemicu agar agen hanya berjalan saat kemungkinan besar akan mengambil tindakan.

Mulai dari yang kecil dan tingkatkan skala

  • Mulailah dengan proses mingguan alih-alih harian

  • Gunakan satu saluran atau alur kerja sebelum memperluas ke lebih banyak lagi

  • Tingkatkan frekuensi setelah hasil dapat diandalkan

Gunakan pemicu sinyal tinggi agar agen Anda hanya berjalan saat diperlukan

  • Untuk Slack: Picu pada @sebutan atau reaksi emoji tertentu alih-alih semua pesan

  • Untuk Notion: Picu pada perubahan properti tertentu alih-alih setiap pembaruan database

  • Untuk Notion Mail: Picu pada rangkaian email yang difilter alih-alih setiap pesan

Harapkan beberapa proses dengan hasil “Tidak ada tindakan yang diperlukan”

  • Ini terjadi ketika agen menentukan bahwa tidak ada yang perlu dilakukan

  • Ini normal dan efisien—agen hanya memeriksa pemicu dan instruksi sebelum keluar

2. Tentukan dengan sengaja apa yang dirujuk oleh agen Anda

Semakin banyak konten yang dibaca agen, semakin banyak pekerjaan yang diperlukan setiap proses. Jaga cakupan tetap ketat.

  • Arahkan agen ke cakupan sekecil mungkin. Idealnya satu halaman atau beberapa halaman yang menautkan ke sub-halaman yang hanya dapat dimuat oleh agen jika diperlukan.

  • Hindari meminta agen untuk mencari secara luas jika Anda sudah mengetahui database atau halaman mana yang harus digunakannya sebagai sumber kebenaran.

3. Jaga jumlah langkah tetap sedikit

Setiap langkah tambahan dalam proses menambah beban kerja, terutama saat Agent Kustom menjalankan beberapa pencarian.

  • Jelaskan definisi selesai agar agen dapat menyelesaikan tugas dalam jumlah langkah yang lebih sedikit.

  • Lebih efisien jika agen memanggil beberapa alat secara bersamaan. Dorong penggunaan alat secara paralel dalam Instruksi Anda jika memungkinkan.

    • Dapat dijalankan secara bersamaan: "Baca database Projects, saluran Slack Engineering, dan halaman catatan sprint terbaru secara bersamaan." Ketiga sumber ini independen, sehingga agent membaca semuanya secara bersamaan alih-alih satu per satu.

    • Harus dijalankan secara berurutan: "Buat halaman ringkasan di database Reports, lalu posting tautannya ke #team-updates di Slack." Agen memerlukan URL halaman sebelum dapat memposting tautan, jadi langkah-langkah ini terjadi secara berurutan.

4. Waspadai perulangan dan percobaan ulang

Jika agen sering mengajukan beberapa pertanyaan tindak lanjut, mencoba ulang tindakan yang sama, memeriksa ulang halaman yang sama, atau mengalami error dengan cara yang dapat diprediksi, Instruksi atau pengaturannya perlu ditingkatkan.

  • Jika proses sering mengalami error karena alasan izin (tidak memiliki akses untuk merespons di Slack, atau URL yang tidak tepercaya), sesuaikan akses agen di bawah Tools and access atau beri tahu agen dalam Instruksi untuk menghindari tindakan tersebut.


Beri Umpan Balik

Apakah sumber daya ini membantu?


Powered by Fruition