Správa zdrojového kódu, CI/CD a ALM pro Fabric datového agenta

Tento článek popisuje, jak spravovat datové agenty Fabric pomocí integrace s Git a nasazovacích kanálů jako součástí funkcí správy životního cyklu aplikací (ALM) Microsoft Fabric. Dozvíte se, jak připojit pracovní prostor k úložišti Git. Dozvíte se také, jak sledovat a verzovat konfigurace datových agentů. Nakonec se dozvíte, jak propagovat aktualizace napříč vývojovými, testovacími a produkčními prostředími. Kanály integrace a nasazení Gitu umožňují kontinuální integraci a průběžné nasazování (CI/CD) změn agenta dat, což umožňuje automaticky testovat a propagovat aktualizace jako součást pracovního postupu ALM. Správa zdrojového kódu pro datové agenty Fabric je momentálně ve verzi ukázkové.

K podpoře ALM pro Fabric datových agentů můžete použít dva doplňkové přístupy:

• Integrace Gitu: Synchronizujte celý pracovní prostor s úložištěm Git (Azure DevOps nebo GitHub jako poskytovatel Gitu), abyste povolili správu verzí, spolupráci prostřednictvím větví a sledování historie jednotlivých položek, včetně Fabric datových agentů.
• Kanály nasazení: Zvýšení úrovně obsahu mezi samostatnými pracovními prostory představujícími fáze vývoje, testování a produkční fáze pomocí předdefinovaných kanálů

Tyto funkce společně poskytují kompletní podporu ALM pro Fabric datových agentů.

Požadavky

• Placená kapacita Fabric F2 nebo vyšší, nebo kapacita Power BI Premium na uživatele (P1 nebo vyšší) s povolenou funkcí Microsoft Fabric.
• Povolit zpracování a ukládání napříč geografiemi pro AI na základě požadavků uvedených v nastavení tenanta datového agenta Fabric.
• Nejméně jeden z těchto zdrojů dat s daty: sklad, jezero, sémantický model Power BI, databáze KQL, zrcadlená databáze nebo ontologie. Ke zdroji dat musíte mít přístup pro čtení.

Git integrace

Microsoft Fabric integrace Gitu synchronizuje pracovní prostor Fabric s úložištěm Git, což vám umožní používat stávající vývojové procesy, nástroje a osvědčené postupy přímo na platformě Fabric. Podporuje Azure DevOps a GitHub a je k dispozici na úrovni pracovního prostoru. Když potvrdíte změny z Fabric, včetně aktualizací konfigurace datového agenta, uloží se tyto změny jako soubory v připojeném úložišti Git. Mezi klíčové funkce patří:

• Úplné zálohování a správa verzí položek pracovního prostoru
• Struktura složek v Gitu zrcadlí strukturu pracovního prostoru.
• Konfigurace datového agenta (výběr schématu, pokyny pro AI, pokyny ke zdroji dat, ukázkové dotazy) jsou uložené ve strukturovaných souborech ve vyhrazených složkách.
• Možnost zobrazit rozdíly, zkontrolovat historii a vrátit se k předchozím stavům prostřednictvím historie pro různé položky pracovního prostoru, včetně datových agentů
• Spolupráce na bázi větví (funkční větve, hlavní větev)

Nejnovější vylepšení integrace Gitu

Integrace Gitu v Fabric nyní podporuje selektivní přepínání větví, což vám umožňuje přepnout propojenou větev na úrovni pracovního prostoru tak, aby odpovídala pracovním postupům s funkčními větvemi. Podokno Správy zdrojového kódu také poskytuje integrovanou funkci diff pro změny položek, takže si můžete před odesláním nebo stažením aktualizací přesně prohlédnout, co se změnilo. Pracovní prostory s větvenými větvemi jsou jasněji uvedené v uživatelském rozhraní Fabric, což usnadňuje identifikaci větve, ke které větvi je každý pracovní prostor připojený.

Další informace o procesu integrace Gitu najdete v následujících zdrojích informací.

• Co je integrace Gitu Microsoft Fabric?
• Základní koncepty v integraci s Git
• Začněte s integrací Gitu

Nastavení připojení ke správě zdrojového kódu

Pracovní prostor Fabric můžete připojit k úložišti Git ze stránky Nastavení pracovního prostoru. Toto připojení umožňuje potvrdit a synchronizovat změny přímo z Fabric.

