Създавайте и редактирайте генеративни страници с AI инструменти за генериране на код

Тази статия описва как да използвате инструментите за генериране на AI код, като например GitHub Copilot CLI, за да създавате и редактирате жанративни страници за приложения, управлявани от модел, в Power Apps. Като използвате този подход, можете да интегрирате разширените възможности за генериране на код директно във вашия работен поток за разработване, за да създадете нови жанративни страници или да итерирате на съществуващи такива с помощта на инструкциите за естествен език.

Съвет

Този подход е препоръчителният път за създаване на жанеративни страници. Той ви дава достъп до най-новите погранични модели на ИИ, работи в цял свят върху публични облаци и ви позволява да създадете няколко страници с поддържащи таблици Dataverse или източници на данни за конектори за Power Platform в едно изпълнение.

Използването на инструменти за генериране на AI код с жанеративни страници допълва работата, базирана на потребителски интерфейс, в Power Apps (make.powerapps.com). Този подход, пригоден за код, е подходящ за всеки създател или разработчик, който иска достъп до най-новите модели на ИИ или предпочита да работи с инструменти за локално разработване и базирани на CLI работни потоци.

Бележка

За да планирате, съставите или редактирате цялото базирано на модел приложение вместо отделните жанративни страници, използвайте умението на модела на конструктора на приложения. За повече информация вижте Създаване и редактиране на приложения, управлявани от модел, с инструменти за генериране на AI код.

Какво можете да направите с инструменти за генериране на код

  • Създайте една или повече генеративни страници в един пробег от изисквания за обикновен език
  • Създайте поддържащите Microsoft Dataverse таблици които вашите страници имат нужда, или използвайте съществуващите, включително примерни данни за нови таблици
  • (Предварителен преглед) Свързване към данни извън Dataverse с помощта на конектори за Power Platform
  • Поставете артефакти в ново или съществуващо приложение и решение, включително създаване на приложение или решение в движение
  • Актуализирайте съществуващите генеративни страници , като заявите промени или подобрения чрез вашия AI инструмент
  • Deploy direct във вашата Power Apps среда чрез PAC CLI команди
  • Работете локално с предпочитания от вас IDE и инструменти за разработка, с npm install поддръжка на IntelliSense за генерирания код

Как работи

  1. Описваш какво искаш да изградиш на естествен език, например: "Създай генеративно табло на страница, показващо топ акаунти по приходи."
  2. Агент по планове анализира вашата заявка и предлага план. Планът може да включва една или повече страници, таблиците Dataverse или източниците на данни с конектор, от които се нуждаят страниците, и приложението и решението, където се живеят артефактите. След това плановикът делегира на специализирани агенти да изградят това, което планът описва. Например, конструктор на таблици и конструктор на страници.
  3. Преглеждаш и коригираш плана преди строеж. Можете да промените броя на страниците, да размените или добавите източници на данни, да насочите към друго приложение или да поставите артефактите в друго решение.
  4. Агентите генерират готов за продукция TypeScript и React код за вашата страница или страници, заедно с поддържащи файлове за локална разработка.
  5. Инструментът внедрява артефактите във вашата среда чрез генеративни PAC CLI команди на страницата и по желание изпълнява стъпка за проверка в браузъра, която тренира страницата с генерирани тестове.
  6. Вашата генеративна страница се появява в приложението, управлявано от модели.

Предварителни изисквания

Преди да започнете, уверете се, че имате необходимия софтуер и разрешения, описани тук.

Софтуерни изисквания

Компонент Минимална версия Допълнителна информация
Node.js 18.0 или по-късно Изтеглете Node.js
Power Platform CLI (PAC CLI) Последни новини Инсталиране на PAC CLI
GitHub Copilot CLI, Claude Code или друг инструмент за генериране на код Последни новини GitHub Copilot CLI или Клод код

Допълнителни изисквания

  • Power Platform среда с приложение, управлявано от модели, за разгръщане на страници.
  • Автентифицирана PAC CLI сесия, свързана с целевата среда.
  • За страници със съединители – съществуваща връзка на Power Platform за всеки конектор, който искате да използвате.

Бележка

Тази възможност е достъпна по целия свят в публични облаци.

Инсталирай плъгина

Стартирай инсталатора, за да настроиш всички плъгини на Power Platform или в команден прозорец на PowerShell, или в Windows команден прозорец.

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

