Tilføj Fabric-dataagenter til en Foundry-agent med Fabric IQ (forhåndsvisning)

En Fabric-dataagent besvarer spørgsmål om data, der er lagret i Microsoft Fabric OneLake. En agent indbygget i Microsoft Foundry kan kalde en Fabric-dataagent, når den har brug for svar baseret på virksomhedsdata i OneLake.

Denne artikel viser dig, hvordan du tilføjer en Fabric-dataagent til en Foundry-agent ved at bruge Fabric IQ (OneLake Catalog)-værktøjet. Hvert trin sker i Microsoft Foundry-portalen. Du kan også gøre det samme i kode, som beskrevet i Add a data agent ved at bruge kode senere i denne artikel.

Vigtigt!

Når en Foundry-agent kalder en Fabric-dataagent, kan de svar, som dataagenten returnerer, sendes uden for Fabric-overholdelsesgrænsen eller geografiske område. Disse svar behandles og gemmes derefter i henhold til Microsoft Foundrys vilkår og datahåndteringspolitikker.

Hvad denne integration giver dig

Fabric IQ er den del af Microsoft Fabric, der gør dine data tilgængelige for agenter og applikationer. En offentliggjort Fabric-dataagent er en af de ting, som Fabric IQ afslører, og du tilføjer den til en Foundry-agent gennem OneLake-kataloget.

Denne metode adskiller sig fra den tidligere på tre måder:

  • Du vælger dataagenter fra en liste. I Foundry-portalen viser OneLake-kataloget de offentliggjorte dataagenter, du har adgang til, ved navn. Du behøver ikke slå et arbejdsområde-ID eller et artefakt-ID op først.
  • Du kan tilføje mere end én dataagent. En enkelt Foundry-agent kan ringe til flere dataagenter, så den kan trække på mere end ét område af dine forretningsdata. Den tidligere metode tillod kun én.
  • Hver dataagent eksponeres som et Model Context Protocol-endpoint. Model Context Protocol er en åben standard for, hvordan en agent kalder et værktøj. Dine Fabric-dataagenter fremstår for Foundry-agenten som værktøjer, den kan kalde, på samme måde som den kalder ethvert andet værktøj.

For den tidligere metode, som forbinder en enkelt dataagent via arbejdsområde-ID og artefakt-ID, se Consume a data agent i Microsoft Foundry.

Forudsætninger

  • En betalt F2 eller højere Fabric-kapacitet, eller en Power BI Premium per kapacitet (P1 eller højere) kapacitet med Microsoft Fabric aktiveret.
  • Et arbejdsområde i et område, der understøtter hele Fabric-stakken. Fabric IQ er ikke tilgængeligt i regioner, hvor Power BI er den eneste Fabric-arbejdsbyrde. Du kan få flere oplysninger under Tilgængelighed af fabric-område.
  • Cross-geo behandling og cross-geo lagring for AI er slået til, baseret på kravene beskrevet i Fabric data agent tenant settings.
  • Mindst én af disse datakilder, med data: et lager, et søhus, en Power BI-semantisk model, en KQL-database eller en spejlet database. Du skal have læseadgang til datakilden.
  • Et Foundry-projekt med en model allerede implementeret. For at oprette et, se Opret et projekt.

Inden du går i gang

Tjek følgende elementer, før du tilføjer en Fabric data agent til en Foundry-agent:

  • Dataagenten virker. Bekræft, at dataagenten besvarer spørgsmål som forventet i Fabric.
  • Dataagenten er offentliggjort. Kun offentliggjorte Fabric-dataagenter optræder i OneLake-kataloget. For at oprette og publicere en, se Opret en Fabric-dataagent.
  • Begge agenter er i samme lejemål. Fabric-dataagenten og Foundry-agenten skal være i samme lejemål.
  • Du bruger den samme konto. Log ind på Microsoft Fabric og Microsoft Foundry med samme konto.
  • Du har de rette tilladelser. Du skal mindst have læseadgang til Fabric-dataagenten, læseadgang til dens underliggende datakilder og tilladelse til at oprette og ændre agenter i dit Foundry-projekt. For mere information om dataagent-tilladelser, se Fabric data agent sharing and permissions management.

Roller i Microsoft Foundry

Microsoft Foundry bruger rollebaseret adgangskontrol. Følgende tabel viser den rolle, du har brug for til hver opgave. For mere information, se Rollebaseret adgangskontrol for Microsoft Foundry.

Det vil du foretage dig Den rolle, du har brug for.
Opret et Foundry-projekt Foundry Account Owner eller Foundry Owner, eller rollen som Azure Owner eller Contributor
Byg og test en agent i et projekt Foundry User
Skab forbindelsen til Fabric IQ Foundry Project Manager