1. Podrobné kroky pro připojení k úložišti Git v Azure DevOps nebo GitHub najdete v tématu Zahajte integraci Gitu.

2. Po připojení k úložišti Git se položky pracovního prostoru, včetně Fabric datových agentů, zobrazí na panelu Správa zdrojového kódu. Na stavovém řádku vlevo dole uvidíte název připojené větve, čas poslední synchronizace a ID potvrzení Gitu.

3. Propojené úložiště Git zobrazí strukturu složek představující položky pracovního prostoru, včetně Fabric datových agentů a jejich konfiguračních souborů. Každý datový agent je uložený ve své vlastní složce a umožňuje kontrolovat změny, sledovat historii verzí a používat pracovní postupy Gitu, jako je vytváření žádostí o přijetí změn ke sloučení aktualizací do hlavní větve.

4. Když provedete změny datového agenta Fabric v pracovním prostoru připojeném k Gitu, změny se zjistí a stav datového agenta v podokně Správy zdrojového kódu se změní na Nepotvrzené změny. Mezi tyto úpravy patří:

   • Změna výběru schématu
   • Aktualizace pokynů pro AI nebo pokynů ke zdroji dat
   • Úpravy ukázkových dotazů
   • Publikování datového agenta nebo aktualizace jeho publikačního popisu

Jakákoli změna – ať už funkční nebo popisná – způsobí, že se datový agent přestane synchronizovat s propojeným úložištěm Git. Položky pracovního prostoru se změnami se zobrazí pod kartou Změny v podokně Správy zdrojového kódu. Tyto změny můžete zkontrolovat, porovnat je s potvrzenou verzí a potvrdit je zpět do úložiště Git, aby se synchronizovaly.

5. Když se aktualizace provádějí přímo v propojeném úložišti Git (Azure DevOps nebo GitHub), můžou zahrnovat akce, jako je úprava pokynů AI, změna ukázkových dotazů nebo úprava popisů publikování. Tyto změny pak můžete potvrdit a odeslat do úložiště. Jakmile se aktualizace nasdílí a zpřístupní v úložišti, váš pracovní prostor Fabric je zjistí a zobrazí oznámení o dostupných aktualizacích v podokně Správy zdrojového kódu. Aktualizované položky, jako je datový agent, se zobrazí na kartě Aktualizace, kde je můžete zkontrolovat a přijmout. Přijetí těchto aktualizací aplikuje změny úložiště na položky pracovního prostoru a zajišťuje, aby se v pracovním prostoru odrážela nejnovější potvrzená verze v Gitu.

Struktura složek a souborů v úložišti Git

V následujícím příkladu si prohlédnete strukturu toho, jak je konfigurace datového agenta uložená v úložišti Git. Pochopení této struktury je důležité pro správu změn a dodržování osvědčených postupů. Při používání větví funkcionalit dělejte změny ve větvi spojené s pracovním prostorem, zkontrolujte rozdíly v podokně Správa zdrojového kódu a slučujte je prostřednictvím pull requestů pro kontrolované nasazení. Soubory a struktura konfigurace pro datové agenty zůstávají ve větvích stejné.

Kořenová struktura

V kořenovém adresáři je obsah datového agenta uložený ve složce souborů . Uvnitř souborů najdete konfigurační složku, která obsahuje data_agent.json, publish_info.json, složku konceptů a publikovanou složku.

Ve složce konfigurace obsahujepublish_info.json popis publikování datového agenta. Tento soubor lze aktualizovat a změnit popis, který se zobrazí při publikování datového agenta.

Složka konceptů obsahuje konfigurační soubory odpovídající verzi konceptu datového agenta a publikovaná složka obsahuje konfigurační soubory pro publikovanou verzi datového agenta. Složka Koncepty obsahuje:

• Složky zdroje dat , ve kterých je jedna složka pro každý zdroj dat používaný agentem dat. Název každé složky začíná předponou, která identifikuje typ zdroje dat, následovanou názvem zdroje dat. Například:

  • Zdroje dat Lakehouse nebo skladiště: Názvy složek začínají lakehouse-tables- nebo warehouse-tables-, následované názvem lakehouse nebo skladiště.
  • Sémantické zdroje dat modelu: Názvy složek začínají semantic-model-názvem sémantického modelu, za kterým následuje název sémantického modelu.
  • Zdroje dat databáze KQL: Názvy složek začínají kusto-názvem databáze KQL, za kterým následuje název databáze KQL.
  • Zdroje dat ontologie: Názvy složek začínají ontology-, následované názvem ontologie.

  Další podporované datové zdroje, jako je SQL databáze ve Fabric, zrcadlené databáze, grafové modely a Azure AI Vyhledávač, následují stejný vzor pojmenování. Pro úplný seznam podporovaných datových zdrojů viz Přidat a nakonfigurovat datové zdroje v Fabric datovém agentovi.

