Dodaj agentów danych Fabric do agenta Foundry za pomocą Fabric IQ (podgląd)

Agent danych Fabric odpowiada na pytania dotyczące danych przechowywanych w Microsoft Fabric OneLake. Agent wbudowany w Microsoft Foundry może wezwać agenta danych Fabric, gdy potrzebuje odpowiedzi na podstawie danych korporacyjnych w OneLake.

Ten artykuł pokazuje, jak dodać agenta danych Fabric do agenta Foundry za pomocą narzędzia Fabric IQ (OneLake Catalog). Każdy krok odbywa się w portalu Microsoft Foundry. To samo możesz zrobić w kodzie, jak opisano w sekcji Dodaj agenta danych, używając kodu później w tym artykule.

Ważna

Gdy agent Foundry dzwoni do agenta danych Fabric, odpowiedzi, które agent zwraca, mogą być wysyłane poza granice zgodności Fabric lub region geograficzny. Te odpowiedzi są następnie przetwarzane i przechowywane zgodnie z warunkami i polityką obsługi danych Microsoft Foundry.

Co daje ta integracja

Fabric IQ to część Microsoft Fabric, która udostępnia Twoje dane agentom i aplikacjom. Opublikowany agent danych Fabric to jeden z elementów, które Fabric IQ udostępnia, a dodajesz go do agenta Foundry za pośrednictwem katalogu OneLake.

Ta metoda różni się od wcześniejszej na trzy sposoby:

  • Wybierasz agentów danych z listy. W portalu Foundry katalog OneLake wyświetla według nazwy opublikowanych agentów danych, do których masz dostęp. Nie musisz najpierw wyszukiwać identyfikatora obszaru roboczego ani identyfikatora artefaktu.
  • Możesz dodać więcej niż jednego agenta danych. Pojedynczy agent Foundry może odwoływać się do wielu agentów danych, dzięki czemu może czerpać z więcej niż jednego obszaru danych firmowych. Wcześniejsza metoda pozwalała tylko na jedną.
  • Każdy agent danych jest udostępniany jako punkt końcowy protokołu Model Context Protocol. Model Context Protocol to otwarty standard dotyczący sposobu, w jaki agent wywołuje narzędzie. Twoi agenci danych Fabric pojawiają się dla agenta Foundry jako narzędzia, które może wywołać, tak jak wywołuje każde inne narzędzie.

W przypadku wcześniejszej metody, która łączy pojedynczego agenta danych za pomocą identyfikatora przestrzeni roboczej i identyfikatora artefaktu, zobacz Consume a data agent in Microsoft Foundry.

Wymagania wstępne

  • Płatna pojemność Fabric F2 lub wyższa albo pojemność usługi Power BI Premium (P1 lub wyższa) z włączoną usługą Microsoft Fabric.
  • Przestrzeń robocza w regionie, który obsługuje cały stos Fabric. Fabric IQ nie jest dostępna w regionach, w których Power BI jest jedynym obciążeniem Fabric. Aby uzyskać więcej informacji, zobacz Dostępność regionów usługi Fabric.
  • Włączone przetwarzanie między regionami geograficznymi i przechowywanie między regionami geograficznymi na potrzeby AI, zgodnie z wymaganiami opisanymi w ustawieniach dzierżawy agenta danych Fabric.
  • Przynajmniej jedno z tych źródeł danych, zawierające dane: magazyn, domek nad jeziorem, model semantyczny Power BI, bazę danych KQL lub bazę danych lustrzaną. Musisz mieć uprawnienia do odczytu źródła danych.
  • Projekt Foundry z już wdrożonym modelem. Aby go utworzyć, zobacz Tworzenie projektu.

Zanim rozpoczniesz