Bemærkning

Hvis dit projekt allerede eksisterer, er Foundry User nok til at bygge og teste en agent i det. Tildel Foundry User til din egen konto, til agentens runtime-identitet og til enhver brugeridentitet, der deltager i en login-flow.

Sådan fungerer det

  1. En bruger stiller din Foundry-agent et spørgsmål.
  2. Foundry-agenten beslutter, om en af dens Fabric-dataagenter kan besvare det spørgsmål. De instruktioner, du skriver, styrer denne beslutning.
  3. Foundry-agenten kalder Fabric-dataagenten.
  4. Dataagenten forespørger sine datakilder i Fabric OneLake og returnerer et svar.
  5. Foundry-agenten bruger det svar til at svare brugeren.

Forespørgsler kører under den identitet, der er konfigureret til forbindelsen. For en Fabric-dataagent bruger forbindelsen delegeret brugerautentificering, så anmodningen kører som den loggede bruger, og Fabric anvender brugerens rettigheder. En bruger modtager kun resultater fra data, som brugeren har adgang til.

Bemærkning

Den model, du vælger til din Foundry-agent, bruges til at orkestrere Foundry-agenten og skrive dens svar. Det ændrer ikke den model, som Fabric-dataagenten bruger internt.

Trin 1: Opret en Foundry-agent

Hvis du allerede har en agent, så åbn den og gå til trin 2.

  1. Log ind på Microsoft Foundry-portalen og vælg dit projekt. Du lander på startsiden .

    Skærmbillede af forsiden i Microsoft Foundry-portalen med fanen Byg i den øverste navigation.

  2. I den øverste navigation vælger du Build, som viser alle agenterne i dit projekt.

    Skærmbillede af fanen Byg i Microsoft Foundry-portalen med agenter valgt i venstre panel og listen over agenter i midten.

  3. Vælg pilen ved siden af Ny agent, og vælg derefter Byg en agent.

    Skærmbillede af agent-siden i Microsoft Foundry-portalen med menuen Ny agent åben og 'Byg en agent' opført.

  4. I dialogen Opret en agent indtaster du et agentnavn , der beskriver, hvad agenten gør, og vælger derefter Oprette.

    Skærmbillede af dialogen Opret en agent i Microsoft Foundry-portalen med Agent-navneboksen.

Tip

Du kan også starte fra kortet 'Byg en agent' på forsiden . Vælg Start bygning for at gå til det samme sted.

Din nye agent åbner i fanen Playground . Panelet til venstre er der, hvor du konfigurerer agenten, med sektioner for Model, Instruktioner, Værktøjer, Viden og mere. Panelet til højre er chatten, hvor du tester det. Resten af trinene i denne artikel foregår på denne fane.

Trin 2: Tilføj værktøjet Fabric IQ (OneLake Catalog)

  1. I Værktøjssektionen vælger du Tilføj og derefter vælg Gennemse alle værktøjer.
  2. I menuen Vælg et værktøj, vælg under fanen KonfigureretFabric IQ (OneLake Catalog).
  3. Vælg Tilføj værktøj.

Skærmbillede af dialogen Vælg et værktøj i Microsoft Foundry-portalen med Fabric IQ (OneLake Catalog)-værktøjet angivet.

OneLake-kataloget åbner.

Trin 3: Filtrer kataloget for dataagenter

OneLake-kataloget lister flere slags Fabric-produkter, så indsnævr det først.

  1. Vælg Filter.
  2. Under Type, vælg Dataagent.

Skærmbillede af OneLake-kataloget i Microsoft Foundry-portalen med filtermenuen åben og dataagenten angivet under Type.

Listen viser nu kun offentliggjorte Fabric-dataagenter. For hver af dem ser du dens Navn, dens Placering (arbejdsområdet, der indeholder den), dens Godkendelse og dens Følsomhedsmærke . For at indsnævre listen yderligere, indtast en del af et navn i Filter efter nøgleord.

To regler bestemmer, hvad du ser på denne liste:

  • Dataagenten skal være offentliggjort. Dataagenter, der stadig er i udkast, dukker ikke op.
  • Du skal have adgang til dataagenten. Hvis en kollega har bygget en og ikke delte den med dig, er den ikke på din liste.

Trin 4: Tilføj en dataagent

  1. I den filtrerede liste skal du vælge den Fabric-dataagent, du ønsker, at din Foundry-agent skal bruge.
  2. Vælg Tilføj.

Dataagenten vises nu i Tools-sektionen i din Foundry-agent, opført som Fabric IQ med navnet på dataagenten i parentes.