• stage_config.json , který obsahuje aiInstructions, který odkazuje na pokyny agenta.

Každá složka zdroje dat obsahuje datasource.json a fewshots.json. Pokud je však zdrojem dat sémantický model, nepodporuje ukázkové dotazy, takže jeho složka obsahuje pouze datasource.json.

datasource.jsondefinuje konfiguraci pro tento zdroj dat, včetně:

• dataSourceInstructions, který představuje pokyny uvedené pro tento zdroj dat.

• displayName, který zobrazuje název zdroje dat.

• elements, který odkazuje na mapu schématu a obsahuje úplný seznam tabulek a sloupců ze zdroje dat.

  • Každá tabulka má is_selected vlastnost. Pokud trueje tabulka zahrnutá a pokud false, znamená to, že tabulka není vybraná a nebude ji používat agent dat.
  • Položky sloupců se také zobrazují is_selected, avšak v současné době není výběr na úrovni sloupce podporován. Pokud je vybraná tabulka, všechny její sloupce se zahrnou bez ohledu na hodnotu sloupce is_selected . Pokud není vybrána tabulka (is_selected: false na úrovni tabulky), žádný ze sloupců se nepovažuje, i když je is_selected nastaveno na true na úrovni sloupce.

• Konvence typů:

  • Pokud je typ zdrojem dat, je to jednoduše typ zdroje dat (například: "type": "lakehouse_tables").
  • Pokud je typ tabulka, končí .table (například: "type": "lakehouse_tables.table").
  • Pokud je typ sloupec, končí na .column (například: "type": "lakehouse_tables.column").

fewshots.jsonukládá ukázkové dotazy pro zdroj dat. Každá položka zahrnuje:

• id jako jedinečný identifikátor ukázkového dotazu.
• question, což odkazuje na otázku přirozeného jazyka.
• query zobrazuje text dotazu, který může být SQL nebo KQL v závislosti na typu zdroje dat.

Publikovaná složka zrcadlí strukturu konceptní složky, ale představuje publikovanou verzi datového agenta. Osvědčeným postupem je přímo neupravovat soubory v publikované složce. Změny by měly být provedeny ve složce návrhů. Po publikování datového agenta se tyto změny projeví v publikované složce. Tím se zajistí, že publikovaná verze se vždy vygeneruje z řízeného stavu konceptu.

Kanály nasazení pro datové agenty

Kanály nasazení poskytují řízený způsob přesunu datových agentů mezi pracovními prostory mapovanými na různé fáze životního cyklu. Například:

1. Vytvořte nového datového agenta nebo aktualizujte existující agenta ve vývojovém pracovním prostoru.
2. Přesunout změny do testovacího pracovního prostoru pro ověření.
3. Nasadit otestované změny do produkční verze pracovního prostoru, kde budou dostupné koncovým uživatelům.

Před nasazením je potřeba přiřadit pracovní prostor ke každé fázi kanálu nasazení: vývoj, testování a produkční prostředí. Pokud nepřiřadíte pracovní prostor k testovací nebo produkční fázi, pracovní prostory se automaticky vytvoří. Automaticky vytvořené pracovní prostory jsou pojmenovány po vývojovém pracovním prostoru s připojeným [test] nebo [prod].

Nasazení změn:

• Přejděte ve vývojovém procesu do fáze, ze které chcete nasadit (například vývoj).
• Vyberte položky v pracovním prostoru, který chcete nasadit.
• Výběrem možnosti Nasadit je povýšíte do dalšího stádia.

Před použitím změn můžete zkontrolovat plán nasazení a zajistit, aby se propagovaly pouze zamýšlené aktualizace. Další informace najdete v tématu Začínáme s kanály nasazení.

Automatizace CI/CD pomocí kanálů Azure DevOps

