Aplicación Databricks Genie en Microsoft Teams

La aplicación Databricks Genie de Microsoft Teams lleva a Genie a Microsoft Teams para que los usuarios puedan formular preguntas de datos y obtener respuestas sin salir del área de trabajo de Microsoft Teams. Los usuarios pueden chatear con la aplicación en un mensaje directo o mencionar @Databricks Genie en un canal o chat de grupo de Microsoft Teams. Las preguntas son respondidas por Genie One o por un Agente Genie específico que el propietario del canal ha fijado para obtener respuestas consistentes y específicas de cada caso.

La aplicación Genie de Databricks en Microsoft Teams depende de la API de Genie One en ambos casos; cuando un Agente Genie está fijado, Genie One envía la pregunta solo a ese agente. La aplicación utiliza los mismos proveedores modelo y garantías de confianza y seguridad que Genie. Consulte El proveedor de hospedaje que se utiliza cuando la opción de funciones de IA impulsadas por partners está habilitada y deshabilitada y Confianza y seguridad de las funciones de asistencia de IA de Databricks.

En esta página se describe cómo descargar, configurar y usar la aplicación Databricks Genie en Microsoft Teams.

Prerequisites

Antes de instalar la aplicación Databricks Genie en Microsoft Teams:

• Un administrador de cuenta debe habilitar Databricks Genie para Microsoft Teams versión preliminar en la consola de la cuenta.
• Para permitir que los usuarios suban archivos por mensajes directos, un administrador de espacio de trabajo debe activar la vista previa de Genie One File Upload, y la cuenta de Microsoft Teams de cada usuario debe tener OneDrive para la Empresa. Consulte Cargar archivos.
• Para que los usuarios puedan guardar documentos como PDFs en mensajes directos, cada usuario necesita OneDrive y la versión 1.0.17 y superior de la aplicación Databricks Genie en Microsoft Teams. Consulta Guardar documentos en formato PDF.
• Si tu espacio de trabajo usa una lista de acceso por IP, agrega las direcciones IP salientes del plano de control de Azure Databricks en la región East US 2. Consulte las direcciones IP de salida en la documentación de Azure Databricks.

Instalación de la aplicación Databricks Genie en Microsoft Teams

Un administrador de Microsoft 365 instala la aplicación Databricks Genie en Microsoft Teams desde el marketplace de Microsoft:

1. En el marketplace de Microsoft, busque y encuentre Databricks Genie.
2. Instale la aplicación.
3. Apruebe los permisos de la aplicación cuando se le solicite durante la instalación.

Para una lista de permisos requeridos, véase Permisos obligatorios de aplicación en Microsoft.

Después de la instalación, los usuarios pueden empezar a usar la aplicación.

Uso de la aplicación Databricks Genie en Microsoft Teams

Puede usar la aplicación Databricks Genie en Microsoft Teams a través de mensajes directos o conversaciones de canal en el área de trabajo de Microsoft Teams o desde Microsoft 365 Copilot.

Mensaje directo

Para enviar directamente un mensaje a la aplicación Databricks Genie en Microsoft Teams:

1. En Microsoft Teams, haga clic en Aplicaciones en la barra lateral izquierda y abra la aplicación Databricks Genie en Microsoft Teams.

2. Escriba su pregunta.

3. Si no has iniciado sesión, la aplicación Databricks Genie en Microsoft Teams te pide iniciar sesión:

   1. Haga clic en Configurar.
   2. Especifica la URL de tu espacio de trabajo. Para encontrar la URL de tu espacio de trabajo, consulta nombres de instancia, URLs e IDs del espacio de trabajo.
   3. Haz clic en Continuar para iniciar sesión en tu cuenta de Azure Databricks.

4. La pregunta se enruta al agente de Genie más adecuado y devuelve una respuesta con orígenes y indicaciones de seguimiento sugeridas.

Para iniciar una nueva conversación en un mensaje directo, envía newchat. Esto despeja el contexto actual de la conversación para que tu siguiente mensaje inicie una nueva conversación con el Genio. Tus mensajes existentes de Microsoft Teams no se eliminan.

