Łączenie kodu Genie z serwerami MCP

Genie Code łączy się z zewnętrznymi narzędziami, dokumentami i danymi za pośrednictwem serwerów Model Context Protocol (MCP) oraz natywnych łączników dla Google Drive, Gmail, Google Calendar, Microsoft 365, Atlassian, Glean, Slack i GitHub. Użyj łączników natywnych dla typowych źródeł SaaS lub dodaj własne zewnętrzne lub niestandardowe serwery MCP z obszaru roboczego. Należy wybrać narzędzia do włączenia w ustawieniach kodu Genie.

Co to jest MCP?

MCP to standard open source, który łączy agentów z narzędziami, zasobami, monitami i innymi informacjami kontekstowymi. McP zapewnia ustandaryzowany sposób uwidaczniania narzędzi, danych i przepływów pracy w kodzie Genie bez osadzania tego kontekstu bezpośrednio w monitach lub instrukcjach.

McP jest przeznaczony dla przypadków, w których istnieje już ważny kontekst, ale jest trudny do uzyskania dostępu z agenta, takiego jak Genie Code. MCP oferuje bezpieczny sposób, aby zapewnić kodowi Genie dostęp do kontekstu, takiego jak poniższe:

• Systemy dokumentacji: Zespoły często przechowują runbooki lub dokumentację operacyjną w narzędziach takich jak Confluence. Zamiast kopiować sekcje do monitów, zawartość ta może być udostępniona jednorazowo za pośrednictwem zewnętrznego serwera MCP i przywołana w razie potrzeby. Twoje dokumenty mogą już znajdować się w Databricks jako indeks AI Search, z którego Genie Code może korzystać do wyszukiwania odpowiednich dokumentów.
• Narzędzia i usługi: zespoły platform mogą obsługiwać interfejsy API lub skrypty na potrzeby instalacji, walidacji lub wdrażania. McP udostępnia te możliwości bezpośrednio w aplikacji Genie Code.
• Źródła danych: jeśli masz już dane w usłudze Databricks, możesz połączyć kod Genie z agentem Genie, aby ułatwić analizowanie danych przy użyciu języka naturalnego. W przypadku danych przechowywanych poza usługą Databricks można zapewnić bezpieczny dostęp do kodu Genie za pośrednictwem zewnętrznych serwerów MCP.
• Aplikacje niestandardowe: możesz również dodać funkcje niestandardowe hostowane za pomocą usługi Databricks Apps. Dzięki temu możesz połączyć aplikację Genie Code z zastrzeżonymi narzędziami, przepływami pracy lub integracją utworzonymi specjalnie dla Ciebie lub Organizacji, a wszystkie zarządzane bezpiecznie w obszarze roboczym usługi Databricks.

W takich przypadkach MCP zastępuje ręczne kopiowanie i wklejanie ustrukturyzowanym podejściem wielokrotnego użytku, dzięki czemu odpowiedni kontekst jest dostępny tylko w razie potrzeby.

Możesz połączyć kod Genie z dowolnymi serwerami MCP w obszarze roboczym, do którego masz uprawnienia. Administratorzy obszaru roboczego kontrolują, które serwery są dostępne, podczas gdy użytkownicy mogą wybierać z tych zatwierdzonych źródeł zgodnie z potrzebami.

Aby dowiedzieć się więcej o serwerach MCP w Databricks i jak stworzyć własne, zobacz MCP i narzędzia agentów.

Używanie łączników natywnych dla źródeł danych innych firm

Genie Code zapewnia wbudowane złącza dla typowych korporacyjnych źródeł danych:

• Google Drive: Wyszukaj i twórz Google Docs, Sheets i Slides; edytuj utworzone dokumenty.
• Gmail: Wyszukuj, czytaj i tworz e-maile.
• Kalendarz Google: Wyszukaj i twórz wydarzenia w kalendarzu.
• Microsoft 365: Wyszukiwanie w SharePoint, Teams, Outlook oraz w Kalendarzu; tworzenie wiadomości e-mail w programie Outlook.
• Atlassian: Wyszukaj i aktualizuj Jira i Confluence.
• Glean (Beta): Wyszukaj połączone aplikacje organizacji za pomocą Glean.
• Slack: Przeszukaj wiadomości i kanały na Slacku oraz wysyłaj wiadomości.
• GitHub: Wyszukaj i aktualizuj repozytoria, problemy i pull requesty.

Połączenie z tymi źródłami danych pozwala Genie Code przeszukiwać Twoje dokumenty i podejmować działania w powiązanych narzędziach podczas odpowiadania na pytania. Każdy użytkownik uwierzytelnia się indywidualnie, a tokeny OAuth nie są współużytkowane przez użytkowników.

