Source Control, CI/CD ja ALM for Fabric -tietoagentti (esikatselu)

Tässä artikkelissa kuvataan, miten voit hallita Fabric-tietoagentteja Git-integrointi- ja käyttöönottoputkien avulla osana Microsoft Fabricin Application Lifecycle Management (ALM) -ominaisuuksia. Opit yhdistämään työtilan Git-säilöön. Opit myös seuraamaan ja versioimaan tietoagentin määrityksiä. Lopuksi opit edistämään päivityksiä kehitys-, testi- ja tuotantoympäristöissä. Git-integrointi- ja käyttöönottoputket mahdollistavat tietoagentin muutosten jatkuvan integroinnin ja jatkuvan käyttöönoton (CI/CD), jolloin päivitykset voidaan testata ja ylennetä automaattisesti osana ALM-työnkulkua. Fabric-tietoagenttien lähteenhallinta on tällä hetkellä esikatselussa.

Voit käyttää kahta toisiaan täydentävää lähestymistapaa ALM for Fabric -tietoagenttien tukemiseen:

• Git-integrointi: Synkronoi koko työtila Git-säilön kanssa (joko Azure DevOps tai GitHub Git-palveluntarjoajana), jotta voit ottaa käyttöön versionhallinnan, yhteistyön haarojen kautta ja historian seurannan yksittäisille kohteille, mukaan lukien Fabric-tietoagentit.
• Käyttöönottoputket: Ylennä sisältöä erillisten työtilojen välillä, jotka edustavat kehitys-, testaus- ja tuotantovaiheita sisäisten putkien avulla.

Nämä ominaisuudet yhdessä tarjoavat päästä päähän ALM-tuen Fabric-tietoagenteille.

Tärkeää

Tämä ominaisuus on esikatselutilassa.

Edellytykset

• Maksullinen F2 tai uudempi Fabric-kapasiteetti tai kapasiteettikohtainen Power BI Premium kapasiteetti (P1 tai uudempi), kun Microsoft Fabric on käytössä
• Fabric-tietoagenttien vuokraaja-asetukset on käytössä.
• AI Cross-Geo-prosessointi on käytössä.
• AI Cross-Geo-tallennus on käytössä.
• Vähintään yksi näistä, sisältäen dataa: varasto, järvitalo, yksi tai useampi Power BI -semanttinen malli, KQL-tietokanta tai ontologia.
• Power BI:n semanttiset mallit XMLA-päätepisteiden vuokraajavalitsimen kautta on käytössä Power BI:n semanttisen mallin tietolähteissä.

Git-integraatio

Microsoft Fabric Git -integrointi synkronoi Fabric-työtilan Git-säilön kanssa, jolloin voit käyttää olemassa olevia kehitysprosesseja, työkaluja ja parhaita käytäntöjä suoraan Fabric-ympäristössä. Se tukee Azure DevOpsia ja GitHubia, ja se on käytettävissä työtilatasolla. Kun vahvistat muutoksia Fabricista, mukaan lukien tietoagentin määrityksen päivitykset, muutokset tallennetaan tiedostoina yhdistettyyn Git-säilöön. Sen keskeisiä ominaisuuksia ovat:

• Työtilan kohteiden täysi varmuuskopiointi ja versionhallinta
• Gitin kansiorakenne heijastaa työtilan rakennetta
• Tietoagentin määritykset (skeeman valinta, tekoälyohjeet, tietolähdeohjeet, esimerkkikyselyt) tallennetaan jäsenneltyihin tiedostoihin omiin kansioihin
• Mahdollisuus tarkastella eroja, tarkastella historiaa ja palata aiempiin tiloihin eri työtilakohteiden, kuten tietoagenttien, historian kautta
• Haarapohjainen yhteistyö (ominaisuushaarat, pää)

Lisätietoja Git-integrointiprosessista on seuraavissa resursseissa.

• Mikä on Microsoft Fabric Git -integrointi?
• Git-integraation peruskäsitteet
• Aloita Git-integrointi

Yhteyden määrittäminen lähteenhallintaan

Voit yhdistää Fabric-työtilan Git-säilöön Työtilan asetukset -sivulta. Tämän yhteyden avulla voit vahvistaa ja synkronoida muutokset suoraan Fabricista.

