Genie Code'u MCP sunucularına bağlama

Model Bağlam Protokolü (MCP) aracılığıyla Genie Code'u dış araçlara ve veri kaynaklarına bağlayın. Genie Code, çalışma alanınıza eklenmiş olan ve kullanma izniniz olan tüm MCP sunucularını kullanabilir.

Uyarı

MCP sunucuları yalnızca Genie Code Agent modunda desteklenir.

MCP nedir?

MCP yapay zeka aracılarını araçlara, kaynaklara, istemlere ve diğer bağlamsal bilgilere bağlayan açık kaynak bir standarttır. MCP, bu bağlamı doğrudan istemlere veya yönergelere eklemeden araçları, verileri ve iş akışlarını Genie Code'da kullanıma sunmak için standartlaştırılmış bir yol sağlar.

MCP, önemli bağlamın zaten mevcut olduğu ancak Genie Code gibi bir yapay zeka aracısından erişmenin zor olduğu durumlar için tasarlanmıştır. MCP, Genie Code'a aşağıdaki gibi bağlama erişim vermek için güvenli bir yol sunar:

• Belge sistemleri: Teams genellikle Runbook'ları veya operasyonel belgeleri Confluence gibi araçlarda tutar. Bölümleri istemlere kopyalamak yerine, bu içerik bir dış MCP sunucusu aracılığıyla bir kez sunulabilir ve gerekli olduğunda başvurulabilir. Belgeleriniz, Genie Code'un ilgili belgeleri sorgulamak için kullanabileceği vektör arama dizini olarak Databricks'te de olabilir.
• Araçlar ve hizmetler: Platform ekipleri kurulum, doğrulama veya dağıtım için API'leri veya betikleri koruyabilir. MCP, bu özellikleri genie Code'un kullanımına sunar.
• Veri kaynakları: Databricks'te zaten verileriniz varsa, verileri doğal dil kullanarak analiz etmeye yardımcı olması için Genie Code'u Genie Space'e bağlayabilirsiniz. Databricks dışında depolanan veriler için Genie Code'a dış MCP sunucuları üzerinden güvenli erişim verebilirsiniz.
• Özel uygulamalar: Databricks Uygulamaları aracılığıyla barındırılan özel işlevler de ekleyebilirsiniz. Bu, Genie Code'u sizin veya kuruluşunuz için özel olarak oluşturulan özel araçlara, iş akışlarına veya tümleştirmelere bağlamanıza olanak tanır ve bunların tümü Databricks çalışma alanınızda güvenli bir şekilde yönetilir.

Bu gibi durumlarda, MCP el ile kopyalamayı yapılandırılmış, yeniden kullanılabilir bir yaklaşımla değiştirir ve doğru bağlamı yalnızca gerektiğinde kullanılabilir hale getirir.

Genie Code'u çalışma alanınızdaki kullanma izniniz olan tüm MCP sunucularına bağlayabilirsiniz. Çalışma alanı yöneticileri hangi sunucuların kullanılabilir olduğunu denetlerken, kullanıcılar gerektiğinde bu onaylanan kaynaklardan seçim yapabilir.

Databricks'teki MCP sunucuları ve kendi sunucularınızı oluşturma hakkında daha fazla bilgi edinmek için bkz. Databricks'te Model Bağlam Protokolü (MCP).

Üçüncü taraf veri kaynaklarına bağlanma

Önemli

Bu özellik Beta sürümündedir. Üçüncü taraf veri kaynağı bağlayıcılarını kullanmak için çalışma alanı yöneticisinin Aracılar için Üçüncü Taraf Bağlayıcıları önizlemesini etkinleştirmesi gerekir. Bkz. Azure Databricks önizlemelerini yönetme.

Genie Code, Google Drive ve SharePoint gibi yaygın kurumsal veri kaynakları için yerleşik bağlayıcılar sağlar.

Bu veri kaynaklarına bağlanmak Genie Code'un soruları yanıtlarken belgelerinizde arama yapmasına olanak tanır. Her kullanıcı tek tek kimlik doğrulaması yapar ve OAuth belirteçleri kullanıcılar arasında paylaşılmaz.

Üçüncü taraf veri kaynağına bağlanmak için:

1. Çalışma alanınızda Sohbeti açmak için sağ üst köşedeki Genie Code.
2. İstem çubuğunda Artı simgesi.
3. Bağlanmak istediğiniz veri kaynağının yanındaki Bağlan'a tıklayın.
4. Oturum açma adımlarını tamamlayın.