Инсталаторът автоматично прави:

  • Открива наличните инструменти (GitHub Copilot CLI, Claude Code)
  • Регистрира пазара на плъгини и инсталира всички плъгини
  • Активира автоматично обновяване, за да останат плъгините актуални

След инсталация, рестартирайте AI инструмента, ако е необходимо.

Инсталирай само плъгина за генеративна страница

За да инсталирате само генеративния плъгин за страница за GitHub Copilot CLI или Claude Code:

  1. Добавете плъгина Power Platform Skills marketplace: /plugin marketplace add microsoft/power-platform-skills
  2. Инсталирай плъгина Power Apps: /plugin install model-apps@power-platform-skills

Бележка

За Claude Code можеш да инсталираш плъгина с различни обхвати, като глобален, локален или потребителски. В зависимост от обхвата, трябва да сте в правилната директория, за да може Claude Code да използва плъгина. Отидете в Разширяване на Клод с умения.

След като го инсталирате, можете да използвате плъгина по един от двете:

  • Изрично изпълняване /genpage на командата.
  • Описание на страницата, която искате да създадете. Инструментът автоматично открива и използва плъгина.

Съвет

Включете автоматичното обновяване, за да получавате автоматично актуализации на пазара и уменията. Използвайте /plugin командата, отидете в Marketplaces, изберете пазара и включете автоматичното обновление.

Използване на други AI инструменти за генериране на код

За други инструменти за генериране на AI код, уверете се, че вашият инструмент има достъп до ресурсите на генеративните страници от хранилището Power Platform skills GitHub. Папката с плъгини за модел-приложения включва документация на компоненти, примерен код, референция на командите PAC CLI и инструкции за работен процес, необходими за създаване на код, отговарящ на изискванията за генеративна страница, включително как да се създават страници, поддържащи множество езици и региони. Консултирайте се с readme за информация относно достъпа и използването на тези ресурси с предпочитания от вас инструмент.

Преглед на уменията

Плъгинът Power Apps предоставя това умение за работа с генеративни страници.

Умение Command Описание
Генеративни страници /genpage Създаване на код за генеративни страници (за създаване или редактиране на сценарии)

Това умение ви позволява да опишете какво искате да създадете и AI инструментът да генерира пълен TypeScript и React код за вашата генеративна страница, след което да го разположи директно във вашата Power Apps среда.

Създайте нова генеративна страница

Следвайте този работен процес, когато създавате нова страница или набор от страници от нулата.

  1. Започнете разговор с вашия AI инструмент. Опишете какво искате да създадете. Бъдете толкова конкретни или отворени, колкото искате — колкото по-неясна е заявката, толкова повече агентът сам попълва. Можете също да прикачите изображение или други материали, които да насочват визуализациите, тематиката и оформлението. Например:

    • "Създайте генеративно табло за страница, показващо нашите топ 10 акаунта по приходи чрез таблицата Account"
    • "Създайте две страници за управление на доброволческите ми записвания — една за разглеждане на свободни смени и една за потвърждаване на записване — използвайки примерни данни"
    • "Създайте генеративна страница за показване на доклади за инциденти на карта, използвайки таблицата за инциденти"
    • "Създаване на страница, която показва документи от Project файлове SharePoint list."

  2. Изберете create или edit, ако ви поиска. Ако агентът по плановици не е сигурен дали искате нова страница или да обновите съществуваща, той пита. За да следвате този работен процес, изберете да създадете нова страница. За редактиране отидете на Редактиране на съществуваща генеративна страница.

  3. Отговаряй на въпроси какво да строиш. Планировчикът може да попита какъв вид страница искате, да ви предложи няколко примера и да приеме персонализирано описание, като например какви данни да използва, оформление, каква информация да показва, взаимодействия и т.н. Бъдете конкретни относно бизнес нуждите и изискванията за данни, идентифицирайте мобилните изисквания рано и споменете всички UI компоненти или предпочитания за оформление. Планировчикът може също да задава разясняващи въпроси, като например дали да използва таблици Dataverse, конектори на Power Platform или пробни данни с твърдо кодиране, както и дали да добави страницата към съществуващо приложение, или да създаде ново приложение.

  4. Прегледайте и коригирайте плана. Планировчикът представя план, който включва страницата или страниците, които възнамерява да създаде, таблиците dataverse или източниците на данни с конектори, които да се използват, приложението за хостване на страницата (нова или съществуваща) и решението, където се живеят артефактите. Итерирайте с агента, за да коригирате всичко, което искате да се промени — например броя страници, кои таблици се използват или създават, целевото приложение или целевото решение. Потвърдете плана, когато съответства на вашето намерение.

  5. Нека агентите изграждат и внедряват. Специализираните агенти генерират страницата или страниците, поддържащите таблици или свързващите връзки и кода, след което ги разположат във вашата среда.

  6. По желание проверете в браузъра. След изграждането агентът може да предложи да стартира стъпка за проверка в браузъра, която изпълнява автоматично генерирани тестове на Playwright върху страницата, за да се потвърди, че се зарежда и функционира правилно. Използвайте това, за да откриете очевидни проблеми преди да тествате ръчно.

  7. Тествайте и усъвършенствайте. Отворете вашето приложение, управлявано от модели, в Power Apps и преминете към новата страница. Ако трябва да направите промени, върнете се към AI инструмента и опишете актуализациите на естествен език.

