Inserir um agente do Genie em um aplicativo externo

Insira um Agente do 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 navegar para Azure Databricks. Os administradores do workspace configuram superfícies de inserção permitidas; Os usuários inseridos podem enviar prompts, mas não podem editar a configuração do agente.

Requirements

Antes de inserir um Agente do Genie, 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 agente: deve ter pelo menos a permissão CAN MANAGE no Genie Agent.
• Usuários finais: devem ter acesso explícito ao Agente do Genie 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 agente inserido.

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

Um administrador de workspace deve configurar superfícies de inserção permitidas antes que um agente do Genie possa ser inserido. Consulte Gerenciar dashboard e incorporação do Genie Agent.

Etapa 2: gerar o código iframe

Depois de um administrador configurar as superfícies autorizadas, os criadores do agente poderão gerar o código de incorporação em iframe.

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

Etapa 3: 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 a dados explícitos: verifique se os usuários finais têm acesso ao Agente Genie e a todos os ativos de dados subjacentes usados pelo agente. 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.