Te połączenia korzystają z konektorów MCP dostarczonych przez Databricks, więc nie ma serwera do hostowania ani aplikacji OAuth do rejestracji. Azure Databricks zarządza każdym połączeniem poprzez Unity Catalog i Unity Gateway. Brama autoryzuje każde wywołanie narzędzia na podstawie uprawnień w Unity Catalog, stosuje wbudowane zasady i wymogi dotyczące zatwierdzania oraz rejestruje dzienniki użycia i audytu w tabelach systemowych. Zobacz Zarejestruj zewnętrzny serwer MCP.

Aby połączyć źródło danych innej firmy:

1. W obszarze roboczym kliknij Kod Genie znajduje się w prawym górnym rogu, aby otworzyć czat.
2. Na pasku monitu kliknij Ikona znaku plus.
3. Obok źródła danych, z którym chcesz nawiązać połączenie, kliknij pozycję Połącz.
4. Wykonaj kroki logowania.

Po uwierzytelnieniu kod Genie może wyszukiwać dokumenty podczas odpowiadania na pytania. Administratorzy magazynu metadanych i właściciele połączeń mogą zarządzać lub odwoływać uprawnienia użytkowników w połączeniu. Zobacz Krok 4. Udziel dostępu do usługi MCP.

Uwaga / Notatka

Narzędzia źródła danych nie zawsze są wyzwalane automatycznie. Jeśli wyszukiwanie dokumentów nie zostanie uruchomione, spróbuj zainicjować wyraźne polecenie dla Genie Code do użycia narzędzia, na przykład "użyj Google Docs" lub "użyj SharePoint".

Aby połączyć inne źródła danych, ręcznie dodaj je do aplikacji Genie Code. Zobacz Ręczne dodawanie serwerów MCP do kodu Genie.

Zadania zaplanowane i uwierzytelnianie

• Genie Code nie ostrzega, gdy wygasa uwierzytelnianie połączenia. Możesz się o tym dowiedzieć dopiero wtedy, gdy wywołanie narzędzia się nie powiedzie lub gdy otworzysz listę połączeń. Ponownie się zaloguj, aby rozwiązać problem.
• Zmiana uprawnień połączenia wymaga ponownego uwierzytelnienia każdego użytkownika. Zaplanowane zadania korzystające z połączenia kończą się niepowodzeniem, dopóki użytkownik nie zostanie ponownie uwierzytelniony.

Ograniczenia Google Drive

• Podczas autoryzowania dysku Google może zostać wyświetlony ekran "niezweryfikowanej aplikacji". Kliknij pozycję Zaawansowane i kontynuuj proces autoryzacji.
• Maksymalny rozmiar pliku to 25 MB.
• Obsługiwane są tylko natywne pliki google workspace (Docs, Arkusze, Slajdy). Pliki PDF, obrazy i inne formaty binarne nie są obsługiwane.
• Genie Code może tworzyć Dokumenty, Arkusze i Prezentacje Google oraz edytować Dokumenty Google utworzone za pomocą tego łącznika. Nie może edytować dokumentów utworzonych poza konektorem ani edytować istniejących arkuszy czy slajdów.
• Czytanie bardzo dużego dokumentu może być powolne.

Uwaga / Notatka

Użycie i transfer nieprzetworzonych lub pochodnych danych użytkownika otrzymanych z interfejsów API usługi Google Workspace będzie zgodne z zasadami danych użytkownika usług Interfejsu API Google, w tym z wymaganiami dotyczącymi ograniczonego użycia.

Ograniczenia Gmaila

• Genie Code może wyszukiwać, czytać i szkicować e-maile, ale nie może wysyłać e-maili ani edytować istniejących wiadomości.
• Genie Code nie może dodawać plików Drive jako natywnych załączników Gmaila. Jako obejście umieść linki do plików w treści e-maila.

Ograniczenia Microsoft 365

• Obejmuje SharePoint, zespoły, Outlook i kalendarz.
• Genie Code może tworzyć szkic e-maila Outlook, ale nie może go wysłać.
• Maksymalny rozmiar pliku to 25 MB dla plików SharePoint.
• Obsługiwane typy plików SharePoint obejmują dokumenty Office (.docx, .xlsx, .pptx), a także popularne formaty tekstowe, takie jak .txt, .csv, .json, .md, i inne. Pliki PDF, obrazy i inne formaty binarne nie są obsługiwane.

Ograniczenia Glean (Beta)

