Łączenie kodu Genie z serwerami MCP

Połącz kod Genie z zewnętrznymi narzędziami i źródłami danych za pomocą protokołu MCP (Model Context Protocol). Kod Genie może używać dowolnych serwerów MCP, które zostały dodane do obszaru roboczego i do których masz przyznane uprawnienia.

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 przestrzenią 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, 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.

Nawiązywanie połączenia ze źródłami 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 łączniki dla typowych źródeł danych przedsiębiorstwa, w tym Google Drive i SharePoint.

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 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ż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

• 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.

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 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ą dodawania serwera GitHub MCP, zobacz tworzenie serwera GitHub MCP.
   • 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.
   • Przestrzeń Genie: Wybierz przestrzeń Genie. Genie MCP wywołuje Genie jako narzędzie, co umożliwia wykonywanie zapytań względem przestrzeni 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.