Menyambungkan Kode Genie ke server MCP

Sambungkan Kode Genie ke alat eksternal dan sumber data melalui Protokol Konteks Model (MCP). Kode Genie dapat menggunakan server MCP apa pun yang telah ditambahkan ke ruang kerja Anda dan anda memiliki izin untuk menggunakannya.

Nota

Server MCP hanya didukung dalam mode Agen 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 vektor, 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 Genie Code ke Genie Space 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 Model Context Protocol (MCP) di Databricks.

Menyambungkan ke sumber data pihak ketiga

Penting

Fitur ini ada di Beta. Untuk menggunakan konektor sumber data pihak ketiga, admin ruang kerja harus mengaktifkan pratinjau Konektor Pihak Ketiga untuk Agen . Lihat Kelola pratinjau Azure Databricks.

Kode Genie menyediakan konektor bawaan untuk sumber data perusahaan umum, termasuk Google Drive dan SharePoint.

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 Genie Code di sudut kanan atas untuk membuka obrolan.
  2. Di bilah perintah, klik Ikon baru. 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 Berbagi koneksi server MCP.

Nota

Alat sumber data tidak selalu memicu secara otomatis. Jika penelusuran dokumen tidak dimulai, coba minta Genie Code secara eksplisit untuk menggunakan alat ini, misalnya "gunakan Google Docs" atau "gunakan SharePoint".

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.

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 ikon roda gigi. Pengaturan.
  2. Di bawah Server MCP, klik Ikon baru. 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.
    • Pencarian vektor: Pilih skema untuk indeks. Ini memungkinkan Genie Code untuk mengkueri indeks pencarian vektor untuk menemukan dokumen yang relevan.
    • Genie Space: Pilih Genie Space. Genie MCP memanggil Genie sebagai alat, memungkinkan Anda untuk mengkueri Genie Space 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 dalam mode Agen tanpa mengubah perintah atau instruksi Anda. Kode Genie akan secara otomatis menggunakan server ini jika relevan.

Saat ini, akses MCP dibatasi hingga 20 alat di semua server. Anda dapat memilih alat dan server mana yang akan diaktifkan atau dinonaktifkan di pengaturan Kode Genie Anda.

  • Last updated on