Genie Code'u MCP sunucularına bağlama

Genie Code, Model Context Protocol (MCP) sunucuları ve Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack ve GitHub için yerel bağlayıcılar aracılığıyla harici araçlara, belgelere ve verilere bağlanır. Yaygın SaaS kaynakları için yerel bağlayıcıları kullanın veya çalışma alanından kendi dış veya özel MCP sunucularınızı ekleyin. Genie Code ayarlarında hangi araçların etkinleştirileceğini siz seçersiniz.

MCP nedir?

MCP aracıları 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 aracıdan 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 ayrıca, Genie Code'un ilgili belgeleri sorgulamak için kullanabileceği bir Yapay Zeka 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 çözümlemenize yardımcı olması için Genie Code'u bir Genie Aracısı'na 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ı nasıl oluşturacağınız hakkında daha fazla bilgi edinmek için MCP'ler ve ajan araçlarına bakınız.

Üçüncü taraf veri kaynakları için yerel bağlayıcıları kullanma

Genie Code, yaygın kurumsal veri kaynakları için yerleşik bağlayıcılar sağlar:

• Google Drive: Google Dokümanlar, E-Tablolar ve Slaytlar'da arama yapın ve oluşturun; oluşturduğu Dokümanları düzenleyin.
• Gmail: E-postaları arayın, okuyun ve taslak hazırlayın.
• Google Takvimi: Takvim etkinliklerini arayın ve oluşturun.
• Microsoft 365: SharePoint, Teams, Outlook ve Calendar araması; Outlook e-postasının taslağı.
• Atlassian: Jira ve Confluence'ı arayın ve güncelleyin.
• Glean (Beta): Glean kullanarak kuruluşunuzun bağlı uygulamalarında arama yapın.
• Slack: Slack mesajlarını ve kanallarını arayın ve mesaj gönderin.
• GitHub: Depoları, sorunları ve pull requestleri arayın ve güncelleyin.

Bu veri kaynaklarına bağlanmak, Genie Code'un belgelerinizi aramasına ve soruları yanıtlarken bağlantılı araçlarda işlem 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.

Bu bağlantılar Databricks tarafından sağlanan MCP konnektörleri kullanıyor, yani barındıracak sunucu yok ve kayıt için OAuth uygulaması yok. Azure Databricks, Unity Catalog ve Unity Gateway üzerinden her bağlantıyı yönetir. Gateway, her araç çağrısını Unity Catalog izinlerinize göre yetkilendirir, yerleşik politikaları ve onay gereksinimlerini uygular ve kullanım ile denetim günlüklerini sistem tablolarına kaydeder. Bkz. Harici MCP sunucusunu kaydet.

Üçü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. Adım 4'e bakınız. MCP Hizmetine erişim izni verin.

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.

Zamanlanmış görevler ve kimlik doğrulama

• Genie Code, bir bağlantının kimlik doğrulamasının süresi dolduğunda sizi uyarmaz. Sadece bir araç çağrısı başarısız olduğunda veya bağlantı listesini açtığınızda öğrenebilirsiniz. Sorunu çözmek için yeniden kimlik doğrulaması yapın.
• Bir bağlantının izinlerini değiştirmek, her kullanıcının yeniden kimlik doğrulamasını gerektirir. Bağlantıyı kullanan zamanlanmış görevler, kullanıcı yeniden kimlik doğrulamasını yapana kadar başarısız olur.

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ı 25 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.
• Genie Code, Google Dokümanlar, E-Tablolar ve Slaytlar oluşturabilir ve bağlayıcı aracılığıyla oluşturduğu Google Dokümanlar'ı düzenleyebilir. Bağlantı dışında oluşturulan Dokümanları düzenleyemiyor ya da mevcut Sheets veya Slide'ları düzenleyemiyor.
• Çok büyük bir belgeyi okumak yavaş olabilir.

Uyarı

