Menyambungkan Kode Genie ke server MCP

Genie Code terhubung ke alat, dokumen, dan data eksternal melalui server Model Context Protocol (MCP) dan konektor asli untuk Google Drive, SharePoint, GitHub, Glean, Atlassian, dan Slack. Gunakan konektor asli untuk sumber SaaS umum, atau tambahkan server MCP eksternal atau kustom Anda sendiri dari ruang kerja. Anda memilih alat mana yang akan diaktifkan di pengaturan Kode Genie.

Apa itu MCP?

MCP adalah standar sumber terbuka yang menghubungkan agen AI ke alat, sumber daya, perintah, dan informasi kontekstual lainnya. MCP menyediakan cara standar untuk mengekspos alat, data, dan alur kerja ke Kode Genie tanpa menyematkan konteks tersebut langsung ke dalam perintah atau instruksi.

MCP dirancang untuk kasus di mana konteks penting sudah ada tetapi sulit diakses dari agen AI, seperti Genie Code. MCP menawarkan cara yang aman untuk memberikan akses Kode Genie ke konteks seperti berikut:

• Sistem dokumentasi: Teams sering menyimpan runbook atau dokumen operasional dalam alat seperti Confluence. Alih-alih menyalin bagian ke dalam perintah, konten tersebut dapat diekspos sekali melalui server MCP eksternal dan direferensikan jika relevan. Dokumen Anda mungkin juga sudah berada di Databricks sebagai indeks Pencarian AI, yang dapat digunakan Kode Genie untuk mengkueri dokumen yang relevan.
• Alat dan layanan: Tim platform dapat mempertahankan API atau skrip untuk penyiapan, validasi, atau penyebaran. MCP membuat kemampuan tersebut tersedia langsung untuk Genie Code.
• Sumber data: Jika Anda sudah memiliki data di Databricks, Anda dapat menyambungkan Kode Genie ke Agen Genie untuk membantu Anda menganalisis data menggunakan bahasa alami. Untuk data yang disimpan di luar Databricks, Anda dapat memberikan akses aman Genie Code melalui server MCP eksternal.
• Aplikasi kustom: Anda juga dapat menambahkan fungsionalitas kustom yang dihosting melalui Aplikasi Databricks. Ini memungkinkan Anda untuk menghubungkan Kode Genie ke alat kepemilikan, alur kerja, atau integrasi yang dibangun khusus untuk Anda atau organisasi Anda, semuanya dikelola dengan aman dalam ruang kerja Databricks Anda.

Dalam kasus ini, MCP mengganti copy-pasting manual dengan pendekatan terstruktur dan dapat digunakan kembali, membuat konteks yang tepat hanya tersedia ketika diperlukan.

Anda dapat menyambungkan Kode Genie ke server MCP apa pun di ruang kerja yang memiliki izin untuk digunakan. Admin ruang kerja mengontrol server mana yang tersedia, sementara pengguna dapat memilih dari sumber yang disetujui sesuai kebutuhan.

Untuk mempelajari selengkapnya tentang server MCP di Databricks dan cara membuat server Anda sendiri, lihat Protokol Konteks Model (MCP) di Azure Databricks.

Menggunakan konektor asli untuk sumber data pihak ketiga

Genie Code menyediakan konektor bawaan untuk sumber data perusahaan umum, termasuk Google Drive, SharePoint, GitHub, Glean, Atlassian, dan Slack.

Menyambungkan ke sumber data ini memungkinkan Genie Code mencari dokumen Anda saat menjawab pertanyaan. Setiap pengguna mengautentikasi satu per satu, dan token OAuth tidak dibagikan antar pengguna.

Untuk menyambungkan sumber data pihak ketiga:

1. Di ruang kerja Anda, klik ikon kode Sparkle Genie di sudut kanan atas untuk membuka obrolan.
2. Di bilah perintah, klik ikon plus.
3. Di samping sumber data yang ingin Anda sambungkan, klik Sambungkan.
4. Selesaikan langkah-langkah untuk masuk.

Setelah Anda mengautentikasi, Genie Code dapat mencari dokumen Anda saat menjawab pertanyaan. Admin metastore dan pemilik koneksi dapat mengelola atau mencabut izin pengguna pada koneksi. Lihat Langkah 4. Memberikan akses ke rekan satu tim.