Rozšíření Azure DevOps Pipelines pro Fabric poskytuje nativní úlohy, které spouští příkazy Fabric CLI v úlohách kanálu Azure DevOps. Týmy můžou orchestrovat CI/CD pro aktualizace datového agenta pomocí Azure DevOps (s rozhraním příkazového řádku) nebo místo kanálů nasazení Fabric. Začněte tím, že nainstalujete rozšíření z Visual Studio Marketplace, nastavíte připojení služby v projektu Azure DevOps a přidáte do definice kanálu Fabric úkoly rozhraní příkazového řádku.

Hromadná synchronizace prostřednictvím dávkových rozhraní API (Preview)

Rozhraní API batch pro definice položek importu a exportu (Preview) poskytují možnost pro rozsáhlou synchronizaci definic položek, včetně konfigurací datového agenta. Definice datového agenta můžete exportovat a importovat v dávkách pro zjednodušení přenášení napříč prostředími. Další informace najdete v dokumentaci k rozhraní REST API Fabric.

Poznámka:

Servisní účty jsou podporovány v datovém agentu Fabric pouze v rámci scénářů ALM. Tato podpora je omezená na povolení operací ALM (jako je integrace Gitu a kanálů nasazení) a nevztahuje se na další funkce agenta dat Fabric. Pokud potřebujete interagovat s datovým agentem mimo pracovní postupy ALM, principál služby není podporován.

Publikování datového agenta Fabric pro kanály nasazení

Publikování Fabric datového agenta ho zpřístupní k použití ve všech různých kanálech využívání, včetně Copilot pro Power BI, Microsoft Copilot Studio a Foundry Tools. Aby bylo možné posoudit a využívat datového agenta v těchto kanálech, musí být datový agent publikován; Nepublikované datové agenty nejsou přístupné ke spotřebě, i když jsou v provozním pracovním prostoru. Aby bylo možné postupovat podle osvědčených postupů v souladu s kanálem nasazení, mějte na paměti, že:

• Publikování z vývojového pracovního prostoru by mělo být omezené jenom na oprávněné uživatele, kteří pracují na vývoji datových agentů a chtějí posoudit jeho výkon v různých kanálech spotřeby. Přístup k tomuto pracovnímu prostoru musí být omezený, aby nedokončení nebo experimentální datoví agenti nebyli zpřístupněni širšímu publiku.
• Koncoví uživatelé by měli přistupovat k datovým agentům publikovaným pouze z produkčního pracovního prostoru a zajistit tak interakci se stabilními schválenými verzemi datového agenta.

Tento přístup podporuje jak funkční požadavek na povolení spotřeby, tak vyhodnocení výkonu a zajišťuje řádné řízení přístupu tím, že udržuje vývojová a produkční prostředí oddělená.

Osvědčené postupy

• Pro práci na datových agentech použijte vyhrazenou větev a po kontrole kódu ji sloučíte do hlavní části.
• Související prostředky (zdroje dat, datové agenty, poznámkové bloky, datové toky) uchovávejte ve stejném pracovním prostoru, abyste usnadnili povýšení.
• Před povýšením do produkčního prostředí otestujte změny agenta dat v testovacím pracovním prostoru.
• Pomocí popisných zpráv potvrzení můžete usnadnit pochopení historie.
• Neprovedávejte přímo změny publikované složky v úložišti Git.
• Použijte vzory konfigurace nezávislé na prostředí (například odkazy na připojení prostřednictvím knihovny proměnných, kde je podporováno) a vyhněte se pevně zakódování hodnot specifických pro prostředí v konfiguracích zdroje dat agenta dat. Tento postup usnadňuje plynulejší slučování větví a nasazení napříč vývojem, testováním a produkčním prostředím.

Omezení a úvahy

• Funkce ALM založené na Gitu můžou používat jenom pracovní prostory připojené k úložišti Git.
• Služební identity jsou podporovány v datovém agentu Fabric jen jako součást scénářů ALM. Pokud potřebujete interagovat s datovým agentem mimo pracovní postupy ALM, principál služby není podporován.
• Kanály nasazení vyžadují, aby zdrojové a cílové pracovní prostory byly ve stejném tenantu.
• Velký počet častých potvrzení může mít vliv na velikost a výkon úložiště.

Související obsah

• Začněte s integrací Gitu
• Základní koncepty v integraci s Git
• Co je správa životního cyklu v Microsoft Fabric?