Google Çalışma Alanı API'lerinden alınan ham veya türetilmiş kullanıcı verilerinin kullanımı ve aktarımı, Sınırlı Kullanım gereksinimleri de dahil olmak üzere Google API hizmetleri Kullanıcı Veri İlkesi'ne uyar.

Gmail sınırlamaları

• Genie Code e-posta arayabilir, okuyabilir ve taslak hazırlayabiliyor, ancak e-posta gönderemiyor veya mevcut mesajları düzenleyemiyor.
• Genie Code, Drive dosyalarını yerel Gmail ekleri olarak ekleyemiyor. Bir çözüm olarak, e-posta gövdesine dosyalara bağlantılar ekleyin.

Microsoft 365 sınırlamaları

• SharePoint, Teams, Outlook ve Takvim'i içerir.
• Genie Code Outlook e-postasını taslak edebiliyor ama gönderemiyor.
• SharePoint dosyaları için maksimum dosya boyutu 25 MB'dir.
• Desteklenen SharePoint dosya türleri arasında Office belgeleri (.docx, .xlsx, .pptx) ile , , .json, .md, ve diğerleri gibi yaygın metin tabanlı formatlar .txt.csvbulunur. PDF'ler, görüntüler ve diğer ikili biçimler desteklenmez.

Glean (Beta) sınırlamaları

• Glean sadece arama için uygundur. Doğrudan bir bağlantıdan bir belgeyi okuyamaz.
• Metastore yöneticisi, yönetici olmayan kullanıcıların bağlantıyı kullanabilmesinden önce önce Glean kiracı kimliğini yapılandırmalıdır. Yönetici, Glean'a ilk kez bağlanırken kiracı kimliğini girebilir.
• Belirli bir Glean MCP sunucusuna bağlanmak için, bir metastore yöneticisi bağlantı kurarken MCP sunucu yolunu (örneğin, /mcp/eng) isteğe bağlı olarak ayarlayabilir. Varsayılan yolu (/mcp/default). kullanmak için bu alanı boş bırakın. Yönetici olmayan kullanıcılar Glean MCP sunucu yolunu belirleyemez veya değiştiremez.

Slack sınırlamaları

• Genie Code, bir mesajı gönderdikten sonra düzenleyemiyor veya silemiyor.

GitHub sınırlamaları

• Yazmalar, dosya içeriği, sorunlar ve pull istekleriyle sınırlıdır.
• Varsayılan olarak, Databricks GitHub MCP bağlayıcısı yalnızca genel depolara erişebilir. Bağlayıcıya özel kurumsal depolarınıza okuma erişimi vermek için, GitHub kuruluş yöneticisinin ek kurulumu tamamlaması gerekir. Bkz . Özel depo erişimini etkinleştirme.
• GitHub Enterprise Server (GitHub şirket içinde barındırılan sürümü) 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 bölmesinde 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.
     • Özel GitHub MCP sunucusu oluşturma konusunda yardım için bkz. Genie Code ile GitHub kodu arama.
   • Yapay Zeka Araması: Dizin için şemayı seçin. Bu, Genie Code'un ilgili belgeleri bulmak için Yapay Zeka Arama dizinini sorgulamasına olanak tanır.
   • Genie Aracısı: Genie Aracısını seçin. Genie MCP genie'yi bir araç olarak çağırarak Genie Aracısını 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. İstemlerinizi veya yönergelerinizi değiştirmeden bunları kullanmaya başlayabilirsiniz. Genie Code, gerektiğinde bu sunuculardan otomatik olarak yararlanır.

Genie Code ayarlarınızda hangi araçları ve sunucuları etkinleştirebileceğinizi veya devre dışı bırakabileceğinizi seçebilirsiniz.

Sınırlamalar

Bağlı uygulamalar için uyumluluk rehberi için Databricks tarafından sağlanan MCP Hizmeti sınırlamalarına bakınız.

• Dış MCP sunucuları yalnızca Model Sunma'nın desteklendiği bölgelerde kullanılabilir. Bkz. Model dağıtım özellikleri kullanılabilirliği.