Inserir um espaço do Genie

Importante

Esse recurso está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Visualizações . Consulte Gerenciar versões de pré-visualização do Azure Databricks.

Você pode inserir um Genie Space como um iframe em um site ou aplicativo externo. Isso permite que os usuários empresariais interajam com o Genie diretamente em suas ferramentas internas ou portais sem navegar para Azure Databricks.

Requisitos

Antes de inserir um Genie Space, o seguinte deve estar em vigor:

  • Administrador do workspace: deve configurar superfícies de inserção permitidas nas configurações de gerenciamento de acesso do 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 ativos de dados subjacentes que ele usa. Os usuários que não estão conectados ao Azure Databricks são solicitados a autenticar antes que possam interagir com o espaço inserido.

Observação

Os usuários do Genie Space inseridos podem enviar prompts, mas não podem editar a configuração de espaço.

Etapa 1: Habilitar a visualização do recurso

Um administrador do espaço de trabalho deve habilitar a incorporação do Genie como um iframe na página de Pré-visualizações antes que o recurso esteja disponível no espaço de trabalho.

Etapa 2: Configurar superfícies de inserção permitidas

Um administrador de workspace deve configurar superfícies de inserção permitidas antes que um Genie Space possa ser inserido. Consulte Gerenciamento do painel e incorporação do Genie Space.

Etapa 3: Gerar o código iframe

Depois que um administrador tiver configurado superfícies permitidas, os criadores de espaço poderão gerar o código de inserção iframe.

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

Etapa 4: Adicionar o iframe ao seu aplicativo

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

Para habilitar a funcionalidade completa, incluindo copiar dados CSV e copiar links de conversa, adicione o allow="clipboard-write" atributo ao elemento iframe:

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

Práticas recomendadas

  • Conceder acesso explícito a dados: verifique se os usuários finais têm acesso ao Genie Space e a todos os ativos de dados subjacentes usados pelo espaço. Os usuários só veem dados que têm permissão para acessar.
  • Habilitar acesso à área de transferência: Incluir no elemento iframe para que os usuários possam copiar os resultados das consultas e os links das conversas.
  • Limite as superfícies permitidas: adicione apenas domínios à lista de superfícies de inserção permitidas que você confia e controla.
  • Last updated on