Incorpore um Genie Agent em um aplicativo externo

Incorpore um Genie Agent como um iframe em um site ou aplicativo externo para que os usuários possam interagir com o Genie em suas ferramentas ou portais internos sem navegar para o Databricks. Os 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 agente.

nota

Genie Agents eram anteriormente conhecidos como Genie Spaces.

Requisitos

Antes que você possa incorporar um Genie Agent, o seguinte deve estar em vigor:

• **Administrador do Workspace**: Deve configurar as superfícies de incorporação permitidas nas configurações de gerenciamento de acesso do Genie.
• Autor do agente : Deve ter pelo menos a permissão CAN MANAGE no Genie Agent.
• Usuários finais : Devem ter acesso explícito ao Genie Agent e aos ativos de dados subjacentes que ele usa. Usuários que não estão logados no Databricks são solicitados a autenticar antes que possam interagir com o agente incorporado.

nota

Usuários de Genie Agent incorporados podem enviar prompts, mas não podem editar a configuração do agente.

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

Um administrador do Workspace deve configurar as superfícies de incorporação permitidas antes que um Genie Agent possa ser incorporado. Consulte Gerenciar a incorporação de dashboards e Genie Agent.

Etapa 2: Gerar o código do iframe

Depois que um administrador configurar as superfícies permitidas, os autores de agentes podem gerar o código de incorporação de iframe.

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

Passo 3: Adicionar o iframe à sua aplicação

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

Para habilitar a funcionalidade completa, incluindo a cópia de dados CSV e a cópia de 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>

Práticas recomendadas

• Conceda Acesso Explícito a Dados : certifique-se de que os usuários finais tenham acesso tanto ao Genie Agent quanto a todos os ativos de dados subjacentes usados pelo agente. Os usuários só veem os dados aos quais têm permissão para acessar.
• **Habilitar acesso à área de transferência**: inclua allow="clipboard-write" no elemento iframe para que os usuários possam copiar resultados de query e links de conversa.
• Limitar superfícies permitidas : Adicione apenas domínios à lista de superfícies de incorporação permitidas em que você confia e controla.