Para configurar el espacio de trabajo y el alcance de Genie para todas las conversaciones de mensaje directo posteriores, abre la aplicación Genie de Databricks en la página principal de Microsoft Teams y ajusta la configuración.

Cargar archivos

En un mensaje directo, puedes adjuntar hasta cinco archivos PDF, Word o CSV de 20 MiB o menos a un mensaje, y Genie los utiliza como contexto cuando responde. La subida de archivos no está disponible en canales, chats grupales ni en Microsoft 365 Copilot.

Microsoft Teams almacena archivos que adjuntas en un chat en tu OneDrive para la Empresa, por lo que tu cuenta de Microsoft Teams debe tener OneDrive para la Empresa para subir archivos.

Para cargar archivos:

1. En un mensaje directo con la app Databricks Genie en Microsoft Teams, adjunta hasta cinco archivos a tu mensaje.
2. Opcionalmente, introduce una pregunta sobre los archivos.
3. Envíe el mensaje.

Si tu mensaje incluye una pregunta, Genie sube los archivos y luego responde a la pregunta usándolos. Si envía archivos sin una pregunta, Genie los carga y confirma cuando están listos. Luego puedes hacer preguntas sobre los archivos.

Los archivos subidos permanecen disponibles para preguntas de seguimiento en la conversación actual. Después de enviar newchat, adjunta los archivos de nuevo para usarlos en la nueva conversación.

Si adjuntas más de cinco archivos, Genie sube los primeros cinco y lista los archivos que se saltó. Si un archivo no puede subirse, Genie lo muestra junto con el motivo. Mientras al menos un archivo se suba, Genie sigue respondiendo a tu pregunta.

Si Genie responde que Azure Databricks no pudo autorizar la subida, pide a un administrador del espacio de trabajo que confirme que la vista previa de Genie One File Upload está habilitada para tu espacio de trabajo.

Guardar documentos en formato PDF

Cuando Genie redacta un documento por mensaje directo, la aplicación Databricks Genie en Microsoft Teams ofrece el documento en formato PDF en una tarjeta de archivo. Para aprender cómo pedirle a Genie que redacte un documento, consulta Documentos en Genie One.

Para guardar el PDF en tu OneDrive, haz clic en Permitir en la tarjeta del archivo. La app reemplaza la tarjeta por el PDF en el chat. Para descartar la oferta, haz clic en Rechazar.

Para guardar PDFs, necesitas OneDrive y la versión 1.0.17 y superior de la app Databricks Genie en Microsoft Teams. Si al hacer clic en Permitir se produce un error porque OneDrive está deshabilitado para la cuenta, abra el documento en Genie One en su lugar.

• El PDF lleva el nombre del título del documento.
• Si una respuesta incluye más de un documento, la app solo ofrece el primero.
• La oferta caduca 15 minutos después de que la app la publique. Si la entrega del PDF está ocupada o no puede comenzar, la tarjeta le pide que haga clic en Permitir de nuevo. Hazlo antes de que expire la oferta. Para obtener un PDF después de que expire la oferta, pide a Genie que genere el documento de nuevo.
• No se pueden guardar PDFs mayores a 20 MiB. Abre el documento en Genie One en su lugar.

Conversación del canal

Puede agregar la aplicación Databricks Genie en Microsoft Teams a un canal. Con config, los propietarios de canales pueden configurar las opciones de todos los miembros de un canal y los usuarios individuales pueden configurar las opciones personales. Las configuraciones del propietario del canal invalidan las configuraciones personales.

Para configurar la aplicación Databricks Genie en Microsoft Teams en un canal:

1. En el canal deseado, escriba @Databricks Genie.

2. Si se le solicita, agregue la aplicación Databricks Genie en Microsoft Teams al canal.

3. Escriba config.

4. Selecciona el espacio de trabajo conectado, la visibilidad del mensaje y el alcance de Genie (Genie One o un agente Genie específico).

   Si no hay ningún Genie Agent anclado, el canal usa Genie One de forma predeterminada.

5. Tras la configuración, todas las menciones @Databricks Genie en el canal se dirigen al agente y al espacio de trabajo configurados.