Sprawdź następujące elementy, zanim dodasz agenta danych Fabric do agenta Foundry:

  • Agent danych działa. Potwierdź, że agent danych odpowiada na pytania zgodnie z oczekiwaniami w Fabric.
  • Agent danych jest publikowany. W katalogu OneLake pojawiają się tylko opublikowane agenty danych Fabric. Aby stworzyć i opublikować takiego, zobacz Create a Fabric data agent.
  • Obaj agenci mieszkają w tym samym najemcy. Agent danych usługi Fabric i agent usługi Foundry muszą być w tej samej dzierżawie.
  • Używasz tego samego konta. Zaloguj się do Microsoft Fabric i Microsoft Foundry za pomocą tego samego konta.
  • Masz odpowiednie uprawnienia. Potrzebujesz co najmniej uprawnień do odczytu agenta danych usługi Fabric, co najmniej uprawnień do odczytu jego źródeł danych oraz uprawnień do tworzenia i modyfikowania agentów w projekcie Foundry. Więcej informacji o uprawnieniach agentów danych można znaleźć w artykule Fabric o udostępnianiu agentów danych i zarządzaniu uprawnieniami.

Role w Microsoft Foundry

Microsoft Foundry korzysta z kontroli dostępu opartej na rolach. Poniższa tabela przedstawia rolę, której potrzebujesz przy każdym zadaniu. Aby uzyskać więcej informacji, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry.

Co chcesz zrobić Rola, której potrzebujesz
Utwórz projekt Foundry Właściciel konta Foundry lub Właściciel Foundry albo rola Właściciel lub Współautor na platformie Azure
Buduj i testuj agenta w projekcie Użytkownik platformy Foundry
Stwórz połączenie z Fabric IQ Menedżer projektu Foundry

Note

Jeśli Twój projekt już istnieje, Foundry User wystarczy, by zbudować i przetestować agenta w nim. Przypisz Foundry User do swojego konta, do tożsamości środowiska działania agenta oraz do dowolnej tożsamości użytkownika uczestniczącej w procesie logowania.

Jak to działa

  1. Użytkownik zadaje pytanie twojemu agentowi Foundry.
  2. Agent Foundry decyduje, czy jeden z jego agentów danych Fabric może odpowiedzieć na to pytanie. Instrukcje, które piszesz, kierują tą decyzją.
  3. Agent Foundry wywołuje agenta danych Fabric.
  4. Agent danych odpytuje swoje źródła danych w usłudze Fabric OneLake i zwraca odpowiedź.
  5. Agent Foundry używa tej odpowiedzi, aby odpowiedzieć użytkownikowi.

Żądania są wykonywane pod tożsamością skonfigurowaną dla połączenia. W przypadku agenta danych Fabric to połączenie korzysta z uwierzytelniania użytkownika delegowanego, więc żądanie jest wykonywane jako zalogowany użytkownik, a Fabric stosuje uprawnienia tego użytkownika. Użytkownik otrzymuje wyniki tylko z danych, do których ma dostęp.

Note

Model wybrany dla agenta Foundry służy do koordynowania jego działania i generowania jego odpowiedzi. Nie zmienia to modelu, którego wewnętrznie używa agent danych Fabric.

Krok 1: Stwórz agenta Foundry

Jeśli masz już agenta, otwórz go i przejdź do kroku 2.

  1. Zaloguj się do portalu Microsoft Foundry i wybierz projekt. Lądujesz na stronie głównej .

    Zrzut ekranu strony głównej w portalu Microsoft Foundry z zakładką Build w górnej nawigacji.

  2. W górnej nawigacji wybierz Build, co wyświetli wszystkich agentów w Twoim projekcie.

    Zrzut ekranu zakładki Buduj w portalu Microsoft Foundry z wybranymi agentami w lewym panelu i listą agentów na środku.

  3. Zaznacz strzałkę obok Nowy agent, a następnie wybierz Zbuduj agenta.

    Zrzut ekranu strony „Agenci” w portalu Microsoft Foundry z otwartym menu „Nowy agent”, w którym widoczna jest opcja „Utwórz agenta”.

  4. W oknie Utworzenie agenta wpisz nazwę agenta , która opisuje, co agent robi, a następnie wybierz Create.

    Zrzut ekranu okna dialogowego „Utwórz agenta” w portalu Microsoft Foundry z polem „Nazwa agenta”.

