Luo ja muokkaa luotuja sivuja tekoälykoodin luontityökaluilla

Tässä artikkelissa kuvataan, miten voit luoda ja muokata Power Apps mallipohjaisten sovellusten tekoälykoodin luontityökaluja, kuten GitHub Copilot CLI:tä. Tämän lähestymistavan avulla voit integroida kehittyneen koodin muodostusominaisuudet suoraan kehitystyönkulkuun, luoda uusia luotuja sivuja tai iteroida aiemmin luotuja käyttämällä luonnollisen kielen ohjeita. Sivut voivat käyttää Microsoft Dataverse taulukoita, Power Platform -liittimiä (esikatselu) ja Dataversen mukautettuja ohjelmointirajapintoja (esikatselu).

Tekoälykoodin luontityökalujen käyttäminen luontisivujen kanssa täydentää Power Apps (make.powerapps.com) käyttöliittymäpohjaista käyttökokemusta. Tämä koodi ensin -lähestymistapa sopii kaikille tekijöille tai kehittäjille, jotka haluavat käyttää paikallisia kehitystyökaluja ja komentorivikäyttöliittymäpohjaisia työnkulkuja.

Mitä koodinmuodostustyökaluilla voi tehdä?

• Luo yksi tai useampi generatiivinen sivu yhdellä ajokerralla luonnollisella kielellä annettujen vaatimusten perusteella
• Luo tukevat Microsoft Dataverse-taulukot sivusi tarvitsevat tai käytä uudelleen olemassa olevia taulukoita, mukaan lukien uusien taulukoiden mallitiedot
• (esikatselu) Yhteyden muodostaminen Dataversen ulkopuolisiin tietoihin Power Platform -liittimien avulla
• (esikatselu) Kutsu palvelinpuolen liiketoimintalogiikkaa käyttämällä Dataversen mukautettuja ohjelmointirajapintoja
• Sijoita artefakteja uuteen tai olemassa olevaan sovellukseen ja ratkaisuun, mukaan lukien sovelluksen tai ratkaisun luominen lennosta
• Päivitä olemassa olevia luotuja sivuja pyytämällä muutoksia tai parannuksia tekoälytyökalusi kautta
• Ota käyttöön suoraan Power Apps -ympäristössä PAC CLI -komentoja käyttäen
• Käytä paikallisesti haluamiasi integroituja kehitystyökaluja ja npm install IntelliSense-tukea luodulle koodille

Toiminta

1. Voit kuvailla, mitä haluat luoda luonnollisella kielellä, esimerkiksi "Luo luodaan muodostettu sivun koontinäyttö, jossa näkyvät tärkeimmät tilit tuoton mukaan".
2. Suunnittelija-agentti analysoi pyyntösi ja ehdottaa suunnitelmaa. Suunnitelma voi sisältää yhden tai useamman sivun, Dataverse-taulukot, liittimellä suojatut tietolähteet tai mukautetut ohjelmointirajapinnat, joita sivut tarvitsevat, sekä sovelluksen ja ratkaisun, jossa artefaktit ovat. Tämän jälkeen suunnittelija delegoi erityisagentteja rakentaakseen suunnitelman kuvauksen. Esimerkiksi taulukon muodostin ja sivun muodostin.
3. Voit tarkistaa palvelupaketin ja muuttaa sitä ennen sen luomista. Voit muuttaa sivujen määrää, vaihtaa tai lisätä tietolähteitä, kohdentaa eri sovellukseen tai sijoittaa artefakteja eri ratkaisuun.
4. Asiakaspalvelijat luovat sivullesi tai sivuillesi tuotantovalmiin TypeScript- ja React-koodin sekä paikallista kehitystä tukevat tiedostot.
5. Työkalu ottaa artefaktit käyttöön ympäristössäsi luovien sivujen PAC CLI -komentojen avulla ja suorittaa valinnaisesti selaimessa vahvista selaimessa -vaiheen, joka suorittaa testit sivulla.
6. Luotu sivu näkyy mallipohjaisessa sovelluksessasi.

Vaatimukset

Varmista ennen aloittamista, että sinulla on tässä kuvattu vaaditut ohjelmistot ja käyttöoikeudet.

