Een Genie-agent insluiten in een externe app

Sluit een Genie Agent in als een iframe in een externe website of toepassing, zodat gebruikers kunnen communiceren met Genie binnen uw interne hulpprogramma's of portals zonder naar Azure Databricks te navigeren. Werkruimtebeheerders configureren toegestane insluitingsoppervlakken; ingesloten gebruikers kunnen prompts verzenden, maar de agentconfiguratie kan niet worden bewerkt.

Opmerking

Genie Agenten werden voorheen Genie Spaces genoemd.

Requirements

Voordat u een Genie Agent kunt insluiten, moet het volgende aanwezig zijn:

• Werkruimtebeheerder: moet toegestane insluitingsoppervlakken configureren in de instellingen voor toegangsbeheer van Genie.
• Agentauteur: moet ten minste de machtiging CAN MANAGE hebben op de Genie Agent.
• Eindgebruikers: Moeten expliciete toegang hebben tot de Genie-agent en de onderliggende databronnen die deze gebruikt. Gebruikers die niet zijn aangemeld bij Azure Databricks worden gevraagd zich te verifiëren voordat ze kunnen communiceren met de ingesloten agent.

Opmerking

Ingesloten Genie Agent-gebruikers kunnen prompts verzenden, maar kunnen de configuratie van de agent niet bewerken.

Stap 1: Toegestane insluitingsoppervlakken configureren

Een werkruimtebeheerder moet toegestane insluitingsoppervlakken configureren voordat een Genie-agent kan worden ingesloten. Zie Dashboard beheren en Genie Agent insluiten.

Stap 2: De iframe-code genereren

Nadat een beheerder toegestane oppervlakken heeft geconfigureerd, kunnen agentontwikkelaars de iframe-insluitcode genereren.

1. Open de Genie-agent die u wilt insluiten.
2. Klik op Delen.
3. Klik in het dialoogvenster Delen op Ruimte invoegen.
4. Kopieer de gegenereerde iframecode.

Stap 3: Het iframe toevoegen aan uw toepassing

Plak de iframe-code in uw externe website of toepassing.

Als u volledige functionaliteit wilt inschakelen, waaronder het kopiëren van CSV-gegevens en het kopiëren van gesprekskoppelingen, voegt u het allow="clipboard-write" kenmerk toe aan het iframe-element:

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

Beste praktijken

• Expliciete gegevenstoegang verlenen: zorg ervoor dat eindgebruikers toegang hebben tot zowel de Genie-agent als alle onderliggende gegevensassets die door de agent worden gebruikt. Gebruikers zien alleen gegevens die ze mogen openen.
• Klembordtoegang inschakelen: opnemen allow="clipboard-write" in het iframe-element, zodat gebruikers queryresultaten en gesprekskoppelingen kunnen kopiëren.
• Toegestane oppervlakken beperken: voeg alleen domeinen toe aan de lijst met toegestane insluitingsoppervlakken die u vertrouwt en beheert.