Complemento Genie para Microsoft Copilot Cowork

Genie complementos para Microsoft Copilot Cowork permite a los usuarios hacer preguntas en lenguaje natural sobre sus datos de Azure Databricks directamente desde Copilot Cowork. El complemento conecta Copilot Cowork a Genie a través del servidor MCP administrado por Genie proporcionado por Azure Databricks. Esta página es para Azure Databricks administradores de cuentas y administradores de Microsoft 365 que configuran la integración. Abarca la configuración de la conexión de OAuth, el empaquetado del manifiesto del complemento y la habilitación del complemento en Copilot Cowork.

Prerequisites

Antes de comenzar, asegúrese de que dispone de lo siguiente:

• Un área de trabajo de Azure Databricks con Genie habilitado.

• Azure Databricks acceso de administrador a la cuenta.

• Acceso al Portal para desarrolladores de Teams.

• Node.js instalado, que requiere la CLI del kit de herramientas de Microsoft 365 Agents (atk).

• El paquete de plantillas de manifiesto del complemento Genie para Copilot Cowork:

  Descarga del paquete de plantilla de manifiesto

Paso 1: Creación de la conexión de aplicación de OAuth Azure Databricks

En la consola de la cuenta de Azure Databricks, cree una conexión de aplicación de OAuth personalizada. Consulte Habilitación de aplicaciones de OAuth personalizadas mediante la interfaz de usuario de Azure Databricks para obtener más información. Use los siguientes valores para Copilot Cowork:

• URL de redirección: https://teams.microsoft.com/api/platform/v1.0/oAuthRedirect
• Ámbitos de acceso: seleccione Todas las API.
• Secreto de cliente: genere un secreto de cliente. Después de crear la conexión, copie y almacene de forma segura el secreto de cliente y el identificador de cliente. No se puede recuperar el secreto del cliente más adelante.

Paso 2: Crear el registro de cliente de OAuth en el Portal para desarrolladores de Teams

Registre un cliente de OAuth en el Portal para desarrolladores de Teams con los detalles de conexión del paso 1, por lo que Copilot Cowork puede autenticarse en el área de trabajo de Azure Databricks. Para obtener más información, consulte la documentación de Microsoft.

1. En el Portal de desarrolladores de Teams, vaya a Herramientas>Registro de clientes OAuth.
2. Haga clic en Nuevo registro de cliente de OAuth y proporcione lo siguiente:
   • Nombre de registro: un nombre descriptivo, por ejemplo, Databricks Genie.
   • Dirección URL base: https://<workspace-hostname>, por ejemplo, https://my-workspace.cloud.databricks.com.
   • Restringir el uso por organización: su organización de Microsoft 365.
   • Restringir el uso por aplicación: deje en blanco.
   • Identificador de cliente: el identificador de cliente al crear una conexión de aplicación OAuth de Azure Databricks.
   • Secreto de cliente: el secreto generado al crear una conexión de aplicación de OAuth Azure Databricks.
   • Punto de conexión de autorización: https://<workspace-hostname>/oidc/v1/authorize
   • Punto de conexión del token: https://<workspace-hostname>/oidc/v1/token
   • Actualizar punto de conexión: https://<workspace-hostname>/oidc/v1/token
   • Ámbito: genie
3. Haga clic en Guardar y, a continuación, copie el identificador de registro de cliente de OAuth para hacer referencia más adelante.

Paso 3: Configurar el manifiesto

Actualice el manifiesto de la plantilla con su identificador de aplicación, el nombre de host de su área de trabajo y su identificador de registro de OAuth.

1. Descomprima el paquete de plantilla de manifiesto de Requisitos previos, que incluye manifest.json, color.pngy outline.png.
2. Abra manifest.json y reemplace los siguientes marcadores de posición:
   • <YOUR_APP_ID>: para generar un código GUID nuevo. Por ejemplo, ejecute uuidgen en el terminal.
   • <YOUR_WORKSPACE_HOSTNAME>: El nombre de host del espacio de trabajo de Azure Databricks.
   • <YOUR_OAUTH_REGISTRATION_ID>: el identificador de registro copiado del paso 2.

Paso 4: Empaquetar e instalar

Empaquete los archivos de manifiesto en un archivo ZIP e instale la aplicación con la atk CLI.

1. Comprima los tres archivos juntos. El archivo ZIP debe contenerlos en el directorio raíz, no dentro de una subcarpeta:

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

2. Instala el paquete:

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

Paso 5: Habilitar el complemento en Copilot Cowork

Conéctese al complemento Genie en Copilot Cowork. Para obtener más información sobre los complementos de Copilot Cowork, consulte la documentación de Microsoft.

1. Abra Microsoft Copilot Cowork.
2. Busque el complemento Databricks Genie en la lista de complementos y active el interruptor.
3. Haga clic en Conectar. Cuando aparezca el mensaje de inicio de sesión, autentíquese con sus credenciales de Azure Databricks.

Después de iniciar sesión, puede hacer preguntas Copilot Cowork sobre los datos de Azure Databricks, por ejemplo, "¿Cuántos pedidos llegaron en la semana pasada?"