Ohjelmistovaatimukset

Lisävaatimukset

• Power Platform -ympäristö, jossa on mallipohjainen sovellus sivujen käyttöönottoon.
• Kohdeympäristöön yhdistetty todennettu PAC CLI -istunto .
  • Lisätietoja yhteyden muodostamisesta on kohdassa Power Platformin komentorivikäyttöliittymän todentaminen .
• Liitinpohjaisille sivuille (esikatselu) on olemassa oleva todennettu Power Platform -yhteys kutakin haluamaasi liitintä varten. Agentti voi tarvittaessa luoda yhteysviittauksen.
• Jos sivut kutsuvat Dataversen mukautettua ohjelmointirajapintaa (esikatselu), olemassa oleva tuettu mukautettu ohjelmointirajapinta kohdeympäristössä. Jos haluat toteuttaa palvelinpuolen logiikan ja näyttää sen muodostavan sivun, luo Dataverse-laajennus ja luo sitten mukautettu ohjelmointirajapinta laajennuksen rekisteröintityökalun avulla ja liitä se laajennustyyppiin. Lisätietoja määrityksistä on artikkelissa Mukautettujen ohjelmointirajapintojen luominen ja käyttäminen.
• Jos järjestelmänvalvoja haluaa viedä luotuja sivutelemetriatietoja Azure Application Insightsiin (esikatselu), järjestelmänvalvojan on määritettävä ympäristön Application Insights -tietojen vienti Power Platform -hallintakeskuksessa. Ympäristön on täytettävä Application Insights -tietojen vientivaatimukset.

Laajennuksen asentaminen

Suorita asennusohjelma, jotta voit määrittää kaikki Power Platform -laajennukset joko PowerShellissä tai Windows -komentoikkunassa.

iwr https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js -OutFile install.js; node install.js; del install.js

curl -fsSL https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js | node

Asennusohjelma automaattisesti:

• Havaitsee käytettävissä olevat työkalut (GitHub Copilot CLI, Claude Code)
• Rekisteröi laajennuksen Marketplacen ja asentaa kaikki laajennukset
• Ottaa käyttöön automaattisen päivityksen, joten laajennukset pysyvät ajan tasalla

Asennuksen jälkeen käynnistä tekoälytyökalu tarvittaessa uudelleen.

Asenna vain generatiivinen sivulaajennus

Asenna vain GitHub Copilot CLI:tä tai Claude Codea varten tarkoitettu sivulaajennus:

1. Lisää Power Platform Skills Marketplace -laajennus: /plugin marketplace add microsoft/power-platform-skills
2. Asenna Power Apps-laajennus: /plugin install model-apps@power-platform-skills

Kun laajennus on asennettu, voit käyttää laajennusta jommallakummalla seuraavista parametrista:

• Komennon suorittaminen /genpage eksplisiittisesti.
• Kuvailet luotavaa sivua. Työkalu tunnistaa laajennuksen ja käyttää sitä automaattisesti.

Muiden tekoälykoodien luontityökalujen käyttäminen

Jos käytät muita tekoälykoodien luontityökaluja, varmista, että työkalullasi on pääsy Power Platform -taitoja hyödyntävään GitHub-säilöön luotuihin sivuresursseihin. Mallisovellusten laajennuskansio sisältää komponenttidokumentaation, näytekoodin, PAC CLI -komentoviittauksen ja työnkulkuohjeet, jotka ovat tarpeen luotaessa koodia, joka noudattaa luontisivuvaatimuksia, mukaan lukien ohjeet useita kieliä ja alueita tukevien sivujen luomiseen. Säilön readme-tiedostosta saat tietoa siitä, kuinka käyttää näitä resursseja haluamallasi työkalulla.

Taitojen yleiskatsaus

Power Apps -laajennus tarjoaa tämän taidon generatiivisten sivujen käsittelemiseen.

Tämän osaamisen avulla voit kuvailla, mitä haluat luoda, ja saada tekoälytyökalun luomaan täydellisen TypeScript- ja React-koodin luontisivullesi ja ottamaan sen sitten käyttöön suoraan Power Apps ympäristössäsi.

