Łączenie kodu Genie z serwerami MCP

Tryb Code Agent w Genie łączy się z zewnętrznymi narzędziami, dokumentami i danymi za pośrednictwem serwerów Model Context Protocol (MCP) oraz natywnych łączników do Google Drive, SharePoint, GitHub, Glean i Atlassian. Użyj łączników natywnych dla typowych źródeł SaaS lub dodaj własne zewnętrzne lub niestandardowe serwery MCP z obszaru roboczego. Dostęp do MCP jest ograniczony do 20 narzędzi łącznie na wszystkich serwerach; wybierasz narzędzia, które chcesz włączyć, w ustawieniach Genie Code.

Uwaga / Notatka

Serwery MCP są obsługiwane tylko w trybie agenta kodu Genie.

Co to jest MCP?

MCP to standard open source łączący agentów sztucznej inteligencji 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 sztucznej inteligencji, 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. Dokumenty mogą już znajdować się w usłudze Databricks jako indeks wyszukiwania wektorowego, którego kod Genie może używać do wykonywania zapytań dotyczących 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 usługą Genie Space, 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, a użytkownicy mogą wybierać spośród zatwierdzonych źródeł zgodnie z potrzebami.

Aby dowiedzieć się więcej o serwerach MCP w usłudze Databricks i sposobie tworzenia własnych, zobacz Model Context Protocol (MCP) on Databricks (Model Context Protocol) (Protokół MCP) w usłudze Databricks.

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

Ważna

Ta funkcja jest dostępna w wersji beta. Aby korzystać z łączników źródeł danych innych firm, administrator obszaru roboczego musi włączyć Łączniki innych firm dla agentów w trybie podglądu. Zobacz Zarządzanie podglądami Azure Databricks.

Genie Code udostępnia wbudowane konektory do typowych firmowych źródeł danych, w tym Google Drive, SharePoint, GitHub, Glean i Atlassian.

Nawiązywanie połączenia z tymi źródłami danych umożliwia usłudze Genie Code wyszukiwanie dokumentów podczas odpowiadania na pytania. Każdy użytkownik uwierzytelnia się indywidualnie, a tokeny OAuth nie są współużytkowane przez użytkowników.

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

  1. W obszarze roboczym kliknij ikonę kodu Sparkle Genie. Kod Genie znajduje się w prawym górnym rogu, aby otworzyć czat.
  2. Na pasku monitu kliknij pozycję Nowa ikona. 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żytkownika w połączeniu. Zobacz Udostępnianie połączenia z serwerem 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.

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 10 MB.
  • Obsługiwane są tylko natywne pliki google workspace (Docs, Arkusze, Slajdy). Pliki PDF, obrazy i inne formaty binarne nie są obsługiwane.
  • Błędy wygaśnięcia połączenia lub tokenu mogą pojawić się w danych wyjściowych agenta. Ponownie się zaloguj, aby rozwiązać problem.

ograniczenia SharePoint

  • Maksymalny rozmiar pliku to 10 MB.
  • Obsługiwane typy plików obejmują dokumenty pakietu Office (.docx, .xlsx, .pptx), a także typowe formaty tekstowe, takie jak .txt, .csv, .json, .mdi inne. Pliki PDF, obrazy i inne formaty binarne nie są obsługiwane.

GitHub ograniczenia

  • Domyślnie łącznik usługi Databricks GitHub MCP może uzyskiwać dostęp tylko do repozytoriów publicznych. Aby przyznać łącznikowi uprawnienia tylko do odczytu do prywatnych repozytoriów firmowych, administrator organizacji GitHub musi przeprowadzić dodatkową konfigurację. Zobacz Włączanie dostępu do repozytorium prywatnego.
  • GitHub Enterprise Server (samodzielnie hostowana wersja GitHub) nie jest obsługiwany.

Ograniczenia Glean

  • Administrator obszaru roboczego musi najpierw skonfigurować identyfikator dzierżawy Glean, zanim użytkownicy niebędący administratorami będą mogli korzystać z połączenia. Administrator może wprowadzić identyfikator dzierżawy podczas pierwszego nawiązywania połączenia z usługą Glean.

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. Na panelu Genie Code (Kod genie) kliknij ikonę Koła zębatego. Ustawienia.
  2. W obszarze Serwery MCP kliknij pozycję Nowa ikona. 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.
    • Wyszukiwanie wektorowe: wybierz schemat indeksu. Dzięki temu kod Genie może wysyłać zapytania do indeksu wyszukiwania wektorów w celu znalezienia odpowiednich dokumentów.
    • Genie Space: Wybierz przestrzeń Genie. Genie MCP wywołuje Genie jako narzędzie, co umożliwia wykonywanie zapytań względem obszaru 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 obszaru roboczego do listy dozwolonych źródeł pochodzenia 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 rozpocząć korzystanie z nich w trybie agenta bez zmieniania monitów lub instrukcji. Kod Genie będzie automatycznie korzystał z tych serwerów, gdy to ma znaczenie.

Obecnie dostęp mcP jest ograniczony do 20 narzędzi na wszystkich serwerach. W ustawieniach kodu Genie można wybrać narzędzia i serwery, które mają być włączone lub wyłączone.

Ograniczenia

  • Last updated on