Kimlik doğrulaması yaptıktan sonra Genie Code, soruları yanıtlarken belgelerinizde arama yapabilir. Meta veri deposu yöneticileri ve bağlantı sahipleri, bağlantı üzerindeki kullanıcı izinlerini yönetebilir veya iptal edebilir. Bkz. MCP sunucu bağlantısını paylaşma.

Uyarı

Veri kaynağı araçları her zaman otomatik olarak tetiklemez. Belge araması başlatılmazsa, Genie Code'dan aracı kullanmasını açıkça istemeyi deneyin; örneğin, "Google Docs'u kullan" veya "SharePoint kullan."

Diğer veri kaynaklarını bağlamak için bunları Genie Code'a el ile ekleyin. Bkz. Genie Code'a EL ile MCP sunucuları ekleme.

Google Drive sınırlamaları

• Google Drive'ı yetkilendirilirken bir "doğrulanmamış uygulama" ekranı görebilirsiniz. Gelişmiş'e tıklayın ve yetkilendirme işlemine devam edin.
• Dosya boyutu üst sınırı 10 MB'tır.
• Yalnızca yerel Google Workspace dosyaları (Belgeler, Sayfalar, Slaytlar) desteklenir. PDF'ler, görüntüler ve diğer ikili biçimler desteklenmez.
• Bağlantı veya belirteç zaman aşımı hataları ajan çıkışında görünebilir. Sorunu çözmek için yeniden kimlik doğrulaması yapın.

SharePoint sınırlamaları

• Dosya boyutu üst sınırı 10 MB'tır.
• Desteklenen dosya türleri, Office belgelerinin (.docx, .xlsx, .pptx) yanı sıra , .txt, , .csv, .jsonve diğerleri gibi .mdyaygın metin tabanlı biçimleri içerir. PDF'ler, görüntüler ve diğer ikili biçimler desteklenmez.

Genie Code'a MCP sunucularını manuel olarak ekleme

Genie Code'u bir MCP sunucusuna bağlamak için Genie Code ayarlarınıza ekleyin:

1. Genie Code ayarlarını açın. Genie Code panelinde Ayarlar'ı seçin.
2. MCP Sunucuları'nın altında Sunucu Ekle'yi seçin.
3. Eklemek istediğiniz MCP sunucularını seçin. Databricks tarafından yönetilen MCP sunucularını veya dış MCP sunucularını seçebilirsiniz:
   • Unity Catalog işlevi: İşlevin şemasını seçin. Bu, Genie Code'un önceden tanımlanmış SQL sorguları çalıştırmak için işlevleri kullanmasına olanak tanır.
     • GitHub MCP sunucusu eklemeyle ilgili yardım için bkz. GitHub MCP sunucusu oluşturma.
   • Vektör araması: Dizin için şemayı seçin. Bu, Genie Code'un ilgili belgeleri bulmak için vektör arama dizinini sorgulamasına olanak tanır.
   • Genie Space: Genie Space'i seçin. Genie MCP, genie'yi bir araç olarak çağırarak Genie Space'i doğal dil kullanarak verileri analiz etmek üzere sorgulamanıza olanak sağlar.
   • Dış MCP sunucusu: Dış MCP sunucusu olarak kullanılacak Unity Kataloğu bağlantısını seçin. Kullanılabilmesi için önce bağlantıda oturum açmanız gerekir.
   • Özel MCP sunucusu: Özel MCP sunucusu olarak kullanılacak Databricks Uygulamasını seçin. Bu, özel tanımlı araçları kullanmanıza olanak tanır. Aşağıdaki gereksinimler geçerlidir:
     • Uygulamanızın bağlanmaya çalıştığınız çalışma alanına dağıtılması gerekir.
     • MCP sunucusuna adresinden https://<server-url>/mcperişilmelidir.
     • Uygulamanız durumsuz olmalıdır. Örneğin, mcp_app = mcp_server.http_app(stateless_http=True) ayarlayın.
     • CORS hatalarıyla karşılaşırsanız çalışma alanı URL'nizi uygulamanızın izin verilen kaynaklar listesine eklemeniz gerekebilir. Örneğin, app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]) ayarlayın.
4. Kaydet'e tıklayın.

Eklendikten sonra, MCP sunucuları Genie Code tarafından hemen kullanılabilir. Bunları, istemlerinizi veya yönergelerinizi değiştirmeden Aracı modunda kullanmaya başlayabilirsiniz. İlgili olduğunda, Genie Code bu sunuculardan otomatik olarak yararlanacaktır.

Şu anda MCP erişimi tüm sunucularda 20 araçla sınırlıdır. Genie Code ayarlarınızda hangi araçları ve sunucuları etkinleştirebileceğinizi veya devre dışı bırakabileceğinizi seçebilirsiniz.