Uuden luontisivun luominen

Seuraa tätä työnkulkua, kun luot uuden sivun tai sivujoukon alusta alkaen.

1. Aloita keskustelu tekoälytyökalullasi. Kuvaile, mitä haluat luoda. Olla niin tarkka tai avoin kuin vain haluat - mitä epämääräisempi pyyntö, sitä enemmän agentti täyttää itsensä. Voit myös liittää kuvan tai muita materiaaleja visualisointien, teeman ja asettelun ohjaamiseksi. Esimerkiksi:

   • Luo koontinäyttö, joka näyttää kymmenen parasta tiliä liikevaihdon perusteella tilitaulukon avulla
   • "Luo kaksi sivua vapaaehtoisten rekisteröitymisteni hallintaan – yksi avointen työvuorojen selaamiseen ja toinen rekisteröitymisen vahvistamiseksi – mallitietojen avulla"
   • "Luo luontisivu tapausraporttien näyttämiseksi kartalla käyttämällä Incident-taulukkoa"
   • "Luo sivu, joka näyttää tiedostoja Project tiedostoista SharePoint list."
   • "Luo tilauksen tarkistussivu, jossa on Hyväksy-painike, joka kutsuu mukautettua ohjelmointirajapintaa ApproveOrder ."

2. Valitse Luo tai muokkaa pyydettässä. Jos suunnittelijan agentti ei ole varma, haluatko uuden sivun vai päivittää aiemmin luodun sivun, se kysyy. Jos haluat noudattaa tätä työnkulkua, luo uusi sivu. Muokataksesi siirry kohtaan Muokkaa olemassa olevaa generatiivista sivua.

3. Vastaa kysymyksiin siitä, mitä luodaan. Suunnittelija voi kysyä, minkä tyyppistä sivua haluat, antaa muutamia esimerkkejä ja hyväksyä mukautetun kuvauksen, kuten käytettävät tiedot, asettelun, näytettävät tiedot, vuorovaikutukset ja niin edelleen. Tutustu erityisesti liiketoiminnan tarpeisiin ja tietovaatimuksiin, tunnista mobiilivaatimukset varhain ja mainitse käyttöliittymäkomponentit tai asetteluasetukset. Suunnittelija voi myös selventää kysymyksiä, kuten sitä, käytetäänkö Dataverse-taulukoita, Power Platform -liittimiä, mukautettuja ohjelmointirajapintoja vai pysyväiskoodatettuja mallitietoja ja lisätäänkö sivu olemassa olevaan sovellukseen vai luodaanko uusi sovellus.

4. Tarkistaa palvelupaketin ja muuttaa sitä. Suunnittelija esittelee suunnitelman, joka sisältää sivun tai sivut, jotka se aikoo luoda, Dataverse-taulukot, liitinpohjaiset tietolähteet tai mukautetut ohjelmointirajapinnat, sivun isännöintisovelluksen (uusi tai olemassa oleva) ja ratkaisun, jossa artefaktit ovat käytössä. Iteroi agentin kanssa, jotta voit säätää kaikkea, mitä haluat muuttaa – esimerkiksi sivujen määrää, mitä taulukoita tai mukautettuja ohjelmointirajapintoja käytetään, kohdesovellusta tai kohderatkaisua. Vahvista suunnitelma, kun se vastaa tarkoitustasi.

5. Anna agenttien rakentaa ja ottaa käyttöön. Erikoisagentit luovat sivun tai sivut, tukevat taulukot, liittimen tai mukautetut ohjelmointirajapinnan sidonnat ja koodin, ja ottavat sen sitten käyttöön ympäristössäsi.

6. Vahvista valinnaisesti selaimessa. Koonnin jälkeen agentti saattaa tarjota selaimessa suoritettavan tarkistusvaiheen, joka suorittaa automaattisesti luodut Playwright-testit sivua vastaan vahvistaakseen sen latautumisen ja toiminnot oikein. Tämän avulla voit saada selviä ongelmia ennen manuaalista testausta.

7. Testaa ja iteroi. Avaa mallipohjainen sovelluksesi Power Apps ja siirry uudelle sivulle. Jos sinun on tehtävä muutoksia, palaa tekoälytyökaluun ja kuvaa päivitykset luonnollisella kielellä.