Visualizations

Cuando una respuesta de Genie incluye una visualización, el gráfico aparece como una imagen en la respuesta.

Las visualizaciones no se muestran cuando la visibilidad del mensaje está configurada como privada, porque los mensajes privados solo son visibles para el usuario que lo pidió.

Niveles de configuración y anulaciones

Ejecute config en un canal para abrir la ventana de configuración. Las siguientes opciones de configuración son configurables:

• Selección del área de trabajo: el área de trabajo de Azure Databricks al que se conecta la aplicación Databricks Genie de Microsoft Teams para responder preguntas.
• Visibilidad de mensajes: indica si @Databricks Genie las respuestas de los canales son visibles para todos los miembros del canal o solo para el usuario que solicitó. De forma predeterminada, las respuestas son públicas.
• Ámbito de Genie: Genie One o un agente específico de Genie. Ambos utilizan la API de Genie One; fijar a un Agente Genio específico indica que Genie Uno envíe la pregunta solo a ese agente, para obtener respuestas consistentes y específicas de cada caso.

La configuración de visibilidad de mensajes se puede establecer en tres niveles. Los niveles superiores invalidan los niveles inferiores:

Enrutamiento de datos

Genie procesa tus preguntas en tu espacio de trabajo y almacena el historial de conversaciones en la región de tu espacio de trabajo. Las peticiones entre Microsoft Teams y tu espacio de trabajo pasan a través de un servicio central de Azure Databricks en el plano de control de Azure Databricks. El servicio central funciona en la región East US 2, independientemente de la región de tu espacio de trabajo. El servicio central no persiste ni registra ningún contenido de las solicitudes ni contenido de las respuestas. Solo almacena el mapeo entre tu tenant de Microsoft Teams y tu espacio de trabajo de Azure Databricks.

Microsoft Teams necesita un punto final fijo para recibir solicitudes, por lo que la aplicación utiliza un servicio central.

Cuando haces una pregunta en Microsoft Teams:

1. Microsoft Teams envía tu pregunta al servicio central.
2. El servicio central reenvía la solicitud a tu espacio de trabajo de Azure Databricks.
3. Genie procesa la solicitud y genera una respuesta en tu espacio de trabajo.
4. La respuesta regresa a Microsoft Teams a través del servicio central.

Cuando guardas un documento como PDF, la app descarga el PDF desde tu espacio de trabajo y lo sube a tu OneDrive a través de East US 2. La app no almacena el PDF.

Donde se procesa el LLM

El servicio central enruta mensajes entre Microsoft Teams y tu espacio de trabajo. Genie en tu espacio de trabajo llama al modelo de lenguaje grande (LLM), por lo que la Geo de tu espacio de trabajo y su configuración de procesamiento entre regiones Geo determinan dónde procesa el LLM tu contenido. Por ejemplo, si tu espacio de trabajo está en la Geo de Europa y el procesamiento cruzado no está habilitado, el LLM procesa tu contenido en Europa. Consulte Servicios designados de Databricks.

Monitorizar el uso con registros de auditoría

Los administradores de cuentas y espacios de trabajo pueden usar la tabla del sistema de registros de auditoría (system.access.audit) para monitorizar el uso de Genie que proviene de Microsoft Teams. Cuando un usuario envía un mensaje a través de la aplicación Databricks Genie en Microsoft Teams, Genie One registra un createGenieChatResponse evento bajo el genieChat servicio, y el request_params.source campo se registra teams como origen. Esto permite distinguir las solicitudes de Microsoft Teams de las realizadas en la interfaz web de Azure Databricks (webapp) o a través de otras integraciones, como Slack (slack).

La siguiente consulta de ejemplo devuelve las solicitudes de Genie originadas por Microsoft Teams de los últimos 5 días, incluyendo al usuario que preguntó y el ID de la conversación:

SELECT
  event_time,
  user_identity.email AS user_email,
  request_params.conversation_id AS conversation_id
FROM system.access.audit
WHERE service_name = 'genieChat'
  AND action_name = 'createGenieChatResponse'
  AND request_params.source = 'teams'
  AND event_date >= date_add(current_date(), -5)
