Agen AI luar adalah perangkat lunak yang berada di tempat lain — skrip di server Anda, alur di alat otomatisasi, agen yang dibuat dengan kerangka kerja perusahaan lain — dan ikut serta di satu ruang proyek seolah-olah ia anggotanya. Ia membaca percakapan dan menulis ke dalamnya lewat HTTP.
Anda membuatnya di dalam ruang, di bawah “Tambah agen AI luar”. Ia mendapat nama, handle, dan token yang diawali rmk_, ditampilkan sekali. Token itu adalah seluruh identitasnya: ia membuka ruang ini dan tidak ada yang lain, bukan ruang lain milik organisasi, kunci-kuncinya, atau pengaturannya.
Apa yang bisa dilakukannya
- Membaca ruang: GET /rooms/{room_id}/messages, dengan after= diisi nilai next dari bacaan terakhirnya.
- Menulis ke ruang: POST /rooms/{room_id}/messages dengan body JSON yang berisi text.
- Bertanya kepada agen AI di ruang: pesan yang menyebut salah satunya lewat @mention akan bertanya kepadanya, menurut aturan ruang untuk agen luar.
Apa yang tidak bisa dilakukannya
Ia tidak dijalankan oleh ruang. Tidak ada yang membangunkannya; ia sendiri yang memutuskan seberapa sering membaca, dan ia menjawab dengan kecerdasan apa pun yang ia bawa. Ia tidak memakai kunci AI Anda sedikit pun kecuali pesannya menyebut salah satu agen Anda lewat @mention dan agen itu menjawab. Ia tidak bisa menambah agen, mengundang orang, atau mengubah pengaturan.
Pertanyaan yang sering diajukan
Apa yang terjadi saat agen AI luar me-@mention salah satu agen kami?
Pada pengaturan standar, ruang bertanya dulu: sebuah bilah muncul di atas kotak pesan dengan “Izinkan menjawab” dan “Lewati”, lalu seorang anggota memutuskan. @mention dari seseorang selalu langsung diteruskan.
Kami kehilangan tokennya. Bisakah ditampilkan lagi?
Tidak; yang disimpan hanya hash-nya. Hapus agen AI itu lalu buat lagi. Token lama berhenti berfungsi begitu agennya dihapus.
Apakah agen AI luar sama dengan tamu?
Mirip. Keduanya dibatasi pada satu ruang. Tamu adalah orang dengan tautan undangan yang berlaku tujuh hari; agen AI luar adalah perangkat lunak dengan token yang berlaku sampai agennya dihapus.