Бележка

Можете да промените името или позицията на генеративната страница в sitemap по всяко време от дизайнера на приложения, управляван от модела.

Използване на данни на конектора (предварителен преглед)

Важно

Поддръжката на конектори е функция за предварителен преглед. Функциите за предварителен преглед не са предназначени за производствена употреба и може да са с ограничена функционалност.

Поддръжката на конектори позволява на генеративна страница да използва данни извън Dataverse чрез екосистемата на конектора на Power Platform. Всички конектори за Power Platform се поддържат.

За да използвате данни за конектори, опишете услугата и данните, които искате страницата да използва във вашата подкана. Например помолете агента да създаде страница, която показва документи от SharePoint list. По време на планирането агентът:

  1. Изброява връзките и препратките към връзки, налични в избраната среда.
  2. Иска от вас да изберете връзка. Ако връзката няма препратка към връзка, агентът създава такава.
  3. Иска от вас да изберете данните на конектора, като например набор от данни и таблица или операция на конектор.
  4. Добавя свързването на конектора към страницата и го включва, когато страницата е разположена.

Прегледайте източника на данни за конектора в плана, преди да одобрите компилацията. Тествайте генерираната страница с самоличностите и разрешенията, които вашите потребители ще използват.

Редактирай съществуваща генеративна страница

Използвайте този работен процес, за да актуализирате страница, която вече съществува във вашата среда.

  1. Изтеглете съществуващата страница. В инструмента за генериране на AI код поискайте да получите съществуващата генеративна страница, като предоставите ID на страницата (GUID) или името на страницата в картата на сайта и приложението, в което се намира. Например, "Искам да актуализирам генеративната страница за осиновяване на домашни любимци от приложението Demo."

  2. Опишете вашите актуализации. Кажете на AI инструмента какви промени искате да направите. Например:

    • "Добавете филтър, който да показва само активни записи"
    • "Промени разположението да показва картите в мрежа вместо в списък"
    • "Добавете графика, показваща тенденциите на приемане във времето"
    • "Актуализирайте формуляра, за да включите новото персонализирано поле за темперамента на домашните любимци"

  3. Преглеждай, публикувай, тествай и усъвършенствай. AI инструментът генерира обновен TypeScript код въз основа на поисканите от вас промени. Следвайте същия процес на преглед, публикуване и тестване, описани в секцията "Създаване на нова генеративна страница". Продължавай да работиш с инструкции на естествен език, докато страницата отговаря на изискванията ти.

Локални файлове за разработка

Когато AI инструментът генерира страница, той също така записва два поддържащи файла във вашето локално работно пространство, за да улесни прегледа и итерацията на кода:

  • package.json — обявява зависимостите за изпълнение и разработката, срещу които генерираната страница компилира. Стартирай npm install след генериране, за да инсталираш тези зависимости.
  • genpage.d.ts — амбиентни TypeScript декларации за обекти, които не са инсталирани чрез npm, като dataApi и pageInput.

Когато и двата файла са на място и npm install завършени, IntelliSense на вашия редактор, както във VS Code, работи срещу генерирания код, така че можете да преглеждате или редактирате страницата ръчно, без да виждате червени извивки за неразрешени типове.

Настройте страница, която да приема входни параметри

