Integrasi menghubungkan Atoms ke alat dan layanan yang sudah Anda gunakan. Bergantung pada konektornya, Atoms dapat menggunakan informasi eksternal sambil membantu Anda membangun, menambahkan kapabilitas ke app yang Anda publikasikan, atau mendukung kedua alur kerja tersebut.

Setiap konektor mendukung tindakan dan izin masing-masing. Tinjau kapabilitas dan cakupan izin yang ditampilkan untuk konektor yang terhubung; panel detail yang tidak terhubung mungkin hanya menampilkan deskripsi dan kontrol koneksinya.

Gunakan akun dan cakupan izin dengan hak akses paling minimal yang tetap dapat menyelesaikan tugas. Jangan tempelkan kata sandi, token akses, kunci privat, atau data sensitif lain yang tidak terkait ke dalam prompt. Saat suatu layanan berisi data produksi atau data pelanggan, uji dengan sampel yang tidak sensitif dan verifikasi target yang tepat sebelum mengizinkan penulisan.

Konektor dan tindakan yang Anda lihat dapat berbeda menurut akun dan rilis. Buka katalog Connector di Atoms untuk melihat apa yang saat ini tersedia bagi Anda.

Tentukan apa yang harus dilakukan koneksi

Sebelum menghubungkan layanan, tentukan di mana Anda membutuhkannya.

Tujuan	Contoh
Berikan konteks kepada Agen saat Anda membangun	Temukan file, rangkum tugas, tinjau issue, atau gunakan data proyek dalam prompt
Biarkan Agen mengambil tindakan di layanan lain	Buat tugas, perbarui catatan, tambahkan data spreadsheet, atau buat acara kalender
Tambahkan layanan ke app yang dipublikasikan	Simpan data aplikasi, tangani autentikasi, proses pembayaran, atau jalankan alur kerja app

Beberapa konektor mendukung lebih dari satu tujuan. Tinjau deskripsi konektor dan izin yang diminta sebelum Anda menghubungkannya.

Hubungkan integrasi

Buka Settings → Connectors untuk menggunakan titik masuk utama. Anda juga dapat memilih Connect your tools to Atoms dari dasbor.

Menghubungkan atau memutuskan integrasi mungkin memerlukan akses pemilik Ruang Kerja atau admin yang berwenang. Jika Anda bukan pemilik atau admin dan suatu kontrol tidak tersedia, mintalah bantuan pemilik Ruang Kerja atau admin yang berwenang.

Dari dasbor

1. Buka dasbor Atoms.
2. Pilih Connect your tools to Atoms.
3. Pilih konektor yang ingin Anda gunakan. Ikuti kontrol koneksi yang ditampilkan pada kartu konektor tersebut.
4. Gunakan kontrol yang ditampilkan untuk konektor tersebut. Jika itu membuka panel detail umum, pilih Connect; integrasi khusus penyedia mungkin membuka alur penyiapan atau otorisasi mereka sendiri.
5. Masuk ke layanan eksternal jika diminta.
6. Tinjau akun dan izin, lalu setujui koneksi.
7. Kembali ke Atoms dan konfirmasikan bahwa konektor ditampilkan sebagai terhubung. Di Chat tempat Anda ingin menggunakannya, buka pemilih konektor dan aktifkan konektor untuk Chat tersebut.

Gunakan integrasi yang terhubung

Beri tahu Agen layanan mana yang harus digunakan dan sertakan detail yang cukup untuk mengidentifikasi item yang benar. Detail yang berguna meliputi:

• Nama proyek, ruang kerja, repositori, folder, kalender, atau spreadsheet
• Nama tugas, ID issue, nama file, atau pengenal catatan
• Rentang tanggal, tanggal jatuh tempo, pemilik, status, atau prioritas
• Apa yang Anda ingin Atoms baca, rangkum, buat, atau perbarui

Contohnya:

• “Rangkum issue Linear berprioritas tinggi yang ditugaskan kepada saya.”
• “Temukan ringkasan peluncuran di Drive dan daftarkan keputusan yang masih terbuka.”
• “Tambahkan prospek yang telah disetujui ini ke spreadsheet kampanye.”
• “Buat acara kalender untuk tinjauan desain Selasa depan pukul 3 sore.”

Atoms hanya dapat menggunakan tindakan yang didukung oleh konektor dan data yang tersedia untuk akun yang terhubung. Jika kapabilitas atau tindakan yang Anda perlukan tidak ditampilkan untuk konektor tersebut, berhentilah dan jangan berasumsi bahwa itu didukung.

Tinjau perubahan eksternal sebelum dijalankan

Saat konektor dan tindakan mendukung pembuatan atau pembaruan data eksternal, Atoms mungkin menampilkan konfirmasi sebelum menjalankannya.

Tinjau:

• Layanan dan akun yang terhubung
• File, spreadsheet, kalender, proyek, atau catatan target
• Informasi yang akan dibuat atau diubah
• Tanggal, waktu, penerima, atau nilai penting lainnya

Jika Atoms menampilkan konfirmasi, tinjau lalu pilih Confirm untuk melanjutkan atau batalkan agar layanan eksternal tetap tidak berubah. Ketersediaan penulisan bergantung pada konektor dan tindakan; konektor hanya-baca tidak menawarkan tindakan tulis.

Setelah penulisan, verifikasi hasilnya di layanan eksternal sebelum mencoba lagi. Jika target atau nilainya salah, hentikan alur kerja dan gunakan riwayat, pembatalan, atau alat pemulihan milik penyedia jika tersedia. Memutuskan konektor menghentikan penggunaan di masa mendatang; itu tidak membatalkan perubahan yang sudah dibuat.

Kelola koneksi

Buka katalog Connector dan pilih layanan yang terhubung untuk meninjau statusnya saat ini.

Dari panel detail konektor, Anda mungkin dapat:

• Memeriksa akun mana yang terhubung
• Meninjau tindakan yang didukung konektor dan cakupan izinnya
• Menghubungkan kembali saat otorisasi telah kedaluwarsa
• Menyegarkan atau mengubah akses saat layanan mendukungnya
• Memutuskan akun dari Atoms

Memutuskan di Atoms menghentikan penggunaan koneksi di masa mendatang. Beberapa layanan mungkin juga mengharuskan Anda mencabut akses Atoms dari pengaturan akun atau keamanan milik layanan tersebut.

Contoh berdasarkan kasus penggunaan

Tabel di bawah ini adalah pengelompokan editorial berdasarkan kasus penggunaan, bukan sekumpulan kategori katalog. Gunakan katalog yang dapat dicari untuk daftar konektor yang tersedia saat ini.

Kategori	Penggunaan umum	Contoh
Pengembangan	Kontrol sumber, repositori, issue, dan alur kerja pengiriman	GitHub, Linear
Backend dan data	Basis data, autentikasi, penyimpanan, dan data terstruktur	Supabase
Pembayaran	Checkout, penagihan, dan alur kerja pembayaran	Stripe
Manajemen pekerjaan	Tugas, proyek, pemilik, dan tanggal jatuh tempo	Asana, Todoist
File dan konten	Cari, baca, dan atur file eksternal	Box, Dropbox
Analitik dan pemasaran	Traffic, performa penelusuran, kampanye, dan pelaporan	Google Analytics 4, Google Search Console, Google Ads

Ketersediaan konektor berubah seiring waktu. Gunakan katalog di Atoms untuk daftar terkini dan buka konektor untuk meninjau kapabilitas persisnya.

Panduan penyiapan

Pilih panduan untuk layanan Anda:

• Connect GitHub
• Connect Supabase
• Connect GA4
• Connect Google Search Console
• Connect Google Ads

Untuk masalah koneksi, lihat pemecahan masalah Integrasi.