1. Katso Git-integroinnin aloittaminen -kohdasta yksityiskohtaiset ohjeet yhteyden muodostamiseen Git-säilöön Azure DevOpsissa tai GitHubissa.

2. Kun olet muodostanut yhteyden Git-säilöön, työtilan kohteet, mukaan lukien Fabric-tietoagentit, näkyvät Source-ohjauspaneelissa. Vasemmassa alakulmassa olevalla tilarivillä näet yhdistetyn haaran nimen, viimeisimmän synkronoinnin ajan ja Git-toimitustunnuksen.

3. Linkitetty Git-säilö näyttää kansiorakenteen, joka edustaa työtilan kohteita, mukaan lukien Fabric-tietoagentit ja niiden määritystiedostot. Jokainen tietoagentti on tallennettu omaan kansioonsa, jolloin voit tarkastella muutoksia, seurata versiohistoriaa ja käyttää Git-työnkulkuja, kuten luoda pull-pyyntöjä päivitysten yhdistämiseksi päähaaraan.

4. Kun teet muutoksia Fabric-tietoagenttiin Git-yhdistetyssä työtilassa, muutokset havaitaan ja tietoagentin tilaksi muuttuu Lähteen hallinta -ruudussa Vahvistamattomat muutokset. Näitä muutoksia voivat olla:

   • Mallin valinnan muuttaminen.
   • Tekoälyohjeiden tai tietolähdeohjeiden päivittäminen.
   • Esimerkkikyselyjen muokkaaminen.
   • Data-agentin julkaiseminen tai sen julkaisukuvauksen päivittäminen.

Kaikki muutokset – olivatpa ne toiminnallisia tai kuvaavia – aiheuttavat sen, että tietoagentti ei ole synkronoitu linkitetyn Git-säilön kanssa. Työtilan kohteet, joissa on muutoksia, näkyvät Lähteen ohjausobjekti -ruudun Muutokset-välilehdessä. Voit tarkastella näitä muutoksia, verrata niitä vahvistettuun versioon ja vahvistaa ne takaisin Git-säilöön synkronointia varten.

5. Kun päivitykset tehdään suoraan linkitettyyn Git-säilöön (Azure DevOps tai GitHub), ne voivat sisältää toimintoja, kuten tekoälyohjeiden muokkaamisen, esimerkkikyselyjen muuttamisen tai julkaisukuvausten muokkaamisen. Voit sitten vahvistaa ja lähettää nämä muutokset arkistoon. Kun päivitykset on lähetetty ja saatavilla säilössä, Fabric-työtila tunnistaa ne ja näyttää Päivitykset saatavilla -ilmoituksen Lähteen hallinta -ruudussa. Päivitetyt kohteet, kuten tietoagentti, näkyvät Päivitykset-välilehdessä, jossa voit tarkastella ja hyväksyä niitä. Näiden päivitysten hyväksyminen ottaa säilön muutokset käyttöön työtilan kohteissa ja varmistaa, että työtila vastaa Gitin uusinta vahvistettua versiota.

Kansio- ja tiedostorakenne Git-arkistossa

Seuraavassa tarkastellaan rakennetta, jolla tietoagentin määritykset tallennetaan Git-säilöön. Tämän rakenteen ymmärtäminen on tärkeää muutosten hallitsemiseksi ja parhaiden käytäntöjen noudattamiseksi.

Juuren rakenne

Juuritietokannassa tietoagentin sisältö tallennetaan tiedostokansioon . Tiedostojen sisältä löydät määrityskansion, joka sisältää data_agent.json, publish_info.json, luonnoskansion ja julkaistun kansion.

Config-kansion sisälläpublish_info.json sisältää tietoagentin julkaisukuvauksen. Tämä tiedosto voidaan päivittää muuttamaan kuvausta, joka tulee näkyviin, kun tietoagentti julkaistaan.

Luonnoskansio sisältää tietoagentin luonnosversiota vastaavat määritystiedostot ja julkaistu kansio sisältää tietoagentin julkaistun version määritystiedostot. Luonnoskansio sisältää:

• Tietolähdekansiot , joissa on yksi kansio kullekin tietoagentin käyttämälle tietolähteelle.
  • Lakehouse- tai varastotietolähteet: Kansioiden nimet alkavat kirjaimella lakehouse-tables- tai , warehouse-tables-jota seuraa lakehousen tai varaston nimi.
  • Semanttisen mallin tietolähteet: Kansioiden nimet alkavat semantic-model-, jota seuraa semanttisen mallin nimi.
  • KQL-tietokannan tietolähteet: Kansioiden nimet alkavat kusto-, jota seuraa KQL-tietokannan nimi.
  • Ontologian tietolähteet: Kansioiden nimet alkavat , ontology-jota seuraa ontologian nimi.

• stage_config.json , joka sisältää aiInstructions, joka viittaa agentin ohjeisiin.

Jokainen tietolähdekansio sisältää datasource.json ja fewshots.json. Jos tietolähde on kuitenkin semanttinen malli, se ei tue esimerkkikyselyitä, joten sen kansio sisältää vain datasource.json.

datasource.json määrittää kyseisen tietolähteen määritykset, mukaan lukien:

• dataSourceInstructions, joka edustaa kyseiselle tietolähteelle annettuja ohjeita.

• displayName, joka näyttää tietolähteen nimen.

• elements, joka viittaa rakennekarttaan ja sisältää täydellisen luettelon tietolähteen taulukoista ja sarakkeista.

  • Jokaisella pöydällä on is_selected ominaisuus. Jos truetaulukko on mukana ja jos false, se tarkoittaa, että taulukkoa ei ole valittu eikä tietoagentti käytä sitä.
  • Sarakemerkinnät näkyvät is_selectedmyös , mutta saraketason valintaa ei tällä hetkellä tueta. Jos taulukko on valittuna, kaikki sen sarakkeet sisällytetään sarakkeen is_selected arvosta riippumatta. Jos taulukkoa ei ole valittu (is_selected: false taulukkotasolla), mitään sarakkeista ei oteta huomioon, vaikka se is_selected on asetettu true saraketasolle.

• Tyyppikäytännöt:

  • Jos tyyppi on tietolähde, se on yksinkertaisesti tietolähteen tyyppi (esimerkiksi: "type": "lakehouse_tables").
  • Jos tyyppi on taulukko, se päättyy .table (esimerkiksi: "type": "lakehouse_tables.table").
  • Jos tyyppi on sarake, se päättyy .column (esimerkiksi: "type": "lakehouse_tables.column").

fewshots.json tallentaa tietolähteen esimerkkikyselyt. Jokainen merkintä sisältää:

• id esimerkkikyselyn yksilöllisenä tunnisteena.
• question, joka viittaa luonnollisen kielen kysymykseen.
• query näyttää kyselyn tekstin, joka voi olla SQL tai KQL tietolähteen tyypistä riippuen.

Julkaistu kansio heijastaa luonnoskansion rakennetta, mutta edustaa tietoagentin julkaistua versiota. On parasta olla muokkaamatta julkaistun kansion tiedostoja suoraan. Muutokset tulee tehdä luonnoskansioon. Kun tietoagentti on julkaistu, muutokset näkyvät julkaistussa kansiossa. Näin varmistetaan, että julkaistu versio luodaan aina hallitusta luonnostilasta.

Data-agenttien käyttöönottoputket

Käyttöönottoputket tarjoavat hallitun tavan siirtää tietoagentteja elinkaaren eri vaiheisiin kartoitettujen työtilojen välillä. Esimerkki:

1. Kehitä uusi tietoagentti tai päivitä aiemmin luotu asiakaspalvelija kehitystyötilassa.
2. Ylennä testityötilan muutokset vahvistusta varten.
3. Ylennä testatut muutokset tuotantotyötilaan, jossa se on loppukäyttäjien käytettävissä.

Ennen käyttöönottoa sinun on määritettävä työtila kullekin käyttöönottoputken vaiheelle: kehitykselle, testaukselle ja tuotannolle. Jos et määritä työtilaa testi- tai tuotantovaiheeseen, työtilat luodaan automaattisesti. Automaattisesti luodut työtilat nimetään kehitystyötilan mukaan, ja niihin on liitetty [test] tai [prod].

