Bädda in en Genie-agent i en extern app

Bädda in en Genie-agent som en iframe på en extern webbplats eller ett program så att användarna kan interagera med Genie i dina interna verktyg eller portaler utan att gå till Azure Databricks. Arbetsyteadministratörer konfigurerar tillåtna inbäddningsytor. inbäddade användare kan skicka frågor men kan inte redigera agentkonfigurationen.

Note

Genie Agents kallades tidigare Genie Spaces.

Requirements

Innan du kan bädda in en Genie-agent måste följande vara på plats:

  • Arbetsyteadministratör: Måste konfigurera tillåtna inbäddningsytor i inställningarna för Genie-åtkomsthantering.
  • Agentredigerare: Du måste ha minst behörigheten CAN MANAGE för Genie Agent.
  • Slutanvändare: Måste ha explicit åtkomst till Genie-agenten och de underliggande datatillgångar som används. Användare som inte är inloggade på Azure Databricks uppmanas att autentisera innan de kan interagera med den inbäddade agenten.

Note

Inbäddade Genie Agent-användare kan skicka frågor men kan inte redigera agentkonfigurationen.

Steg 1: Konfigurera tillåtna inbäddningsytor

En arbetsyteadministratör måste konfigurera tillåtna inbäddningsytor innan en Genie-agent kan bäddas in. Se Hantera inbäddning av instrumentpanel och Genie Agent.

Steg 2: Generera iframe-koden

När en administratör har konfigurerat tillåtna ytor kan agentförfattare generera inbäddningskoden för iframe.

  1. Öppna den Genie Agent som du vill bädda in.
  2. Klicka på Dela.
  3. I dialogrutan Dela klickar du på Bädda in utrymme.
  4. Kopiera den genererade iframe-koden.

Steg 3: Lägg till iframe i ditt program

Klistra in iframe-koden på din externa webbplats eller ditt program.

Om du vill aktivera fullständiga funktioner, inklusive att kopiera CSV-data och kopiera konversationslänkar, lägger du till allow="clipboard-write" attributet i iframe-elementet:

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

Bästa praxis

  • Bevilja explicit dataåtkomst: Kontrollera att slutanvändarna har åtkomst till både Genie-agenten och alla underliggande datatillgångar som används av agenten. Användarna ser bara data som de har behörighet att komma åt.
  • Aktivera Åtkomst till Urklipp: Inkludera allow="clipboard-write" i iframe-elementet så att användarna kan kopiera frågeresultat och konversationslänkar.
  • Begränsa tillåtna ytor: Lägg bara till domäner i listan över tillåtna inbäddningsytor som du litar på och kontrollerar.
  • Last updated on