Untuk menyambungkan sumber data lain, tambahkan secara manual ke Kode Genie. Lihat Menambahkan server MCP ke Kode Genie secara manual.

Batasan Google Drive

• Saat mengotorisasi Google Drive, Anda mungkin melihat layar "aplikasi yang belum diverifikasi". Klik Tingkat Lanjut dan lanjutkan proses otorisasi.
• Ukuran file maksimum adalah 10 MB.
• Hanya file Google Workspace asli (Dokumen, Spreadsheet, Slide) yang didukung. PDF, gambar, dan format biner lainnya tidak didukung.
• Kesalahan habis masa berlaku koneksi atau token mungkin muncul di output agen. Autentikasi ulang untuk mengatasinya.

batasan SharePoint

• Ukuran file maksimum adalah 10 MB.
• Jenis file yang didukung termasuk dokumen Office (.docx, .xlsx, .pptx), serta format berbasis teks umum seperti .txt, , .csv.json, .md, dan lainnya. PDF, gambar, dan format biner lainnya tidak didukung.

batasan GitHub

• Secara default, konektor Databricks GitHub MCP hanya dapat mengakses repositori publik. Untuk memberi konektor akses baca ke repositori privat perusahaan Anda, admin organisasi di GitHub harus melakukan pengaturan tambahan. Lihat Mengaktifkan akses repositori privat.
• GitHub Enterprise Server (versi GitHub yang dihost sendiri) tidak didukung.

Batasan Glean

• Admin ruang kerja harus terlebih dahulu mengonfigurasi ID penyewa Glean sebelum pengguna non-admin dapat menggunakan koneksi. Admin dapat memasukkan ID penyewa saat pertama kali menyambungkan ke Glean.

Menambahkan server MCP ke Kode Genie secara manual

Untuk menyambungkan Kode Genie ke server MCP, tambahkan di pengaturan Kode Genie Anda:

1. Buka pengaturan Kode Genie. Di panel Kode Genie, klik Pengaturan.
2. Di bawah Server MCP, klik Tambahkan Server.
3. Pilih server MCP yang ingin Anda tambahkan. Anda dapat memilih server MCP terkelola Databricks atau server MCP eksternal:
   • Fungsi Katalog Unity: Pilih skema untuk fungsi tersebut. Ini memungkinkan Genie Code menggunakan fungsi untuk menjalankan kueri SQL yang telah ditentukan sebelumnya.
     • Untuk bantuan dalam membuat server MCP GitHub kustom, lihat Mencari kode GitHub dengan Genie Code.
   • Pencarian AI: Pilih skema untuk indeks. Ini memungkinkan Genie Code untuk mengkueri indeks Pencarian AI untuk menemukan dokumen yang relevan.
   • Agen Genie: Pilih Agen Genie. Genie MCP memanggil Genie sebagai alat, memungkinkan Anda mengkueri Agen Genie untuk menganalisis data menggunakan bahasa alami.
   • Server MCP eksternal: Pilih koneksi Katalog Unity untuk digunakan sebagai server MCP eksternal. Anda harus masuk ke koneksi terlebih dahulu sebelum dapat digunakan.
   • Server MCP kustom: Pilih Aplikasi Databricks untuk digunakan sebagai server MCP kustom. Ini memungkinkan Anda menggunakan alat yang telah ditentukan sendiri. Persyaratan berikut berlaku:
     • Aplikasi Anda harus disebarkan di ruang kerja yang sama dengan tempat Anda mencoba menyambungkannya.
     • Server MCP harus diakses di https://<server-url>/mcp.
     • Aplikasi Anda harus stateless. Misalnya, atur mcp_app = mcp_server.http_app(stateless_http=True).
     • Jika mengalami kesalahan CORS, Anda mungkin perlu menambahkan URL ruang kerja ke daftar asal yang diizinkan aplikasi Anda. Misalnya, atur app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Kliklah Simpan.

Setelah ditambahkan, server MCP segera tersedia untuk Genie Code. Anda dapat mulai menggunakannya tanpa mengubah perintah atau instruksi Anda. Kode Genie akan secara otomatis menggunakan server ini jika relevan.

Anda dapat memilih alat dan server mana yang akan diaktifkan atau dinonaktifkan di pengaturan Kode Genie Anda.

Keterbatasan

• Server MCP eksternal hanya tersedia di wilayah di mana Model Serving didukung. Lihat Ketersediaan fitur layanan model.