Muutosten käyttöönotto:

• Siirry putkessa vaiheeseen, josta haluat ottaa käyttöön (esimerkiksi kehitys).
• Valitse työtilan kohteet, jotka haluat ottaa käyttöön.
• Valitse Ota käyttöön, jos haluat ylentää ne seuraavaan vaiheeseen.

Voit tarkistaa käyttöönottosuunnitelman ennen muutosten käyttöönottoa ja varmistaa, että vain aiotut päivitykset ylennetään. Lisätietoja on kohdassa Käyttöönottoputkien käytön aloittaminen.

Note

Palvelun päänimiä tuetaan Fabric-tietoagentissa vain osana ALM-skenaarioita. Tämä tuki rajoittuu ALM-toimintojen (kuten Git-integrointi- ja käyttöönottoputkien) käyttöönottoon, eikä se ulotu muihin Fabric-tietoagentin ominaisuuksiin. Jos sinun on oltava vuorovaikutuksessa tietoagentin kanssa ALM-työnkulkujen ulkopuolella, palvelun päänimeä ei tueta.

Julkaise Fabric-tietoagentti käyttöönottoputkia varten

Fabric-tietoagentin julkaiseminen mahdollistaa sen käytön kaikissa eri kulutuskanavissa, mukaan lukien Copilot for Power BI, Microsoft Copilot Studio ja Azure AI Foundry Services. Jotta voit arvioida ja käyttää data-agenttia näissä kanavissa, tietoagentti on julkaistava. Julkaisemattomat tietoagentit eivät ole käytettävissä kulutukseen, vaikka ne olisivat tuotantotyötilassa. Jotta voit noudattaa parhaita käytäntöjä käyttöönottoputken mukaisesti, ota huomioon, että:

• Julkaiseminen kehitystyötilasta tulisi rajoittaa vain valtuutettuihin käyttäjiin, jotka työskentelevät tietoagentin kehittämisen parissa ja haluavat arvioida sen suorituskykyä eri kulutuskanavissa. Tämän työtilan käyttöä on rajoitettava, jotta keskeneräiset tai kokeelliset tietoagentit eivät näy laajemmalle yleisölle.
• Loppukäyttäjien tulee käyttää vain tuotantotyötilasta julkaistuja tietoagentteja ja varmistaa, että he ovat vuorovaikutuksessa tietoagentin vakaiden, hyväksyttyjen versioiden kanssa.

Tämä lähestymistapa tukee sekä kulutuksen että suorituskyvyn arvioinnin mahdollistamisen toiminnallista vaatimusta ja varmistaa asianmukaisen kulunvalvonnan pitämällä kehitys- ja tuotantoympäristöt erillään.

Parhaat käytännöt

• Käytä erillistä haaraa tietoagenttien kehitystyöhön ja yhdistä pääkäyttöön koodin tarkistuksen jälkeen.
• Pidä liittyvät resurssit (tietolähteet, tietoagentit, muistikirjat, putket) samassa työtilassa ylennyksen helpottamiseksi.
• Testaa tietoagentin muutokset testityötilassa ennen ylentämistä tuotantoon.
• Käytä kuvaavia toimitusviestejä, jotta historia on helpompi ymmärtää.
• Älä tee muutoksia suoraan julkaistuun kansioon Git-säilössä.

Rajoitukset ja huomioitavat seikat

• Vain Git-säilöön yhdistetyt työtilat voivat käyttää Git-pohjaisia ALM-ominaisuuksia.
• Palvelun päänimiä tuetaan Fabric-tietoagentissa vain osana ALM-skenaarioita. Jos sinun on oltava vuorovaikutuksessa tietoagentin kanssa ALM-työnkulkujen ulkopuolella, palvelun päänimeä ei tueta.
• Käyttöönottoputket edellyttävät, että lähde- ja kohdetyötilat ovat samassa vuokraajassa.
• Suuri määrä toistuvia toimituksia voi vaikuttaa arkiston kokoon ja suorituskykyyn.

Liittyvä sisältö

• Aloita Git-integrointi
• Git-integraation peruskäsitteet
• Mikä on Microsoft Fabricin elinkaaren hallinta?