• Glean jest dostępny wyłącznie do wyszukiwania. Nie może odczytać dokumentu z bezpośredniego linku.
• Administrator metastore musi najpierw skonfigurować identyfikator tenanta Glean, zanim użytkownicy niebędący administratorem będą mogli korzystać z połączenia. Administrator może wprowadzić identyfikator dzierżawy podczas pierwszego nawiązywania połączenia z usługą Glean.
• Aby połączyć się z konkretnym serwerem Glean MCP, administrator metastore może opcjonalnie ustawić ścieżkę serwera MCP (na przykład ) /mcp/engpodczas konfiguracji połączenia. Zostaw to pole puste, aby użyć domyślnej ścieżki (/mcp/default). Użytkownicy niebędący administratorami nie mogą określić ani zmienić ścieżki serwera Glean MCP.

Ograniczenia Slacka

• Genie Code nie może edytować ani usuwać wiadomości po jej wysłaniu.

GitHub ograniczenia

• Zapisy ograniczają się do zawartości plików, problemów i pull requestów.
• Domyślnie łącznik usługi Databricks GitHub MCP może uzyskiwać dostęp tylko do repozytoriów publicznych. Aby udzielić łącznikowi dostępu do odczytu do prywatnych repozytoriów przedsiębiorstwa, administrator organizacji GitHub musi ukończyć dodatkową konfigurację. Zobacz Włączanie dostępu do repozytorium prywatnego.
• GitHub Enterprise Server (samodzielnie hostowana wersja GitHub) nie jest obsługiwany.

Ręczne dodawanie serwerów MCP do kodu Genie

Aby połączyć kod Genie z serwerem MCP, dodaj go w ustawieniach kodu Genie:

1. Otwórz ustawienia kodu Genie. W panelu Genie Code kliknij Ustawienia.
2. W obszarze Serwery MCP kliknij Dodaj serwer.
3. Wybierz serwery MCP, które chcesz dodać. Możesz wybrać serwery MCP zarządzane przez usługę Databricks lub zewnętrzne serwery MCP:
   • Funkcja Katalogu Unity: wybierz schemat dla funkcji. Dzięki temu usługa Genie Code może używać funkcji do uruchamiania wstępnie zdefiniowanych zapytań SQL.
     • Aby uzyskać pomoc dotyczącą tworzenia niestandardowego serwera GitHub MCP, zobacz Wyszukiwanie kodu GitHub za pomocą Genie Code.
   • Wyszukiwanie sztucznej inteligencji: wybierz schemat indeksu. Dzięki temu kod Genie może wysyłać zapytania do indeksu wyszukiwania sztucznej inteligencji w celu znalezienia odpowiednich dokumentów.
   • Agent Genie: wybierz agenta Genie. Genie MCP wywołuje Genie jako narzędzie, co pozwala wysyłać zapytania do agenta Genie w celu analizowania danych przy użyciu języka naturalnego.
   • Zewnętrzny serwer MCP: Wybierz połączenie z katalogiem Unity, które ma być używane jako zewnętrzny serwer MCP. Musisz najpierw zalogować się do połączenia, zanim będzie można go użyć.
   • Niestandardowy serwer MCP: wybierz aplikację Databricks, która ma być używana jako niestandardowy serwer MCP. Umożliwia to korzystanie z dowolnych niestandardowych narzędzi zdefiniowanych przez użytkownika. Obowiązują następujące wymagania:
     • Aplikacja musi zostać wdrożona w tym samym obszarze roboczym, z którego próbujesz nawiązać połączenie.
     • Dostęp do serwera MCP należy uzyskać pod adresem https://<server-url>/mcp.
     • Aplikacja musi być bezstanowa. Na przykład ustaw wartość mcp_app = mcp_server.http_app(stateless_http=True).
     • Jeśli wystąpią błędy CORS, może być konieczne dodanie adresu URL Twojego obszaru roboczego do listy dozwolonych źródeł w aplikacji. Na przykład ustaw wartość app.add_middleware(CORSMiddleware, allow_origins=ALLOWED_ORIGINS, allow_credentials=True, allow_methods= ["*"], allow_headers= ["*"]).
4. Kliknij przycisk Zapisz.

Po dodaniu serwerów MCP są natychmiast dostępne dla aplikacji Genie Code. Możesz zacząć ich używać bez zmieniania monitów lub instrukcji. Kod Genie automatycznie korzysta z tych serwerów, gdy jest to istotne.

W ustawieniach kodu Genie można wybrać narzędzia i serwery, które mają być włączone lub wyłączone.

Ograniczenia

Aby uzyskać wytyczne dotyczące zgodności dla aplikacji połączonych, zobacz ograniczenia usług MCP udostępniane przez Databricks.

• Zewnętrzne serwery MCP są dostępne tylko w regionach, w których dostępne jest serwowanie modeli. Zobacz Dostępność funkcji obsługujących model.