Połącz agenta Genie z zewnętrznymi narzędziami i źródłami

Agent Genie może korzystać z konektorów MCP (Model Context Protocol) dostarczonych przez Databricks, aby pobierać kontekst i podejmować działania w zewnętrznych narzędziach i źródłach podczas rozmowy w trybie Agent. Autor agenta dołącza konektory, a każdy użytkownik uwierzytelnia się do nich indywidualnie. Każde wywołanie narzędzia wykonuje się z uprawnieniami użytkownika, który zadał pytanie.

Jak działają złącza MCP w Genie Agent

Konektory MCP pozwalają agentowi Genie łączyć analizę SQL i plików z zewnętrznymi aplikacjami, z których Twoja organizacja już korzysta. Na przykład jedna rozmowa może przeanalizować tabelę sprzedaży, pobrać powiązany kontekst z Google Drive i przygotować podsumowujący e-mail. Azure Databricks zarządza każdym wywołaniem narzędzia poprzez Unity Catalog i Unity Gateway. Zobacz Zarządzaj MCP.

Narzędzia MCP dzielą się na dwie kategorie:

• Narzędzia tylko do odczytu (wyszukiwanie, pobieranie i wyświetlanie listy) działają automatycznie.
• Narzędzia do pisania (na przykład wysyłanie wiadomości lub tworzenie szkicu e-maila) zatrzymują się i proszą użytkownika o zatwierdzenie działania przed jego uruchomieniem.

Genie Agents obsługują następujące złącza MCP dostarczone przez Databricks:

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

Requirements

Następujące wymagania dotyczą agenta i jego użytkowników:

• Unity Catalog jest włączony w obszarze roboczym.
• Tryb agenta jest dostępny w Twoim regionie. Zobacz Usługi Wyznaczone przez Databricks.

• Unity Gateway dostępny w twoim regionie. Zobacz obsługiwane regiony.

• Zarówno dostęp do obszaru roboczego , jak i uprawnienia dostępu sql usługi Databricks dla każdego użytkownika agenta. Użytkownicy z dostępem tylko do środowiska użytkownika, użytkownicy tylko Databricks SQL i użytkownicy tylko konta nie mogą korzystać z narzędzi MCP. Zobacz Uprawnienia dostępu.
• Konto w każdym połączonym systemie zewnętrznym dla każdego użytkownika agenta.

Dodaj złącza do agenta Genie

Aby podłączyć konektory do agenta Genie:

1. Otwórz agenta Genie.
2. Otwórz kartę Źródła , a następnie kliknij przycisk Dodaj.
3. Wybierz jedną lub więcej usług MCP.

Aby podłączyć złącze, potrzebujesz uprawnienia EXECUTE do usługi MCP złącza w Unity Catalog, a także uprawnień USE CATALOG i USE SCHEMA do jego katalogu nadrzędnego i schematu. Złącza, których nie masz pozwolenia na uruchamianie, są niedostępne. Zobacz MCPs udostępnione przez Databricks.

Konfigurowanie narzędzi

Po podłączeniu złącza skonfiguruj, jak agent go używa:

• Dodaj jasny opis , który wyjaśnia, jak i kiedy agent powinien korzystać z narzędzi łącznika. Na przykład możesz polecić agentowi wymagany format tytułu zgłoszenia lub polecić mu sprawdzenie profilu użytkownika na początku każdej rozmowy.
• Włącz lub wyłącz poszczególne narzędzia w złączu, aby określić zakres działań, które agent może wykonać.

Używaj narzędzi MCP w rozmowie

Aby używać narzędzi MCP w agencie Genie:

1. Otwórz agenta Genie, który ma podłączone konektory MCP.
2. Włącz tryb agenta w polu czatu.
3. Uwierzytelnij się do złącza z panelu Configure. Jeśli agent potrzebuje złącza, do którego nie udzieliłeś dostępu, lub Twoje uwierzytelnienie wygasło, agent poprosi Cię o zalogowanie się.
4. Wyślij prompt z użyciem konektora. Gdy agent wywołuje narzędzie do zapisu, wybierz Zezwól raz, aby zatwierdzić pojedynczą akcję, Zawsze zezwalaj na tym czacie, aby zezwolić na używanie tego narzędzia przez resztę rozmowy, lub Odrzuć, aby je odrzucić.

Aby potwierdzić, że łącznik działa, zadaj pytanie, które tego wymaga, na przykład "Wyszukaj w Google Drive plan sprzedaży na trzeci kwartał." Agent w odpowiedzi podaje zewnętrzne źródło, którego wykorzystał.

Limitations

Obowiązują następujące ograniczenia:

• Narzędzia MCP działają tylko w trybie agenta. Nie działają w trybie czatu.
• W interfejsach API trybu agenta działają tylko narzędzia do odczytu, a użytkownicy nie mogą uwierzytelnić się do konektora. Ukończ uwierzytelnianie i zatwierdzenie narzędzia do zapisu w interfejsie użytkownika.
• Wytyczne dotyczące zgodności dla aplikacji połączonych z usługami zewnętrznymi znajdują się w artykule Wymagania zewnętrznego dostawcy.

Poniższe sekcje opisują ograniczenia dla konkretnych złączy.

Dysk Google

• Podczas autoryzacji Google Drive możesz zobaczyć ekran Niezweryfikowana aplikacja. 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.
• Łącznik może tworzyć Google Docs, Sheets i Slides oraz edytować utworzone przez siebie Google Docs. 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.

Gmail

• Łącznik może wyszukiwać, czytać i szkicować e-maile, ale nie może wysyłać e-maili ani edytować istniejących wiadomości.
• Konektor 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.

Microsoft 365

• Obejmuje SharePoint, zespoły, Outlook i kalendarz.
• Łącznik 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ą wbudowane dokumenty SharePoint, arkusze kalkulacyjne i prezentacje, a także typowe formaty tekstowe, takie jak .txt, .csv, .json, .mdi inne. Pliki PDF, obrazy i inne formaty binarne nie są obsługiwane.

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 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.
• Aby połączyć się z konkretnym serwerem Glean MCP, administrator metastore może opcjonalnie ustawić ścieżkę serwera MCP (na przykład ) /mcp/engpodczas konfigurowania 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.

Slack

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

GitHub

• 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 przyznać łącznikowi uprawnienia tylko do odczytu do prywatnych repozytoriów firmowych, administrator organizacji GitHub musi przeprowadzić dodatkową konfigurację. Zobacz Włącz dostęp do zapisu na GitHub oraz dostęp do prywatnego repozytorium.
• GitHub Enterprise Server (samodzielnie hostowana wersja GitHub) nie jest obsługiwany.

Dodatkowe zasoby

Aby uzyskać powiązane informacje, zobacz następujące zasoby:

• Połącz Genie One z zewnętrznymi narzędziami i źródłami
• MCP dostarczane przez Databricks
• Zarządzani dostawcy OAuth
• Zewnętrzne serwery MCP
• Zarządzanie AI z Unity Gateway