Plugin Genie para o Microsoft Copilot Cowork

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

O plug-in Genie para o Microsoft Copilot Cowork permite aos utilizadores fazer perguntas em linguagem natural sobre os seus dados do Azure Databricks diretamente a partir do Copilot Cowork. O plugin liga o Copilot Cowork ao Genie através do servidor MCP gerido pelo Genie fornecido pelo Azure Databricks. Esta página é para administradores de contas do Azure Databricks e administradores do Microsoft 365 que estão a configurar a integração. Abrange a configuração da ligação OAuth, o empacotamento do manifesto do plugin e a ativação do plugin no Copilot Cowork.

Prerequisites

Antes de começar, certifique-se de que tem o seguinte:

Passo 1: Criar a conexão da aplicação Azure Databricks OAuth

Na sua consola de contas Azure Databricks, crie uma ligação personalizada à aplicação OAuth. Consulte Ativar aplicações OAuth personalizadas usando a interface do Azure Databricks para mais detalhes. Use os seguintes valores para o Copilot Cowork:

  • URLs de redirecionamento: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
  • Aceder aos âmbitos: Selecionar Todas as APIs.
  • Segredo do cliente: Gerar um segredo do cliente. Depois de criar a ligação, copie e armazene de forma segura o segredo do cliente e o ID do Cliente. Não é possível recuperar o segredo do cliente mais tarde.

Passo 2: Criar o registo do cliente OAuth no Portal de Desenvolvedores de Teams

Registe um cliente OAuth no Portal de Desenvolvedores Teams usando os detalhes de ligação do Passo 1, para que o Copilot Cowork possa autenticar-se no seu espaço de trabalho do Azure Databricks. Para mais informações, consulte a documentação da Microsoft.

  1. No Portal do Programador do Teams, vá para Ferramentas>Registo de cliente OAuth.
  2. Clique em novo registo de cliente OAuth e forneça o seguinte:
    • Nome de registo: Um nome descritivo, por exemplo, Databricks Genie.
    • URL base: https://<workspace-hostname>, por exemplo, https://my-workspace.cloud.databricks.com.
    • Restringir o uso por organização: A sua organização Microsoft 365.
    • Restringir o uso pela aplicação: Deixar em branco.
    • ID do cliente: O ID do cliente quando criou uma ligação de aplicação Azure Databricks OAuth.
    • Segredo do cliente: O segredo gerado quando criaste uma ligação de aplicação Azure Databricks OAuth.
    • Endpoint de autorização: https://<workspace-hostname>/oidc/v1/authorize
    • Endpoint de token: https://<workspace-hostname>/oidc/v1/token
    • Ponto final de atualização: https://<workspace-hostname>/oidc/v1/token
    • Âmbito: genie
  3. Clique em Guardar, depois copie o ID de registo do cliente OAuth para referência mais tarde.

Passo 3: Configurar o manifesto

Atualize o manifesto do modelo com o ID da sua aplicação, nome do host do espaço de trabalho e ID de registo OAuth.

  1. Descompacte o pacote modelo de manifestos a partir de Pré-requisitos, que inclui manifest.json, color.png, e outline.png.
  2. Abra manifest.json e substitua os seguintes marcadores de posição:
    • <YOUR_APP_ID>: Gerar um novo GUID. Por exemplo, executa uuidgen no teu terminal.
    • <YOUR_WORKSPACE_HOSTNAME>: O nome do anfitrião da sua área de trabalho do Azure Databricks.
    • <YOUR_OAUTH_REGISTRATION_ID>: O ID de registo copiado do Passo 2.

Passo 4: Empacotar e instalar

Empacote os ficheiros de manifesto num ficheiro ZIP e instale a aplicação com a atk CLI.

  1. Comprime os três ficheiros juntos. O zip deve contê-los na diretoria raiz, não dentro de uma subpasta:

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

  2. Instale o pacote:

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

Passo 5: Ativar o plugin no Copilot Cowork

Liga-te ao plugin Genie no Copilot Cowork. Para saber mais sobre plugins no Copilot Cowork, consulte a Documentação da Microsoft.

  1. Abre o Microsoft Copilot Cowork.
  2. Encontre o plugin Databricks Genie na lista de plugins e ative o interruptor.
  3. Clique em Conectar. Quando aparecer o prompt de iniciação de sessão, autentique com as suas credenciais do Azure Databricks.

Depois de iniciar sessão, pode fazer perguntas ao Copilot Cowork sobre os seus dados no Azure Databricks, por exemplo, "Quantas encomendas chegaram na semana passada?"

  • Last updated on