plugin Genie para Microsoft Copilot Cowork

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

Pré-requisitos

Antes de começar, certifique-se de que você tenha o seguinte:

• Um workspace do Azure Databricks com o Genie habilitado.

• Acesso de administrador à conta do Azure Databricks.

• Acesso ao Portal do Desenvolvedor do Teams.

• Node.js instalado, que a CLI do Kit de Ferramentas do Microsoft 365 Agents (atk) requer.

• O pacote de modelo de manifesto do Genie Plugin for Copilot Cowork:

  Baixar o pacote de modelo de manifesto

Etapa 1: Criar a conexão de aplicativo OAuth Azure Databricks

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

• URLs de redirecionamento: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• Escopos de acesso: Selecione todas as APIs.
• Segredo do cliente: gerar um segredo do cliente. Depois de criar a conexão, copie e armazene com segurança o segredo do cliente e a ID do cliente. Você não pode recuperar o segredo do cliente mais tarde.

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

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

1. No Portal do Desenvolvedor do Teams, acesse Tools>Registro de cliente OAuth.
2. Clique em Novo registro do cliente OAuth e forneça o seguinte:
   • Nome do 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 Microsoft 365.
   • Restringir o uso por aplicativo: deixe em branco.
   • ID do cliente: a ID do cliente quando você criou uma conexão de aplicativo OAuth Azure Databricks.
   • Segredo do cliente: o segredo gerado quando você criou uma conexão de aplicativo OAuth Azure Databricks.
   • Ponto de extremidade de autorização: https://<workspace-hostname>/oidc/v1/authorize
   • Ponto de extremidade de token: https://<workspace-hostname>/oidc/v1/token
   • Atualizar endpoint: https://<workspace-hostname>/oidc/v1/token
   • Âmbito: genie
3. Clique em Salvar e copie a ID de registro do cliente OAuth para fazer referência posteriormente.

Etapa 3: Configurar o manifesto

Atualize o manifesto do modelo com a ID do aplicativo, o nome de host do workspace e a ID de registro do OAuth.

1. Descompacte o pacote do modelo de manifesto em 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>: gere um novo GUID. Por exemplo, execute uuidgen em seu terminal.
   • <YOUR_WORKSPACE_HOSTNAME>: O nome do host do seu workspace do Azure Databricks.
   • <YOUR_OAUTH_REGISTRATION_ID>: a ID de registro copiada da Etapa 2.

Etapa 4: Empacotar e instalar

Empacote os arquivos de manifesto em um zip e instale o aplicativo com a atk CLI.

1. Compacte os três arquivos em um arquivo ZIP. O zip deve contê-los no diretório 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
   

Etapa 5: Habilitar o plug-in no Copilot Cowork

Conecte-se ao plug-in do Genie em Copilot Cowork. Para obter mais informações sobre plug-ins no Copilot Cowork, consulte a Documentação do Microsoft.

1. Abra Microsoft Copilot Cowork.
2. Encontre o plugin Databricks Genie na lista de plugins e ative o botão de alternância.
3. Clique em Conectar. Quando o prompt de login for exibido, autentique-se com suas credenciais do Azure Databricks.

Depois de entrar, você pode fazer perguntas Copilot Cowork sobre seus dados de Azure Databricks, por exemplo, "Quantos pedidos chegaram na semana passada?"