Konektor kustom

Konektor kustom memungkinkan admin organisasi mendaftarkan API HTTPS atau, jika diaktifkan, server Streamable HTTP MCP 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 yang mengonfigurasi apa

• Admin organisasi membuat, mengedit, dan menghapus definisi konektor.
• Anggota menghubungkan rahasia mereka sendiri atau menyelesaikan alur OAuth konektor.
• Otorisasi agen mengontrol agen mana yang dapat menggunakan kredensial yang terhubung dan izin bernama apa yang mereka terima.

Definisi dibagikan di organisasi. Kredensial anggota tetap terbatas pada anggota dan organisasi tersebut.

Konektor API HTTP

1. Buka Konektor → Kustom dan pilih Konektor baru.
2. Pilih API HTTP dan masukkan nama tampilan.
3. Tambahkan satu atau lebih Prefiks HTTPS, satu per baris. Permintaan harus cocok dengan prefiks 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 redirect persis seperti yang ditampilkan di formulir dengan penyedia.
5. Buat konektor. Setiap anggota yang membutuhkan kemudian memilih Hubungkan dan memasukkan rahasia mereka atau menyelesaikan OAuth.
6. Otorisasi agen dan izin yang diperlukan.

Mengubah definisi OAuth yang ada atau kredensial kliennya akan memutus koneksi OAuth saat ini. Anggota harus menghubungkan ulang setelah perubahan.

Konektor MCP

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

Ajarkan prosedur API ke agen

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

Validasi konektor baru dengan permintaan terbatas, hanya-baca ke endpoint yang diketahui. Tidak ada permintaan Uji koneksi umum karena banyak API tidak menyediakan endpoint root yang bermakna.

Batas keamanan

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

Pemecahan masalah

Selanjutnya

• Lihat Alur Kerja untuk menangkap pekerjaan berulang dengan konektor kustom.
• Lihat Izin untuk cara penanganan kredensial konektor kustom.
• Lihat Katalog sebelum membuat kustom — layanan Anda mungkin sudah didukung.