Wtyczka Genie do Microsoft Copilot Cowork

Wtyczka Genie dla Microsoft Copilot Cowork umożliwia użytkownikom zadawanie pytań w języku naturalnym na temat swoich danych w Azure Databricks bezpośrednio w Copilot Cowork. Wtyczka łączy Copilot Cowork z usługą Genie za pośrednictwem zarządzanego serwera MCP genie udostępnionego przez Azure Databricks. Ta strona dotyczy administratorów kont Azure Databricks i administratorów Microsoft 365 konfigurowania integracji. Obejmuje ona konfigurowanie połączenia OAuth, pakowanie manifestu wtyczki i włączanie wtyczki w aplikacji Copilot Cowork.

Prerequisites

Przed rozpoczęciem upewnij się, że masz następujące elementy:

• Obszar roboczy Azure Databricks z włączoną obsługą usługi Genie.

• Dostęp administratora do konta usługi Azure Databricks

• Dostęp do portalu deweloperów usługi Teams.

• Mieć zainstalowany program Node.js, którego wymaga wiersz polecenia zestawu narzędzi Microsoft 365 Agents Toolkit (atk).

• Wtyczka Genie dla pakietu szablonu manifestu Copilot Cowork:

  Pobieranie pakietu szablonu manifestu

Krok 1. Utwórz połączenie z aplikacją OAuth Azure Databricks

W konsoli konta Azure Databricks utwórz niestandardowe połączenie aplikacji OAuth. Aby uzyskać szczegółowe informacje, zobacz Włączanie niestandardowych aplikacji OAuth przy użyciu interfejsu użytkownika Azure Databricks. Użyj następujących wartości dla Copilot Cowork:

• Adresy URL przekierowania: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• Zakresy dostępu: wybierz pozycję Wszystkie interfejsy API.
• Klucz tajny klienta: wygeneruj klucz tajny klienta. Po utworzeniu połączenia skopiuj i bezpiecznie zapisz klucz tajny klienta oraz identyfikator klienta. Nie można później odzyskać tajemnicy klienta.

Krok 2. Tworzenie rejestracji klienta OAuth w portalu deweloperów usługi Teams

Zarejestruj klienta OAuth w Portalu dla deweloperów aplikacji Teams, używając danych połączenia z kroku 1, aby Copilot Cowork mógł się uwierzytelniać w obszarze roboczym usługi Azure Databricks. Aby uzyskać więcej informacji, zobacz dokumentację firmy Microsoft.

1. W portalu deweloperów usługi Teams przejdź do pozycji Narzędzia>Rejestracja klienta OAuth.
2. Kliknij pozycję Nowa rejestracja klienta OAuth i podaj następujące informacje:
   • Nazwa rejestracji: opisowa nazwa, na przykład Databricks Genie.
   • Podstawowy adres URL: https://<workspace-hostname>, na przykład https://my-workspace.cloud.databricks.com.
   • Ogranicz użycie według organizacji: Twoja organizacja Microsoft 365.
   • Ogranicz użycie według aplikacji: pozostaw wartość pustą.
   • Identyfikator klienta: identyfikator klienta podany przy tworzeniu połączenia aplikacji OAuth usługi Azure Databricks.
   • Wpis tajny klienta: wpis tajny wygenerowany podczas tworzenia połączenia aplikacji OAuth usługi Azure Databricks.
   • Punkt końcowy autoryzacji: https://<workspace-hostname>/oidc/v1/authorize
   • Punkt końcowy tokenu: https://<workspace-hostname>/oidc/v1/token
   • Odśwież punkt końcowy: https://<workspace-hostname>/oidc/v1/token
   • Zakres: genie
3. Kliknij przycisk Zapisz, a następnie skopiuj identyfikator rejestracji klienta OAuth do późniejszego odwołania.

Krok 3. Konfigurowanie manifestu

Zaktualizuj manifest szablonu, podając identyfikator aplikacji, nazwę hosta przestrzeni roboczej i identyfikator rejestracji OAuth.

1. Rozpakuj pakiet szablonu manifestu z sekcji Wymagania wstępne, w tym manifest.json, color.pngi outline.png.
2. Otwórz manifest.json i zastąp następujące symbole zastępcze:
   • <YOUR_APP_ID>: Wygeneruj nowy identyfikator GUID. Na przykład uruchom polecenie uuidgen w terminalu.
   • <YOUR_WORKSPACE_HOSTNAME>: Nazwa hosta obszaru roboczego usługi Azure Databricks.
   • <YOUR_OAUTH_REGISTRATION_ID>: identyfikator rejestracji skopiowany z kroku 2.

Krok 4. Pakowanie i instalowanie

Spakuj pliki manifestu do pliku zip i zainstaluj aplikację za pomocą interfejsu atk wiersza polecenia.

1. Spakuj trzy pliki razem. Plik zip musi zawierać je w katalogu głównym, a nie wewnątrz podfolderu:

   cd /path/to/your/package/folder
   zip package.zip manifest.json color.png outline.png
   

2. Zainstaluj pakiet:

   atk install --file-path package.zip --scope Shared
   

Krok 5. Włączanie wtyczki w aplikacji Copilot Cowork

Połącz się z wtyczką Genie w aplikacji Copilot Cowork. Aby uzyskać więcej informacji na temat wtyczek w aplikacji Copilot Cowork, zobacz dokumentację Microsoft.

1. Otwórz Microsoft Copilot Cowork.
2. Znajdź na liście wtyczek wtyczkę Databricks Genie i włącz przełącznik.
3. Kliknij Połącz. Po wyświetleniu monitu logowania uwierzytelnij się przy użyciu poświadczeń Azure Databricks.

Po zalogowaniu możesz zadawać Copilot Cowork pytania dotyczące danych w usłudze Azure Databricks, na przykład: „Ile zamówień wpłynęło w zeszłym tygodniu?”