Incorporare un agente Genie in un'app esterna

Incorporare un agente Genie come iframe in un sito Web o un'applicazione esterna in modo che gli utenti possano interagire con Genie all'interno degli strumenti o dei portali interni senza passare a Azure Databricks. Gli amministratori dell'area di lavoro configurano le superfici di incorporamento consentite; gli utenti incorporati possono inviare richieste, ma non possono modificare la configurazione dell'agente.

Note

Gli agenti genie erano in precedenza noti come Genie Spaces.

Requisiti

Prima di poter incorporare un agente Genie, è necessario che sia presente quanto segue:

• Amministratore dell'area di lavoro: deve configurare le superfici di incorporamento consentite nelle impostazioni di gestione degli accessi genie.
• Autore dell'agente: deve avere almeno l'autorizzazione CAN MANAGE per l'agente Genie.
• Utenti finali: deve avere accesso esplicito all'agente Genie e agli asset di dati sottostanti usati. Agli utenti che non hanno eseguito l'accesso a Azure Databricks viene richiesto di eseguire l'autenticazione prima di poter interagire con l'agente incorporato.

Note

Gli utenti dell'agente Genie incorporato possono inviare richieste, ma non possono modificare la configurazione dell'agente.

Passaggio 1: Configurare le superfici di incorporamento consentite

Un amministratore dell'area di lavoro deve configurare le superfici di incorporamento consentite prima di poter incorporare un agente Genie. Vedere Gestire il dashboard e l'incorporamento dell'agente Genie.

Passaggio 2: Generare il codice iframe

Dopo che un amministratore ha configurato le superfici consentite, gli autori dell'agente possono generare il codice di incorporamento iframe.

1. Apri l'agente Genie che desideri incorporare.
2. Fare clic su Condividi.
3. Nella finestra di dialogo Condividi fare clic su Incorpora spazio.
4. Copiare il codice iframe generato.

Passaggio 3: Aggiungere l'iframe all'applicazione

Incollare il codice iframe nel sito Web o nell'applicazione esterna.

Per abilitare la funzionalità completa, inclusa la copia di dati CSV e la copia dei collegamenti di conversazione, aggiungere l'attributo allow="clipboard-write" all'elemento iframe:

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

Procedure consigliate

• Concedere l'accesso esplicito ai dati: assicurarsi che gli utenti finali abbiano accesso sia all'agente Genie che a tutti gli asset di dati sottostanti usati dall'agente. Gli utenti visualizzano solo i dati a cui hanno l'autorizzazione per accedere.
• Abilitare l'accesso agli Appunti: includere allow="clipboard-write" nell'elemento iframe in modo che gli utenti possano copiare i risultati della query e i collegamenti di conversazione.
• Limitare le superfici consentite: aggiungere domini solo all'elenco di superfici di incorporamento consentite che si considera attendibile e controllato.