ORDER BY event_time DESC

Para el esquema de la tabla de registros de auditoría y más consultas de ejemplo, consulte la referencia de la tabla del sistema de registros de auditoría. Para la lista completa de eventos de chat de Genie One, véase Eventos de chat en Genie One.

Permisos de aplicación requeridos en Microsoft

Cuando instalas la aplicación Databricks Genie en Microsoft Teams, solicita los siguientes permisos. Los permisos de Entra ID son permisos de Microsoft Graph a nivel de inquilino que un administrador de Microsoft 365 consiente para tu organización. Los permisos específicos de recurso son permisos de consentimiento específico de recurso (RSC) de Teams que solo se aplican al chat, canal o equipo donde está instalada la aplicación.

Para obtener más información sobre estos permisos, consulte consentimiento específico de recursos y permisos de Microsoft Graph en la documentación de Microsoft.

Solución de problemas

Mensaje "Necesita aprobación del administrador" en el inicio de sesión

El siguiente mensaje "Necesita aprobación de administrador" aparece cuando inicia sesión en el área de trabajo de Azure Databricks porque el inquilino de Microsoft Entra está bloqueando el consentimiento del usuario para la aplicación Azure Databricks. Si no se concede el consentimiento del administrador, Microsoft Entra ID sigue bloqueando el flujo de inicio de sesión aunque tenga acceso directo al área de trabajo.

Para resolverlo, un usuario de Microsoft Entra con los roles de administrador adecuados debe conceder el consentimiento del administrador para todo el inquilino a la aplicación empresarial Azure Databricks.

Pida al administrador de Microsoft Entra que visite el vínculo siguiente. Reemplace {TENANT_ID} por el identificador del inquilino de Microsoft Entra:

https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Si se produce un error en el vínculo, el administrador puede conceder el consentimiento manualmente:

1. En el Centro de administración Microsoft Entra, vaya a Entra ID>Enterprise apps>Todas las aplicaciones y busque la aplicación empresarial Azure Databricks usada para el inicio de sesión único. Para identificar la aplicación, busque el identificador aaec40b0-c0ae-4211-a98b-6fc160abb71bde aplicación .
2. Conceda el consentimiento del administrador para los permisos solicitados por la aplicación empresarial de Azure Databricks:
   1. En Seguridad, haga clic en Permisos.
   2. Haga clic en Conceder consentimiento del administrador.

Para obtener instrucciones detalladas, consulte la documentación Microsoft.

Limitaciones

• No se puede especificar qué recurso de cómputo (almacén de SQL) utiliza la aplicación Databricks Genie en Microsoft Teams. Azure Databricks selecciona automáticamente una instancia de SQL Warehouse a la que el usuario está autorizado para acceder.
• Cuando un agente Genio específico es fijado como el alcance del Genio, el Genio Uno puede reescribir la pregunta antes de que llegue al agente fijado.
• Los comentarios (pulgar hacia arriba o hacia abajo) siempre se envían a Genie One, incluso cuando un Genie Agent específico está fijado.
• PrivateLink no se admite.
• La subida de archivos solo se permite en mensajes directos. En canales, chats grupales y Microsoft 365 Copilot, Genie no responde a un mensaje que incluya archivos adjuntos. En su lugar, responde que las subidas solo funcionan mediante un mensaje directo.
• La subida de archivos solo soporta archivos PDF, Word (.docx) y CSV de 20 MiB o menos, hasta cinco archivos por mensaje.
• Guardar documentos en formato PDF solo está disponible en mensajes directos. Genie no ofrece PDFs en canales, chats grupales ni Microsoft 365 Copilot. Se requieren OneDrive y la versión 1.0.17 y superior de la aplicación Databricks Genie en Microsoft Teams. No se pueden guardar PDFs mayores a 20 MiB.
• No se soporta activar acciones en Azure Databricks desde Teams.

Recursos adicionales

• Usar Genie One
• Chatear en Genie One
• Destinos de aplicación Genie de Slack y Microsoft Teams
• Para obtener soporte técnico, consulte el Centro de ayuda de Databricks.