Генеративните страници могат да приемат входните параметри recordId, entityName, и data, което им позволява да получават контекстуални данни при навигация от други страници или код. Когато инструктирате AI инструмента да конфигурира входните параметри, той генерира подходящия код за инициализация, така че страницата да чете и използва тези стойности при зареждане.

Опишете параметрите, които искате в вашата заявка:

  • "Настройте страницата да приема Account recordID и entityName. Когато страницата се зареди, използвайте тези параметри, за да изтеглите и покажете съответните данни за акаунта."
  • "Конфигурирайте тази страница да приема параметър на данни, съдържащ персонализиран филтърен обект. Използвай го, за да филтрираш показаните записи, когато страницата се зарежда."

За да преминете към страницата и да преминете през тези параметри, вижте Навигация до и от генеративна страница чрез Client API.

Локализация

Когато създавате жанеративна страница с помощта на Power Apps умение, локализацията се обработва автоматично. Агентът открива всички езици, включени във вашата среда, и генерира код, така че страницата да работи с всички тези езици. Страницата уважава предпочитания от всеки потребител език и регионални предпочитания за форматиране за дати, числа и валута.

Ако искате да насочите към различен набор от езици от тези, които са активирани във вашата среда, можете да помолите агента да го коригира, например:

"Актуализирайте тази страница, за да поддържа само английски, френски и испански."

Бележка

Записът в sitemap за генеративна страница по подразбиране не е локализиран. За да локализирате записите в sitemap, обновете ги отделно в дизайнера на приложения.

За повече информация посетете инструкциите за локализация в хранилището Power Platform Skills.

Отстраняване на неизправности

Страницата не успява да се зареди в Power Apps

Ако отидете на вашата генеративна страница и забележите съобщение за грешка или празен екран:

  1. Отворени инструменти за разработка на браузъри (F12 в повечето браузъри).

  2. Изберете таба Console .

  3. Копирайте цялото съобщение за грешка, включително стековата следа.

  4. Върнете се към вашия AI инструмент за генериране на код и поставете грешката с контекст:

    "Получавам тази грешка при отваряне на страницата: [поставяй грешка тук]. Моля, оправи проблема."

    AI инструментът анализира грешката, идентифицира коренната причина и генерира поправка.

  5. Прегледайте поправката и помолете инструмента да препубликува страницата.

Връщане към работеща версия

Ако скорошни промени са повредили страницата ви или са влошили проблема, можете да помолите AI инструмента да върне към предишна работеща версия:

"Последните промени счупиха страницата. Моля, върнете се към последната работеща версия."

Инструментът за изкуствен интелект тогава:

  1. Идентифицира промените, които са направени
  2. Възстановява предишния работен код
  3. Преразпределя стабилната версия

Най-добри практики

  • Започнете просто. Започнете с базова версия на страницата си и итерирайте, за да добавите сложност.
  • Тествайте често. Разгръщайте и тествайте страницата си след всяка значителна промяна.
  • Бъдете конкретни. Осигурете подробни изисквания за по-добри първоначални резултати.
  • Използвайте съществуващи модели. Позовавай се на подобни страници или модели на потребителски интерфейс, когато описваш изискванията си.
  • Валидирайте генерирания код. Винаги преглеждайте генерирания код, за да сте сигурни, че отговаря на стандартите и изискванията за съответствие на вашата организация.

Важно

Докато AI инструментите за генериране на код правят най-добрия опит да генерират пълен, готов за продукция код с най-добри практики за достъпност и сигурност, вие в крайна сметка сте отговорни за валидирането на кода. Уверете се, че генерираният код отговаря на стандартите, политиките и изискванията за съответствие на вашата организация.

Ограничения

Ограниченията за генеративни страници, създадени с AI инструменти за генериране на код, са същите като тези за генеративни страници, създадени в портала Power Apps maker:

  • Поддържаните източници на данни са таблици на Dataverse и (предварителен преглед) конектори за Power Platform.
  • Сътрудничеството не се поддържа — уверете се, че само един създател работи върху една генеративна страница едновременно.
  • Поддържат се само следните типове данни: Избор, Валута, Клиент, Дата и час, Само дата, Десетично число, Число с плаваща запетая, Изображение, Търсене, Многоредов текст, Статус, Причина за статус, Текст, Цяло число, Да/Не, Уникален идентификатор.

Свързано съдържание

  • Last updated on