Gerir o painel de controlo e a incorporação do Genie Agent

Esta página mostra como os administradores da área de trabalho podem gerir as opções de incorporação para dashboards de IA/BI e os Agentes Genie.

Que tipos de incorporação você pode fazer?

Pode incorporar de forma segura dashboards e Agentes Genie em sites e aplicações externas.

Embedding de dashboards

Você pode incorporar painéis das seguintes maneiras:

• Incorporação básica de Databricks: Os autores do painel podem gerar código de incorporação iframe usando o diálogo Compartilhar. Os administradores de espaço de trabalho podem gerenciar quais domínios, se houver, são aprovados para hospedar um painel incorporado. A incorporação do painel requer que os usuários tenham cookies de terceiros ativados. Os administradores do espaço de trabalho devem habilitar a incorporação no espaço de trabalho e definir a lista de domínios qualificados. Consulte Integração básica do dashboard.

• Embedding para utilizadores externos: (Pré-visualização pública) Pode configurar uma aplicação externa para autenticar a Azure Databricks com um principal de serviço e aceder a um dashboard. Os usuários que podem acessar seu aplicativo externo podem acessar o painel. Opcionalmente, você pode filtrar os dados apresentados no painel com base no usuário que está acessando-o. Os administradores do espaço de trabalho devem configurar a aplicação externa para utilizar o principal de serviço e os tokens OAuth necessários à autenticação. Consulte O que é incorporação para usuários externos?.

Para saber mais sobre as opções disponíveis de embedding de dashboards, consulte Embed a dashboard.

Incorporação do Genie Agent

• Incorporação por iframe do Genie Agent: Os autores do Genie Agent podem gerar código de incorporação em iframe na caixa de diálogo Partilhar. Os utilizadores que têm acesso à aplicação de embedding podem enviar prompts e visualizar resultados sem alterar a configuração do espaço. Os administradores de workspace devem definir as superfícies permitidas para incorporação antes de os autores poderem partilhar um Agente Genie desta forma. Veja Incorporar um agente Genie numa aplicação externa e Controle os destinos de incorporação permitidos.

Controlar destinos de incorporação permitidos

Incorporar um dashboard ou Genie Agent requer que o site externo seja explicitamente permitido. Para adicionar destinos de incorporação permitidos ao seu espaço de trabalho:

1. Clique no seu nome de utilizador na barra superior do espaço de trabalho Azure Databricks e selecione Settings.

2. Clique em Segurança .

3. Role para baixo até a seção Acesso externo .

4. Na secção Incorporar dashboards, use o menu suspenso para definir a política de incorporação do seu espaço de trabalho. Esta definição aplica-se tanto aos dashboards como aos Agentes Génio.

   Existem três opções políticas:

   • Permitir: Os painéis e os Agentes Genie podem ser incorporados em qualquer domínio.
   • Permitir domínios aprovados: Dashboards e Agentes Genie só podem ser incorporados em sites que correspondam à lista aprovada.
   • Recusar: Os painéis e os agentes Genie não podem ser incorporados em qualquer domínio.

Se você selecionar Permitir domínios aprovados, use as seguintes instruções para gerenciar sua lista de domínios aprovados:

1. Clique em Gerenciar ao lado de Incorporar Painéis.
2. Digite um domínio no campo de texto da caixa de diálogo Domínio aprovado . Clique em Adicionar domínio após cada entrada.
3. Clique em Salvar.

Dicas para definir domínios e rotas aprovados

Para especificar hosts permitidos, use a gramática definida na documentação da Política de Segurança de Conteúdo do W3C. Os exemplos nesta seção ilustram alguns padrões comuns.

Permitir subdomínios

Para permitir todos os subdomínios de um determinado domínio, use um símbolo curinga (*) antes do nome de domínio. Os exemplos a seguir usam *.databricks.com como um domínio de exemplo.

• Jogos: Qualquer subdomínio
  • some.databricks.com
  • app.databricks.com
  • anything.databricks.com
• Não corresponde: Qualquer coisa que tenha um domínio diferente.
  • another-databricks.com
  • app-databricks.com

Próximos passos

• Configurar incorporação básica: configure a incorporação para usuários com contas Databricks que podem entrar diretamente para exibir painéis. Consulte Integração básica do dashboard.
• Configurar incorporação para utilizadores externos: configure a incorporação para utilizadores externos para permitir que utilizadores sem contas Databricks acedam a painéis através da autenticação por principal de serviço. Consulte O que é incorporação para usuários externos?.
• Incorpore um Agente Génio: Aprenda como os autores do Space podem gerar código de embed iframe e adicioná-lo a uma aplicação externa. Veja Incorporar um Agente Génio numa aplicação externa.
• Criar e publicar painéis: saiba como criar, configurar e publicar painéis de IA/BI para incorporação. Consulte Dashboards.
• Gerenciar configurações de segurança do espaço de trabalho: defina configurações de segurança adicionais e controles de acesso para seu espaço de trabalho. Consulte Gerenciar seu espaço de trabalho.