uipath-test スキルを使用した劇作家によるテスト オートメーション (プレビュー)

uipath-test スキルを使用して、コードを変更することなく、既存の Playwright スイートを UiPath Test Manager に取り込むことができます。

注:

この機能はプレビュー版です。プレビュー機能は運用用途ではサポートされておらず、機能が制限される場合があります。

この uipath-test スキルを使用すると、サポートされているコーディング エージェントが、コードを変更せずに既存の Playwright テスト スイートを取得し、UiPath Test Manager に取り込むことができます。

平易な言葉でエージェントに尋ねると、エージェントは Test Manager プロジェクトを作成し、スイートをパッケージ化して Orchestrator にアップロードし、リンクされたテスト ケースの自動作成、テスト セットの構築、実行を行い、成功、失敗、スキップの結果を報告します。

テストが失敗した場合は、エージェントにテストの修正、再パッケージ化、再パブリッシュ、再実行をすべてターミナルから依頼できます。このスキルがなければ、既存の Playwright スイートを Test Manager に取り込むには、テストを UiPath のオートメーションとして書き直す必要があります。このフローでは、Playwright のコードは変更されずにパッケージ化されます。

前提条件

• UiPath CLI (uip) をインストールし、認証済み (uip login)。このフローで使用される --playwright-projects フラグには、CLI バージョン 1.200.0 以降が必要です。
• コーディング エージェント用にインストールされた UiPath スキル (uip skills install --agent <agent>) - uipath-test スキル バンドルがインストールされます。
• Test Manager に取り込むプロジェクトにローカルにインストールされ、npm とともにインストールされた Playwright ( package-lock.json が存在する必要があります)。このスキルは、既存のスイートをそのままパッケージ化し、Playwright を自動的にインストールすることはありません。

スイートを Test Manager に取り込む

1. Playwright プロジェクトのルート フォルダーでコーディング エージェントを開きます。

2. スイートを Test Manager に取り込むように依頼します。

   「自分のウェブサイト [製品名] をテストするために劇作家のスクリプトをいくつか書きました。UiPath の Test Manager サービスを使用してこれらのテストを実行するのを手伝っていただけますか?」

3. 最初の実行時に、エージェントの設定に関する質問に回答します。つまり、テストをどの Test Manager プロジェクトに配置するか (または新しいプロジェクトを作成するかどうか)、どの Playwright スコープ ( regression、 smoke、 checkout-criticalなど) を最初に実行するかを示します。

4. エージェントが報告する成功、失敗、スキップの概要を確認します。実際のアサーションの不一致のように見える失敗と、環境やインフラストラクチャの問題などを含めます。

結果:

エージェントは背後で Test Manager プロジェクトとその既定の Orchestrator 実行フォルダーを作成し、Playwright プロジェクトを .nupkgにパッケージ化して、Orchestrator パッケージ フィードにアップロードします。

Test Manager は、検出されたテストごとに 1 つのテスト ケースを自動作成して自動リンクします。次に、エージェントは、選択した Playwright プロジェクトを対象範囲としたテスト セットを作成し、それを実行し、実行が完了するまでポーリングを行います。

失敗したテストを修正して再実行する

エージェントに修正を依頼して再実行します。

「失敗したテストを修正し、スモーク テスト セットを再実行してください。」

エージェントは、失敗したテスト コードを修正してから、変更されたパッケージ バージョンで再パッケージ化し、再アップロードして、同じテスト セットを再実行します。Playwright のプロジェクトとスコープの選択はテスト セット上で保持されるため、再指定する必要はありません。

警告:

修正後に uip tm executions retry を使用して再実行するようエージェントに依頼しないでください。このコマンドは、以前の実行の失敗を 古い パッケージ バージョンに対して再実行します。これは、このループの逆です。代わりに、エージェントは --package-versionをバンプし、再パッケージ化して再アップロードしてから、同じテスト セットを再実行します。

コマンド リファレンス

これらのコマンドはエージェントによってプロンプトから自動的に選択されます。ユーザーが自分で入力する必要はありません。これらは、トラブルシューティングや、CI で同じフローをスクリプト化する場合に役立ちます。

手順	コマンド
Test Manager プロジェクトの作成	uip tm project create --name "SwagLabs" --project-key SWAG --description "..." --output json
既定の実行フォルダーを設定する	uip tm project set-default-folder --project-key SWAG --folder-key <key> --output json
Playwright プロジェクトをパッケージ化する	uip tm pack --project-path . --type playwright --project-key SWAG --name SwagLabsPlaywright --package-version 1.0.0 -o .packages --output json
Orchestrator にアップロード	uip or packages upload ".packages/SwagLabsPlaywright.1.0.0.nupkg" --output json
取り込まれたテスト ケースのポーリング	uip tm testcases list --project-key SWAG --output json
Playwright プロジェクトを対象範囲としたテスト セットを実行します	uip tm testsets run --test-set-key SWAG:37 --playwright-projects regression --output json
実行のステータスと結果をポーリングする	uip tm report get --execution-id <id> --project-key SWAG --output json
トリアージのプル失敗の詳細	uip tm executions testcaselogs list --execution-id <id> --project-key SWAG --only-failed --output json

注:

uip tm testcases list は --limit フラグを取りません。

参照

• テスト — コーディング エージェントが Test Manager で実行できることの完全なリストです。
• uip tm pack — このフローで使用されるパッケージ化コマンドの完全なリファレンスです。
• uip tm testsets — testsets run と --playwright-projects フラグの完全なリファレンスです。
• uip or packages — Orchestrator にパッケージをパブリッシュするための完全なリファレンスです。