Skærmbillede af en Foundry-agent under fanen Playground, med en Fabric-dataagent opført i Tools-sektionen.

Trin 5: Tilføj flere dataagenter

Du tilføjer dataagenter én ad gangen. For at tilføje endnu en, gentag trin 2 til trin 4. Åbn OneLake-kataloget igen fra Tools-sektionen og vælg den næste dataagent. Hver enkelt optræder som en separat post i listen over værktøjer.

Tilføj en dataagent for hvert område af din virksomhed, som Foundry-agenten skal dække. For eksempel kan én agent have salgsdata, en anden kan have data fra forsyningskæden, og en tredje kan have kundesupportdata. Din Foundry-agent vælger derefter den rigtige til hvert spørgsmål.

Trin 6: Skriv instruktioner til din agent

Din Foundry-agent skal vide, hvornår hver dataagent skal bruges. Skriv den vejledning i afsnittet Instruktioner .

Vær specifik. Nævn hver dataagent og sig, hvilke slags spørgsmål den skal håndtere. Eksempel:

Brug Contoso Sales dataagent til spørgsmål om omsætning, ordrer og produkter. Brug Contoso Support Data Agent til spørgsmål om supportsager og kundeklager. Hvis et spørgsmål kræver begge dele, så ring til begge og kombiner resultaterne.

Uden klare instruktioner kan agenten slet ikke ringe til en dataagent, eller den kan ringe til den forkerte.

Trin 7: Tilføj andre værktøjer og videnskilder

Dette trin er valgfrit. Sammen med dine Fabric-dataagenter kan du tilføje andre værktøjer i Tools-sektionen og videnskilder i Knowledge-sektionen for samme agent. Tilføj alt andet, agenten har brug for for at gøre sit arbejde.

Trin 8: Gem din agent

Vælg Gem i øverste højre hjørne.

Vigtigt!

Du skal redde din agent. Indtil du gemmer, beholder Foundry ikke de dataagenter, du har tilføjet, instruktionerne du har skrevet, eller nogen anden ændring, du har foretaget i de foregående trin.

Trin 9: Test din agent

Brug chatpanelet i højre side af fanen Playground til at teste agenten.

  1. Send et spørgsmål, som en af dine dataagenter bør besvare, for eksempel Hvad var vores bedst sælgende produkt sidste måned?
  2. Tjek svaret. Bekræft, at den bruger de data, du forventer, og at den kommer fra den dataagent, du havde tænkt dig.

Test hver dataagent, du har tilføjet, med mindst ét spørgsmål, og test et spørgsmål, der kræver mere end ét af dem. Hvis agenten ikke kalder en dataagent, så revider instruktionerne, du skrev i trin 6, gem og test igen.

For at se, hvad dataagenten gjorde på hver forespørgsel, inklusive hvilke datakilder den forespurgte, og hvor lang tid hvert trin tog, se Observability for Fabric data agents i Microsoft Foundry.

Langvarige spørgsmål

Nogle spørgsmål tager længere tid for en dataagent at besvare, end et standardværktøjskald tillader. For at lade de opkald blive færdige:

  1. I modellisten skal du vælge en model, der understøtter baggrundstilstand, såsom gpt-5.4 eller gpt-5.5.
  2. Vælg parameterikonet ved siden af modellen, og slå Baggrundstilstand til.

Agenten viser derefter sin fremgang, mens dataagenten arbejder, og returnerer svaret, når gennemløbet er færdigt.

Tilføj en dataagent ved at bruge kode

Trinene i denne artikel bruger Foundry-portalen. Du kan gøre det samme i kode med Python, C# eller JavaScript SDK, eller med REST API'en. Java SDK'en understøtter ikke Fabric IQ.

To ting fungerer forskelligt i kode:

  • Du leverer selv endepunktet. Der er ikke noget katalog at gennemse, så du sender dataagentens Model Context Protocol-endpoint som server_url, i denne form:

    https://{host}/v1/mcp/workspaces/{workspaceId}/dataagents/{dataAgentId}/agent

    Her er Fabric API-værten{host}, normalt api.fabric.microsoft.com. Find {workspaceId} og {dataAgentId} i Microsoft Fabric-portalen: åbn arbejdsområdet, vælg dataagenten, og kopier de to ID'er fra browserens adresselinje.

  • Du nævner en projektforbindelse. Du sender ressource-ID'et for Fabric IQ-projektforbindelsen som project_connection_id. Opret den forbindelse i Foundry-portalen først.

For kodeeksempler i hvert sprog, se Connect agents to Microsoft Fabric with Fabric IQ.

Relateret indhold

  • Sidst opdateret den