Liitintietojen käyttäminen (esikatselu)

Liittimen tuen ansiosta luotu sivu voi käyttää Dataversen ulkopuolisia tietoja Power Platform -liitinekosysteemin kautta. Kaikkia Power Platform -liittimiä tuetaan.

Jos haluat käyttää liitintietoja, kuvaile palvelua ja tietoja, joita haluat sivun käyttävän kehotteessasi. Voit esimerkiksi pyytää agenttia luomaan sivun, joka näyttää SharePoint list tiedostoja. Suunnittelun aikana agentti:

1. Näyttää luettelon yhteyksistä ja yhteysviittauksista, jotka ovat käytettävissä valitussa ympäristössä.
2. Pyytää valitsemaan yhteyden. Jos yhteydellä ei ole yhteysviittausta, agentti luo sellaisen.
3. Pyytää valitsemaan liittimen tiedot, kuten tietojoukon ja taulukon tai liitintoiminnon.
4. Lisää liittimen sidonnan sivulle ja sisällyttää sen, kun sivu otetaan käyttöön.

Tarkista liittimen tietolähde suunnitelmasta ennen koontiversiota. Testaa luotua sivua käyttämällä käyttäjätietoja ja käyttöoikeuksia, joita käyttäjät voivat käyttää.

Mukautetun ohjelmointirajapinnan käyttäminen (esikatselu)

Käytä Dataversen mukautetun ohjelmointirajapinnan toimintoa tai funktiota, kun sivusi on eksplisiittisesti suoritettava palvelinpuolen liiketoimintalogiikka, kuten tilauksen hyväksyminen, hinnan uudelleenlaskenta tai tapahtuman vahvistaminen.

Jos haluat käyttää mukautettua ohjelmointirajapintaa, kuvaile toimintoa ja sitä, milloin sivun tulee kutsua sitä kehotteessa. Voit esimerkiksi pyytää agenttia lisäämään Hyväksy-painikkeen, joka kutsuu ApproveOrder mukautettua ohjelmointirajapintaa nykyisessä järjestyksessä. Suunnittelun aikana agentti:

1. Näyttää luettelon tuetuista mukautetuista ohjelmointirajapinnoista, jotka ovat käytettävissä valitussa ympäristössä.
2. Pyytää sinua valitsemaan mukautetun ohjelmointirajapinnan, jota sivun tulee kutsua.
3. Käyttää mukautetun ohjelmointirajapinnan pyyntö- ja vastausominaisuuksia, kun se luo sivun.
4. Lisää mukautetun ohjelmointirajapinnan sidonnan sivulle ja sisältää sen, kun sivu otetaan käyttöön.

Tarkista mukautettu ohjelmointirajapinta ja sen syötteet suunnitelmasta ennen koonnin hyväksymistä. Testaa luotua sivua käyttämällä käyttäjätietoja ja käyttöoikeuksia.

Luovan sivun valvonta Application Insightsin avulla (esikatselu)

Power Apps voivat viedä automaattisesti generatiivisilta sivuilta toimintatelemetriaa Azure Application Insightsiin. Tämä ominaisuus toimii samalla tavalla kuin sivuilla, jotka on luotu tekoälykoodin luontityökaluilla ja sivuilla, jotka on luotu Power Apps (make.powerapps.com).

Järjestelmänvalvojan on ensin määritettävä ympäristön Application Insights -tietojen vienti Power Platform -hallintakeskuksessa. Kun vienti on määritetty, Power Apps raportoi automaattisesti tuettua telemetriaa julkaistuilta generatiivisilta sivuilta. Kehotteen ja luodun sivukoodin ei tarvitse alustaa Application Insightsin JavaScript SDK:ta, sisällyttää yhteysmerkkijono tai lisätä telemetriakutsuja.

Automaattisesti viety telemetria sisältää:

• Valmis sivu latautuu pageViews taulukossa.
• Käsittelemättömät sivun hahmonnusvirheet ja Promise-hylkäykset exceptions-taulukossa.
• Tuetut dataApi toiminnot dependencies taulukossa.
• Siirtyminen aloitettu taulukon pageViews generatiiviselta sivulta.

