Pular para o conteúdo principal
Última atualização em

Plug-in do Genie para o Microsoft Copiloto Cowork

info

Beta

Este recurso está em Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.

O plugin Genie para Microsoft Copilot Cowork permite que os usuários façam perguntas em linguagem natural sobre seus dados do Databricks diretamente do Copilot Cowork. O plug-in conecta o Copilot Cowork ao Genie por meio do servidor MCP Genie gerenciado fornecido pela Databricks. Esta página é para administradores de conta do Databricks e administradores do Microsoft 365 que estão configurando a integração. Abrange a configuração da conexão OAuth, o empacotamento do manifesto do plugin e a habilitação do plugin no Copilot Cowork.

Pré-requisitos​

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

Etapa 1: Criar a conexão do aplicativo OAuth do Databricks​

No console da sua conta Databricks, crie uma conexão de aplicativo OAuth personalizada. Consulte Habilitar aplicativos OAuth personalizados usando a interface de usuário do Databricks para obter detalhes. Use os seguintes valores para o Copilot Cowork:

  • Redirecionar URLs: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
  • Escopos de acesso : Selecione Todas as APIs .
  • Segredo do cliente : gerar segredo de cliente. Depois de criar a conexão, copie e armazene com segurança o segredo do cliente e a **ID do cliente**. Não será possível recuperar o segredo do cliente posteriormente.

Etapa 2: Criar o registro do cliente OAuth no Portal do Desenvolvedor do Teams​

Registrar um cliente OAuth no Teams Developer Portal usando os detalhes de conexão do passo 1, para que o Copilot Cowork possa se autenticar no seu workspace do Databricks. Para obter mais informações, consulte a documentação da Microsoft.

  1. No Portal do Desenvolvedor do Teams, vá para Ferramentas > Registro de cliente OAuth .

  2. Clique em Novo registro de cliente OAuth e forneça o seguinte:

    • Nome de registro : 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: Sua organização do Microsoft 365.
    • Restringir uso por aplicativo : Deixe em branco.
    • ID do cliente: O ID do cliente quando você criou uma conexão de aplicativo OAuth do Databricks.
    • Segredo do cliente: o segredo gerado quando você criou uma conexão de aplicativo OAuth do Databricks.
    • Endpoint de autorização : https://<workspace-hostname>/oidc/v1/authorize
    • Endpoint de token : https://<workspace-hostname>/oidc/v1/token
    • refresh endpoint : https://<workspace-hostname>/oidc/v1/token
    • Escopo : genie

  3. Clique em **Salvar**, em seguida, copie a **ID de registro do cliente OAuth** para referência posterior.

Passo 3: configurar o manifesto​

Atualize o manifesto padrão com seu ID do aplicativo, hostname do workspace e ID de registro OAuth.

  1. Descompacte o pacote de padrão de manifesto de Pré-requisitos, que inclui manifest.json, color.png e outline.png.
  2. Abra manifest.json e substitua os seguintes espaços reservados:
    • <YOUR_APP_ID>: Gerar um novo GUID. Por exemplo, execute uuidgen no seu terminal.
    • <YOUR_WORKSPACE_HOSTNAME>: seu hostname do workspace do Databricks.
    • <YOUR_OAUTH_REGISTRATION_ID>: O ID de registro copiado do o passo 2.

Passo 4: Empacotar e Instalar​

Empacotar os arquivos de manifesto em um zip e instalar o aplicativo com a CLI atk.

  1. Compacte os três arquivos juntos. O zip deve contê-los no diretório raiz, não dentro de uma subpasta:

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

  2. Instale o pacote:

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

O passo 5: Habilitar o plug-in no Copilot Cowork​

Conecte-se ao plugin Genie no Copilot Cowork. Para saber mais sobre plugins no Copilot Cowork, consulte a documentação da Microsoft.

  1. Abra o Microsoft Copilot Cowork.
  2. Localize o plugin Databricks Genie na lista de plugins e ative o alternador.
  3. Clique em Conectar . Quando o aviso de login aparecer, autentique-se com as suas credenciais do Databricks.

Após o senhor fizer login, pode fazer perguntas ao Copilot Cowork sobre seus dados na Databricks, por exemplo: "Quantos pedidos chegaram na semana passada?"

Nesta página