Konektor kustom

Pengalaman mana yang Anda gunakan?

Dokumen ini mencakup kedua pengalaman. Jika Settings → Personal → My Okou tersedia, ikuti langkah My Okou. Jika Anda menggunakan halaman Agents dengan New agent, ikuti langkah Legacy Agents. Ketersediaan dapat berbeda antar anggota; dokumen ini tidak mengubah pengalaman Anda.

Dalam kedua pengalaman, Anda dapat menjalankan beberapa chat atau tugas sekaligus, menggunakan kembali alur kerja, dan membagikan hasil kerja yang telah ditinjau dengan tim Anda. Subagen runtime adalah alat eksekusi, bukan profil produk terpisah yang perlu Anda buat.

Perbedaan penyiapan: My Okou menggunakan instruksi pribadi (Instructions) di Settings → Personal → My Okou dan alur kerja ruang kerja. Langkah apa pun di bawah ini yang meminta Anda memilih, membuat, atau mengotorisasi Agent bernama hanya berlaku untuk Legacy Agents. Di My Okou, gunakan Chat Anda sendiri dan ikuti permintaan akun serta izin bernama yang ditampilkan. Alur kerja bersama tidak membagikan kredensial; Automations menggunakan konteks dan akses pemiliknya.

Konektor kustom memungkinkan admin organisasi mendaftarkan API HTTPS atau, jika diaktifkan, server MCP Streamable HTTP yang tidak ada di katalog bawaan. Konektor ini mendefinisikan batas jaringan dan metode autentikasi. Konektor ini tidak secara otomatis menghasilkan referensi API lengkap untuk agen.

Siapa mengonfigurasi apa

• Admin organisasi membuat, mengedit, dan menghapus definisi konektor.
• Anggota menghubungkan rahasia mereka sendiri atau menyelesaikan alur OAuth konektor.
• Otorisasi dan izin mengontrol tindakan bernama mana yang dapat diminta Okou melalui koneksi tersebut. Legacy Agents juga menggunakan otorisasi khusus Agent.

Definisi dibagikan di organisasi. Kredensial anggota tetap berada dalam cakupan anggota dan organisasi.

Konektor API HTTP

1. Buka Connectors → Custom dan pilih New connector.
2. Pilih HTTP API dan masukkan nama tampilan.
3. Tambahkan satu atau lebih Prefixes HTTPS, satu per baris. Permintaan harus cocok dengan prefix yang dikonfigurasi sebelum konektor dapat mengotorisasinya.
4. Tambahkan autentikasi jika API membutuhkannya:
   • Autentikasi API: masukkan nama header dan template header yang berisi {{secret}}, misalnya Authorization dan Bearer {{secret}}.
   • OAuth 2.0: masukkan URL otorisasi, URL token, client ID, client secret, scope, dan metode autentikasi endpoint token. Daftarkan URL pengalihan yang tepat seperti yang ditampilkan di formulir pada penyedia.
5. Buat konektornya. Setiap anggota yang membutuhkannya kemudian memilih Connect dan memberikan rahasia mereka atau menyelesaikan OAuth.
6. Tinjau dan otorisasi izin bernama yang diperlukan. Di Legacy Agents, pilih juga Agent yang dituju.

Mengubah definisi OAuth yang sudah ada atau kredensial kliennya akan memutus koneksi OAuth yang sedang aktif. Anggota harus menghubungkan lagi setelah perubahan.

Konektor MCP

Jika MCP muncul sebagai jenis konektor di ruang kerja Anda, masukkan endpoint MCP Streamable HTTP HTTPS dan konfigurasikan autentikasi API atau OAuth di formulir yang sama. Jika MCP tidak ditawarkan di pemilih, berarti fitur itu tidak diaktifkan untuk ruang kerja tersebut.

Ajarkan prosedur API kepada agen

Konektor kustom menyediakan akses jaringan yang aman dan penyisipan kredensial. Formulir pembuatan tidak mengunggah atau menemukan otomatis dokumen OpenAPI. Berikan endpoint, metode, parameter, dan respons yang diharapkan kepada agen dalam permintaan, atau simpan prosedur itu dalam workflow dengan referensi API yang dilampirkan sebagai file.

Validasikan konektor baru dengan permintaan yang sempit dan hanya baca ke endpoint yang diketahui. Tidak ada permintaan umum Test connection karena banyak API tidak mengekspos endpoint root yang bermakna.

Batasan keamanan

• Hanya prefix HTTPS dan endpoint MCP yang diterima.
• Firewall menyisipkan kredensial yang disimpan hanya ke dalam permintaan yang cocok.
• Rahasia yang disimpan dienkripsi saat disimpan dan tidak diekspos ke agen sebagai variabel lingkungan.
• Jangan memasukkan kunci, token, atau client secret ke dalam pesan chat, instruksi alur kerja, atau file terlampir.
• Gunakan kredensial layanan dengan scope upstream minimum yang dibutuhkan oleh alur kerja.

Pemecahan masalah

Langkah berikutnya

• Lihat Alur kerja untuk menangkap pekerjaan konektor kustom yang berulang.
• Lihat Izin untuk cara kredensial konektor kustom ditangani.
• Lihat Catalog sebelum membangun konektor kustom — layanan Anda mungkin sudah didukung.