Jalankan kode kustom dengan Workers (beta)

Notion Workers adalah bagian dari Platform Developer kami. Workers menjalankan kode kustom pada infrastruktur Notion untuk mendukung:

• Sinkronisasi database

• Alat untuk Agent Kustom

• Pemicu webhook

• Workers tersedia pada Paket Bisnis dan Paket Perusahaan.

• Secara default, Workers diaktifkan untuk ruang kerja (hanya pemilik).

• Pemilik ruang kerja dapat:

  • Batasi pembuatan Worker hanya untuk pemilik.

  • Izinkan anggota atau grup tertentu untuk membuat Workers.

  • Matikan Workers untuk ruang kerja.

• Jika Anda mencoba men-deploy atau mengelola Worker, Anda biasanya akan mengikuti dokumentasi pengembang kami dan menggunakan Notion CLI.

• Anda dapat mengaktifkan Mode Pengembang untuk melihat Workers di Notion, membaca log, serta mematikan atau menghapus Workers. Untuk men-deploy Worker atau mengubah kode atau pengaturannya, gunakan Notion CLI atau alat pengodean tim Anda. Pelajari lebih lanjut tentang mode pengembang →

Untuk mempelajari lebih lanjut tentang harga untuk Workers, lihat artikel ini.

Sinkronisasi database (didukung oleh Workers) membawa informasi dari alat luar ke dalam database Notion dan menjaganya agar tetap mutakhir secara otomatis. Setelah disiapkan, database yang disinkronkan akan tetap terkini dengan sendirinya, sehingga tim dan agen Anda selalu melihat data terbaru tanpa perlu menyalin atau menempel antar alat.

Beberapa contoh umum:

• Sinkronkan tiket dukungan Zendesk ke dalam database triase.

• Sinkronkan akun Salesforce ke dalam pelacak pipeline.

• Sinkronkan data dari alat atau database internal.

Setelah aktif, database yang disinkronkan berperilaku seperti database lainnya di Notion. Akses diatur oleh izin berbagi Notion standar Anda.

Alat untuk Agent Kustom (yang didukung oleh Workers) memperluas kemampuan Agent Kustom Anda di luar tindakan bawaan Notion dan MCP, dengan kapabilitas yang disesuaikan dengan cara kerja tim Anda.

Beberapa contoh umum:

• Membuat kueri pada gudang data.

• Menghasilkan aset dari dokumen Notion.

• Mengambil tindakan di aplikasi lain yang tidak didukung secara asli atau tidak tersedia melalui MCP.

Pemicu webhook (yang didukung oleh Workers) memungkinkan sebuah Acara di alat lain memulai alur kerja di Notion atau sistem lain yang terhubung.

Beberapa contoh umum:

• Menutup tugas saat pull request digabungkan.

• Memperbarui catatan CRM saat langganan berubah.

• Membuat dokumen orientasi saat penawaran ditandatangani.

Setelah disiapkan, alur kerja berjalan secara otomatis setiap kali Acara terjadi, sehingga tim Anda tidak perlu memindahkan informasi antar alat secara manual.

Dengan Developer Mode, Anda dapat membuka Workers dari bagian pengembang di bilah sisi Anda. Gunakan tampilan ini untuk pemeriksaan cepat dan tindakan dasar. Di Notion, Anda dapat:

• Lihat semua Workers dalam satu daftar.

• Buka Worker dan lihat Overview, log, variabel lingkungan, serta Pengaturan.

• Baca log Worker.

• Matikan atau Hapus Worker.

Untuk mendeploy Worker atau mengubah kode atau pengaturannya, gunakan Notion CLI atau alat pengodean tim Anda.

Secara default, hanya orang yang membuat Worker yang dapat memodifikasi dan menambahkannya sebagai koneksi baru. Bagikan Worker dengan rekan tim agar mereka dapat menghubungkannya ke Agent Kustom atau membantu mengelolanya.

Pelajari lebih lanjut tentang cara membagikan Worker →

Coba langkah-langkah ini secara berurutan:

1. Pastikan ruang kerja Anda memenuhi syarat, dan pemilik ruang kerja telah mengaktifkan Workers. Workers tersedia pada Paket Bisnis dan Paket Perusahaan, serta memerlukan pengaktifan dari admin ruang kerja.

2. Konfirmasikan bahwa Anda menggunakan jalur penyiapan yang dimaksudkan. Untuk sebagian besar penyiapan, Anda akan menggunakan Notion CLI ditambah dokumentasi pengembang.

3. Jika deploy Worker Anda gagal, periksa izin selanjutnya. Anda mungkin tidak memiliki akses untuk men-deploy ke ruang kerja tersebut, meskipun Anda dapat melihat halaman di dalamnya.

4. Jika Worker Anda berjalan tetapi tidak mengubah apa pun di Notion, uji tindakan tersebut secara manual terlebih dahulu. Jika Anda tidak dapat melakukan perubahan yang sama di Notion, biasanya itu adalah masalah izin atau pengaturan ruang kerja.

5. Jika biaya terlihat lebih tinggi dari yang diharapkan, turunkan frekuensi proses. Workers yang berproses lebih sering akan memakan biaya lebih banyak. Mulailah dengan Jadwal yang lebih lambat, lalu tingkatkan setelah Anda yakin itu berfungsi.

6. Masih bingung? Ikuti dokumentasi pengembang untuk pesan kesalahan yang spesifik. Mereka akan memiliki perbaikan yang paling akurat.