Inserción de un agente de Genie en una aplicación externa

Inserte un agente de Genie como iframe en un sitio web externo o una aplicación para que los usuarios puedan interactuar con Genie dentro de sus herramientas o portales internos sin navegar a Azure Databricks. Los administradores del área de trabajo configuran superficies de inserción permitidas; Los usuarios insertados pueden enviar mensajes, pero no pueden editar la configuración del agente.

Requisitos

Para poder insertar un agente de Genie, debe estar en vigor lo siguiente:

• Administrador del espacio de trabajo: debe configurar las superficies de inserción permitidas en la configuración de administración de acceso de Genie.
• Creador del agente: Debe tener al menos el permiso CAN MANAGE en el agente de Genie.
• Usuarios finales: debe tener acceso explícito al Agente de Genie y a los recursos de datos subyacentes que usa. A los usuarios que no han iniciado sesión en Azure Databricks se les pedirá que se autentiquen antes de poder interactuar con el agente insertado.

Paso 1: Configurar superficies de inserción permitidas

Un administrador del área de trabajo debe configurar las superficies de inserción permitidas antes de que se pueda insertar un agente de Genie. Consulte Gestión del panel e integración del agente Genie.

Paso 2: Generación del código de iframe

Una vez que un administrador ha configurado las superficies autorizadas, los autores de agentes pueden generar el código de inserción del iframe.

1. Abra el agente de Genie que desea insertar.
2. Haga clic en Compartir.
3. En el cuadro de diálogo Compartir, haga clic en Insertar espacio.
4. Copie el código iframe generado.

Paso 3: Agregar el iframe a la aplicación

Pegue el código de iframe en su sitio web o aplicación externo.

Para habilitar la funcionalidad completa, incluida la copia de datos CSV y la copia de vínculos de conversación, agregue el allow="clipboard-write" atributo al elemento iframe:

<iframe src="<your-genie-space-url>" allow="clipboard-write" width="100%" height="600"></iframe>

procedimientos recomendados

• Conceder acceso explícito a los datos: asegúrese de que los usuarios finales tengan acceso tanto al agente de Genie como a todos los recursos de datos subyacentes utilizados por el agente. Los usuarios solo ven los datos a los que tienen permiso para acceder.
• Habilitar el acceso al Portapapeles: incluya allow="clipboard-write" en el elemento iframe para que los usuarios puedan copiar los resultados de la consulta y los vínculos de conversación.
• Límite de superficies permitidas: agregue solo dominios a la lista de superficies de inserción permitidas que confíe y controle.