Application Insights -telemetria luoville sivuille on esikatseluominaisuus. Käytettävyys voi vaihdella ympäristön mukaan ominaisuuden käyttöönoton aikana.

Asennusohjeet ovat kohdassa Tietojen vieminen Application Insightsiin. Mallipohjaisen sovelluksen telemetriarakenne ja kyselyohjeet ovat mallipohjaisten sovellusten Telemetry-tapahtumissa.

Muokkaa aiemmin luotua sivua

Tämän työnkulun avulla voit päivittää ympäristössäsi jo olevan sivun.

1. Nouda olemassa oleva sivu. Pyydä tekoälykoodin luontityökalussasi noutamaan olemassa oleva luotu sivu antamalla sivutunnus (GUID) tai sivun nimi sivustokartassa ja sovellus, jossa se on. Esimerkiksi "Haluan päivittää Lemmikkien käyttöönotto -luontisivun esittelysovelluksesta".

2. Kuvaile päivitykset. Kerro tekoälytyökalulle, mitä muutoksia haluat tehdä. Esimerkiksi:

   • "Lisää suodatin, joka näyttää vain aktiiviset tietueet"
   • "Muuta asettelua niin, että kortit näytetään ruudukossa luettelon sijaan"
   • "Lisää kaavio, joka näyttää käyttöönoton trendit ajan kuluessa"
   • "Päivitä lomake sisältämään uusi mukautettu kenttä lemmikkien temperamenttia varten"

3. Tarkastele, julkaise, testaa ja iteroi. Tekoälytyökalu luo päivitetyn TypeScript-koodin pyydettyjen muutosten perusteella. Noudata samaa tarkastelu-, julkaisu- ja testiprosessia, joka on kuvattu "Uuden luontisivun luominen" -osiossa. Jatka iteroimista luonnollisen kielen ohjeilla, kunnes sivu täyttää vaatimuksesi.

Paikalliset kehitystiedostot

Kun tekoälytyökalu luo sivun, se kirjoittaa myös kaksi tukitiedostoa paikalliseen työtilaasi, jotta koodin tarkistus ja iterointi on helpompaa:

• package.json — määrittää suorituksenaikaiset ja kehitysriippuvuudet, joita vasten luotu sivu on käännetty. Suorita npm install generoinnin jälkeen asentaaksesi nämä riippuvuudet.
• genpage.d.ts — ympäristöympäristön TypeScript-esittelyt objekteille, joita ei ole asennettu npm:llä, kuten dataApi ja pageInput.

Kun molemmat tiedostot ovat paikallaan ja npm install valmiit, editorisi IntelliSense, kuten VS Codessa, toimii luodun koodin kanssa, joten voit tarkastella sivua tai muokata sitä käsin ilman, että tiedoissa on punaisia koukelmia ratkaisemattomissa tyypeissä.

Määritä sivu hyväksymään syöteparametreja

Luodut sivut voivat hyväksyä syöteparametrit recordId, entityNameja , joiden dataavulla he voivat vastaanottaa tilannekohtaisia tietoja, kun niihin siirrytaan toiselta sivulta tai koodista. Kun ohjeistat tekoälytyökalua määrittämään syöteparametrit, se luo asianmukaisen alustuskoodin, jotta sivu lukee ja käyttää kyseisiä arvoja latautuessaan.

Kuvaile kehotteeseen haluamiasi parametreja:

• "Määritä sivu hyväksymään Account recordId ja entityName. Kun sivu latautuu, nouda ja näytä vastaavat tilitiedot näiden parametrien avulla."
• "Määritä tämä sivu hyväksymään tietoparametri, joka sisältää mukautetun suodatinobjektin. Sen avulla voit suodattaa näytettävät tietueet, kun sivu latautuu."

Jos haluat siirtyä sivulle ja välittää nämä parametrit, katso Siirtyminen luontisivulle ja sieltä pois asiakkaan ohjelmointirajapinnan avulla.

Lokalisointi