Tip

Możesz także zacząć od karty Zbuduj agenta na stronie głównej . Wybierz Start budowy , aby przejść do tego samego miejsca.

Twój nowy agent otwiera się na zakładce Playground . Panel po lewej stronie to miejsce, gdzie konfigurujesz agenta, z sekcjami na Model,Instrukcje, Narzędzia, Wiedzę i więcej. Panel po prawej stronie to okno czatu, w którym możesz to przetestować. Pozostałe kroki w tym artykule odbywają się na tej zakładce.

Krok 2: Dodaj narzędzie Fabric IQ (OneLake Catalog)

  1. W sekcji Narzędzia wybierz Dodaj i wybierz Przeglądaj wszystkie narzędzia.
  2. W oknie Wybieraj narzędzie, na zakładce Skonfigurowane, wybierz Fabric IQ (Katalog OneLake).
  3. Wybierz pozycję Dodaj narzędzie.

Zrzut ekranu z dialogu Wybierz narzędzie w portalu Microsoft Foundry z narzędziem Fabric IQ (katalog OneLake).

Katalog OneLake się otwiera.

Krok 3: Przefiltruj katalog pod kątem agentów danych

Katalog OneLake wymienia kilka rodzajów produktów Fabric, więc najpierw zawęź wybór.

  1. Wybierz pozycję Filtruj.
  2. W sekcji Typ wybierz agenta danych.

Zrzut ekranu katalogu OneLake w portalu Microsoft Foundry z otwartym menu Filtr i agentem danych wyświetlonym w kategorii Typ.

Lista pokazuje obecnie tylko opublikowanych agentów danych Fabric. Dla każdego z nich widzisz jego nazwę, lokalizację (obszar roboczy, w którym się znajduje), poświadczenie oraz etykietę wrażliwości. Aby jeszcze bardziej zawęzić listę, wpisz część nazwy w Filtruj według słowa kluczowego.

Dwie zasady decydują o tym, co zobaczysz na tej liście:

  • Agent danych musi zostać opublikowany. Agenty danych, które są nadal w wersji roboczej, nie są wyświetlane.
  • Musisz mieć dostęp do agenta danych. Jeśli kolega zbudował taki i nie podzielił się nim z tobą, nie ma go na twojej liście.

Krok 4: Dodaj agenta danych

  1. W filtrowanej liście wybierz agenta danych Fabric, którego chcesz, aby Twój agent Foundry używał.
  2. Wybierz opcję Dodaj.

Agent danych pojawia się teraz w sekcji Narzędzia twojego agenta Foundry, oznaczony jako Fabric IQ z nazwą agenta danych w nawiasach.

Zrzut ekranu agenta Foundry na zakładce Playground, z agentem danych Fabric w sekcji Narzędzia.

Krok 5: Dodaj więcej agentów danych

Dodajesz agentów danych po jednym. Aby dodać kolejny, powtórz Kroki 2 do 4. Otwórz katalog OneLake ponownie w sekcji Narzędzia i wybierz następnego agenta danych. Każdy z nich pojawia się jako osobny wpis na liście narzędzi.

Dodaj agenta danych dla każdego obszaru działalności firmy, który ma być objęty przez agenta Foundry. Na przykład jeden agent może przechowywać dane sprzedażowe, inny dane o łańcuchu dostaw, a trzeci – dane obsługi klienta. Następnie agent Foundry wybiera właściwy element do każdego pytania.

Krok 6: Napisz instrukcje dla swojego agenta

Twój agent Foundry musi wiedzieć, kiedy korzystać z każdego agenta danych. Zapisz te wskazówki w sekcji Instrukcje .

Bądź konkretny. Nazwij każdego agenta danych i określ, na jakie pytania powinien odpowiadać. Przykład:

Korzystaj z agenta danych Contoso Sales, aby zadawać pytania dotyczące przychodów, zamówień i produktów. Korzystaj z agenta danych Contoso Support do pytań dotyczących zgłoszeń i skarg klientów. Jeśli pytanie wymaga obu zapytań, zadzwoń do obu i połącz wyniki.

Bez jasnych instrukcji agent może w ogóle nie zadzwonić do agenta danych lub zadzwonić do niewłaściwego.

Krok 7: Dodaj inne narzędzia i źródła wiedzy

Ten krok jest opcjonalny. Obok agentów danych Fabric możesz dodać inne narzędzia w sekcji Narzędzia oraz źródła wiedzy w sekcji Wiedza tego samego agenta. Dodaj wszystko, czego agent potrzebuje do swojej pracy.

Krok 8: Ratuj swojego agenta

Wybierz Zapisz w prawym górnym rogu.

Ważna

Musisz uratować swojego agenta. Dopóki nie zapiszesz zapisu, Foundry nie przechowuje agentów danych, których dodałeś, instrukcji, które napisałeś, ani żadnych innych zmian wprowadzonych w poprzednich krokach.

Krok 9: Przetestuj swojego agenta

Użyj panelu czatu po prawej stronie zakładki Playground , aby przetestować agenta.

  1. Wyślij pytanie, na które powinien odpowiedzieć jeden z Twoich agentów danych, na przykład: Jaki był nasz najlepiej sprzedający się produkt w zeszłym miesiącu?
  2. Sprawdź odpowiedź. Potwierdź, że używa danych, których oczekujesz, i że pochodzi od agenta danych, którego wskazałeś.

Przetestuj każdego dodanego agenta danych przynajmniej jednym pytaniem i testuj pytanie, które wymaga więcej niż jednego z nich. Jeśli agent nie zadzwoni do agenta danych, zrewiduj instrukcje napisane w kroku 6, zapisz i przetestuj ponownie.

Aby zobaczyć, co agent danych robił przy każdym żądaniu, w tym które źródła danych zapytywał i ile czasu zajmował każdy krok, zobacz Observability for Fabric data agents in Microsoft Foundry.

Od dawna nurtujące pytania

Niektóre pytania zajmują agentowi danych więcej czasu na odpowiedź niż pozwala na to standardowe wywołanie narzędzia. Aby umożliwić zakończenie tych połączeń:

  1. Na liście Model wybierz model, który obsługuje tryb w tle, na przykład gpt-5.4 lub gpt-5.5.
  2. Wybierz ikonę parametrów obok modelu i włącz tryb w tle.

Agent następnie pokazuje postęp podczas pracy agenta danych i zwraca odpowiedź, gdy proces się zakończy.

Dodaj agenta danych za pomocą kodu

Kroki opisane w tym artykule korzystają z portalu Foundry. To samo możesz zrobić w kodzie za pomocą SDK w Python, C# lub JavaScript, albo z API REST. Java SDK nie obsługuje Fabric IQ.

W kodzie działają dwie rzeczy inaczej:

  • Punkt końcowy podajesz sam. Nie ma katalogu do przejrzenia, więc podajesz punkt końcowy protokołu Model Context Protocol agenta danych jako server_url, w tej postaci:

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

    Tutaj {host} jest hostem API Fabric, zwykle api.fabric.microsoft.com. Znajdź {workspaceId} i {dataAgentId} w portalu Microsoft Fabric: otwórz przestrzeń roboczą, wybierz agenta danych i skopiuj dwa identyfikatory z paska adresowego przeglądarki.

  • Odnosisz się do powiązania projektu. Przekazujesz identyfikator zasobu połączenia projektu Fabric IQ w postaci project_connection_id. Najpierw stwórz to połączenie w portalu Foundry.

Przykłady kodu w każdym języku można znaleźć w artykule Connect agents to Microsoft Fabric with Fabric IQ.