Incorporar um Genie Space em um aplicativo externo

Incorpore um espaço Genie como um iframe em um site ou aplicativo externo para que os usuários possam interagir com o Genie dentro de suas ferramentas ou portais internos sem precisar navegar até o Databricks. Administradores de workspace configuram as superfícies de incorporação permitidas; usuários incorporados podem enviar prompts, mas não podem editar a configuração do espaço.

Requisitos

Antes de poder incorporar um Genie Space, os seguintes requisitos devem ser atendidos:

• Administrador do espaço de trabalho : É necessário configurar as superfícies de incorporação permitidas nas configurações de gerenciamento de acesso Genie .
• Autor do espaço : Deve ter pelo menos a permissão CAN MANAGE no Genie Space.
• Usuários finais : Devem ter acesso explícito ao Genie Space e aos dados subjacentes que ele utiliza. Os usuários que não estiverem conectados ao Databricks serão solicitados a se autenticarem antes de poderem interagir com o espaço incorporado.

nota

Os usuários do Genie Space integrado podem enviar solicitações, mas não podem editar a configuração do espaço.

Etapa 1: Configurar superfícies de incorporação permitidas

O administrador workspace deve configurar as superfícies de incorporação permitidas antes que um Genie Space possa ser incorporado. Veja o painel de gerenciamento e a incorporação Genie Space.

Etapa 2: Gerar o código do iframe

Após um administrador configurar as superfícies permitidas, os autores do espaço podem gerar o código de incorporação do iframe.

1. Abra o Genie Space que você deseja incorporar.
2. Clique em Compartilhar .
3. Na caixa de diálogo Compartilhar, clique em Incorporar espaço .
4. Copie o código iframe gerado.

Passo 3: adicionar o iframe ao seu aplicativo

Cole o código iframe no seu site ou aplicativo externo.

Para habilitar todas as funcionalidades, incluindo a cópia de dados CSV e links de conversas, adicione o atributo allow="clipboard-write" ao elemento iframe:

Html

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

Ao acessar um Genie Space por meio de um iframe, o limite de taxa é de 20 perguntas por minuto por workspace em todos os Genie Spaces.

Melhores práticas

• Conceda acesso explícito aos dados : Certifique-se de que os usuários finais tenham acesso tanto ao Genie Space quanto a todos os dados subjacentes utilizados pelo espaço. Os usuários visualizam apenas os dados aos quais têm permissão de acesso.
• Habilitar acesso à área de transferência : Inclua allow="clipboard-write" no elemento iframe para que os usuários possam copiar os resultados da pesquisa e os links da conversa.
• Limitar superfícies permitidas : Adicione à lista de superfícies de incorporação permitidas apenas domínios nos quais você confia e controla.