Kun luot muodostavan sivun Power Apps taidolla, lokalisointi käsitellään automaattisesti. Agentti tunnistaa kaikki kielet, jotka ovat käytössä ympäristössäsi, ja luo koodin niin, että sivu toimii kaikkien näiden kielten kanssa. Sivulla noudatetaan kunkin käyttäjän haluamaa kieltä ja päivämäärien, lukujen ja valuutan alueellisia muotoiluasetuksia.

Jos haluat kohdentaa eri kielijoukon kuin ympäristössäsi käyttöön otetut, voit pyytää agenttia sopeutumaan esimerkiksi seuraavasti:

"Päivitä tämä sivu tukemaan vain englantia, ranskaa ja espanjaa."

Lisätietoja on Power Platform skills -säilön lokalisointiohjeiden kohdassa.

Vianetsintä

Sivun lataaminen Power Appsissa epäonnistuu

Jos siirryt luontisivulle ja huomaat virhesanoman tai tyhjän näytön:

1. Avaa selaimen kehittäjätyökalut (F12 useimmissa selaimissa).

2. Valitse Konsoli-välilehti .

3. Kopioi koko virhesanoma, mukaan lukien pinon jäljitys.

4. Palaa tekoälykoodin luontityökaluun ja liitä virhe kontekstiin:

   "Saan tämän virheilmoituksen, kun avaan sivun: [liitä virhe tähän]. Korjaa ongelma."

   Tekoälytyökalu analysoi virheen, tunnistaa pääsyyn ja luo korjauksen.

5. Tarkista korjaus ja pyydä työkalua julkaisemaan sivu uudelleen.

Toimivan version palaaminen

Jos viimeaikaiset muutokset ovat rikkoneet sivusi tai pahentaneet ongelmia, voit pyytää tekoälytyökalua palaamaan aiempaan toimivaan versioon:

"Viimeisimmät muutokset rikkoivat sivun. Palauta viimeisin toimiva versio."

Tekoälytyökalu:

1. Tunnistaa tehdyt muutokset
2. Palauttaa edellisen työkoodin
3. Palauttaa vakaan version

Parhaat käytännöt

• Aloita yksinkertaisesti. Aloita sivun perusversiolla ja lisää monimutkaisuutta iteroimalla.
• Testaa usein. Ota sivusi käyttöön ja testaa se jokaisen merkittävän muutoksen jälkeen.
• Ole tarkka. Anna yksityiskohtaisia vaatimuksia parempien alkutulosten saamiseksi.
• Käytä olemassa olevia malleja. Viittaa vastaaviin sivuihin tai käyttöliittymäkuvioihin, kun kuvaat vaatimuksiasi.
• Vahvista luotu koodi. Tarkista aina luotu koodi varmistaaksesi, että se täyttää organisaatiosi standardit ja yhteensopivuusvaatimukset.

Rajoitukset

Tekoälykoodin luontityökaluilla luotuja sivuja koskevat samat rajoitukset kuin Power Appsin maker-portaalissa luoduilla luontisivuilla:

• Tuettuja tietolähteitä ovat Dataverse-taulukot ja (esikatselu) Power Platform -liittimet.
• Mukautettuja ohjelmointirajapintatoimintoja ja -funktioita tuetaan esikatselussa. Mukautettuja ohjelmointirajapintoja, jotka käyttävät EntityCollection-sidontatyyppiä tai entiteettiparametreja , ei tueta.
• Yhteistyötä ei tueta – varmista, että vain yksi tekijä työskentelee muodostavaa sivua kerrallaan.
• Vain näitä tietotyyppejä tuetaan: valinta, valuutta, asiakas, päivämäärä ja aika, vain päivämäärä, desimaaliluku, liukuluku, kuva, haku, monirivinen teksti, tila, tilan syy, teksti, kokonaisluku, kyllä/ei, yksilöllinen tunnus.

Liittyvä sisältö

• Luo sivu luonnollisella kielellä mallipohjaisilla sovelluksilla
• Siirtyminen luontisivulle ja sieltä pois asiakkaan ohjelmointirajapinnan avulla
• dataApi-objektimenetelmät luoville sivuille
• Power Platform -komentorivikäyttöliittymän viittaus