Incorporar um Agente Genie numa aplicação externa

Incorpore um Genie Agent como iframe num site ou aplicação externa para que os utilizadores possam interagir com o Genie dentro das suas ferramentas ou portais internos sem terem de navegar para o Azure Databricks. Os administradores do espaço de trabalho configuram superfícies de embedding permitidas; Os utilizadores incorporados podem enviar prompts, mas não podem editar a configuração do agente.

Requirements

Antes de poder incorporar um Agente Génio, o seguinte deve estar em funcionamento:

• Administrador do espaço de trabalho: Deve configurar superfícies de incorporação permitidas nas definições de gestão de acesso do Genie.
• Autor do Agente: Deve ter pelo menos permissão PODE GERIR sobre o Agente Génio.
• Utilizadores finais: Devem ter acesso explícito ao Agente Genie e aos ativos de dados subjacentes que utiliza. Os utilizadores que não têm sessão iniciada no Azure Databricks são solicitados a autenticar-se antes de poderem interagir com o agente incorporado.

Passo 1: Configurar superfícies de embedding permitidas

Um administrador da área de trabalho tem de configurar as superfícies de incorporação permitidas antes de o Agente Genie poder ser incorporado. Consulte Gerir o dashboard e a incorporação do Genie Agent.

Passo 2: Gerar o código iframe

Depois de um administrador ter configurado superfícies permitidas, os autores dos agentes podem gerar o código de incorporação do iframe.

1. Abre o Agente Génio que queres incorporar.
2. Clique em Share (Partilhar).
3. No diálogo de partilha, clique em Incorporar espaço.
4. Copia o código iframe gerado.

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

Cole o código iframe no seu site ou aplicação externa.

Para permitir funcionalidades completas, 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>

Melhores práticas

• Conceder acesso explícito aos dados: Certifique-se de que os utilizadores finais têm acesso tanto ao Agente Genie como a todos os ativos de dados subjacentes usados pelo agente. Os utilizadores só veem os dados a que têm permissão para aceder.
• Ativar o acesso à área de transferências: Incluir allow="clipboard-write" no elemento iframe para que os utilizadores possam copiar resultados de consultas e links de conversa.
• Limitar superfícies permitidas: Adicionar apenas domínios à lista de superfícies de embedding permitidas que confie e controle.