Copilot Managed Runtime アプリ開発スキル
Microsoft Copilot Managed Runtime のアプリを、CLI（@microsoft/managed-apps-cli、コマンド ms）と
SDK（@microsoft/managed-apps）で最初から作る。手順は Microsoft Learn の
CLI クイックスタート
に沿う。
[!CAUTION]
Public Preview。 API・テンプレート・ツールは GA までに変わる可能性がある。
本番利用はユーザーの明示承認がある場合に限り、SDK / CLI / Vite plugin の版を固定する。
Code Apps との境界
| 要件 | 選ぶもの |
|---|
| GA 必須、Azure B2B ゲスト、Dataverse ソリューション / Power Platform Pipelines 中心、使う人のほとんどが Power Apps Premium を持つ | code-apps |
| Microsoft 365 の社内業務アプリ、Git のコミット単位で preview / live / rollback、M365 管理センターで一元管理 | 本スキル |
| Power Apps Premium を持たない人が中心で利用が不定期。Copilot Credits の従量課金で払いたい | 本スキル |
@microsoft/power-apps を @microsoft/managed-apps に置き換えるだけの移行はしない。
判断材料は 比較リファレンス。
スクリプト
パラメータは references/.env.example を参照し、実値は .env に置く。
ワークフロー
Step 0: Preview 利用とライセンスを確認する
AskUserQuestion で次を確認し、承認がなければ code-apps を提案して止まる。
- Public Preview であること。
- 使う人ごとの支払い方法。Power Apps Premium を持つ人はクレジットを消費しない。持たない人は
Managed Application Copilot Credits で払う（起動ごとと API 呼び出しごと。API 呼び出しは 1 回 0.1 クレジット）。
ローカル実行する開発者にも同じ要件がかかる。
- クレジットで払う人がいる場合は、管理者が M365 管理センター → Copilot → Cost management で従量課金を有効にし、
使う人を実行用の支出ポリシーに入れる。作るときの課金設定とは別。見積もり方は
比較リファレンスのライセンス節。
- アプリは組織内向け。組織内共有リンクはゲストに使えない。
- 既定 CSP は外部通信を遮断する。外部 API はコネクタ経由で呼ぶ。
Step 1: 開発前提を確認する
python .github/skills/managed-runtime/scripts/check_prereqs.py --install-cli
MANAGED_APPS_CLI_VERSION の版を導入し、Node.js >= 24.11.0、Git >= 2.27.0、Git Credential Manager、
Git の user.name / user.email を確認する。NG が 1 つでもあれば解消してから進む。
Step 2: サインインする
ms auth login
python .github/skills/managed-runtime/scripts/check_prereqs.py --check-auth
ms auth status のアカウントが対象テナントであることを確認する。
Step 3: リポジトリ方式を決める
作成後は変更できないため、AskUserQuestion で確定してから作る。
| 選択肢 | --repo-mode | 選ぶ条件 |
|---|
| platform-managed Git（既定） | platform | 設定なしで始めたい。clone / push は通常の Git で行える |
| 自社 GitHub | github | PR レビュー・ブランチ保護を統制に使う。既存の空の private リポジトリを用意する |
| 外部ビルド | none | 自前の CI でビルドして配備する。管理者による外部成果物デプロイの許可が必要 |
github は GitHub.com / GitHub Enterprise Cloud（*.ghe.com）のみ。対象 organization に
GitHub App「Microsoft Managed Apps」を導入しておく。
Copilot Code・Cowork・Copilot Studio で作ったアプリとの関係は repository-modes.md。
Step 4: アプリを作成する（または既存アプリを引き継ぐ）
新規作成は dry-run で検証してから実行する。
python .github/skills/managed-runtime/scripts/create_app.py `
--display-name "<表示名>" --dir ./<app-folder> --repo-mode platform --dry-run
python .github/skills/managed-runtime/scripts/create_app.py `
--display-name "<表示名>" --dir ./<app-folder> --repo-mode platform
自社 GitHub は --repo-mode github --repo-url https://github.com/<org>/<repo> を付ける。
スクリプトは作成先が空か、アプリが入れ子にならないか、URL の形式、リポジトリが private かつ空かを
CLI 実行前に検証する。既存の Web プロジェクトを登録する場合は、そのフォルダーで
ms app init --display-name "<表示名>" --repo native|none|<url> を実行する。
既存アプリ（Copilot Cowork / Copilot Studio / 他の開発者が作成）を引き継ぐ場合:
ms app list --permission edit
ms app clone --app <app-id> ./<app-folder> # 自社 GitHub のアプリは git clone <repository-url>
Step 5: ローカルで開発する
Set-Location ./<app-folder>
npm install
ms app dev
ms app dev が唯一のローカル起動コマンド。表示された Local Play URL を、テナントにサインインしている
ブラウザー プロファイルで開く。まだ何もデプロイされていないことをユーザーに伝える。
UI は React + TypeScript で実装し、SDK はサブパス（@microsoft/managed-apps/auth など）から import する
（sdk-usage.md）。
Step 6: データソースを追加する
ms connector list --search <語>
ms connector list-actions --connector <connector-id>
ms app add data-source --connector <connector-id> --as table --table <table>
ms connector list の DLP / ACP 状態で、使うコネクタと操作がブロックされていないことを確認する。
特定の環境（--environment-id）に作った場合は、admin スキル の環境チェックと DLP 事前チェックも実行する。- 追加後は
generated/ のサービスを import して呼ぶ。fetch / axios で直接呼ばない。
- 追加後に
ms.config.json を読み、sharedConnectionId が付いた共有接続があれば、
画面の実装後に allowedActions を決めて宣言する（sdk-usage.md）。
Step 7: 検証して push し、preview で確認する
python .github/skills/managed-runtime/scripts/validate_project.py --project . --build
git add .
git commit -m "<変更内容>"
git push
ms app play --mode preview
NG が 0 件になってから push する。preview は push 済みの最新コミットをビルドして表示する。
ビルドに失敗したら ms app build-status --show-log で原因を確認し、直して push し直す。
preview URL は書き込み権限を持つ開発者だけが開ける。
Step 8: live へデプロイする
python .github/skills/managed-runtime/scripts/validate_project.py --project . --stage deploy
ms app deploy
ms app info
--stage deploy は未 commit・未 push と共有接続の allowedActions も NG にする。
ユーザーが preview を確認して承認してから ms app deploy を実行する。
戻すときは ms app deploy --commit <sha> で過去の成功ビルドを指定する。
Step 9: 共有する
ms app share <user-email>,<group-object-id> --access play
ms app share <developer-email> --access edit
利用者は play、共同開発者だけ edit。組織全体に配る場合は ms app share link create。
利用者は managedapps.cloud.microsoft からアプリを開く。
Step 10: CI を構成する（外部ビルド方式のみ）
--repo-mode none で作ったアプリは、テンプレートから GitHub Actions のワークフローを生成する。
python .github/skills/update-skills/scripts/scaffold_from_template.py `
--template .github/skills/managed-runtime/templates/github-actions-deploy `
--target . --force --dry-run
サービス プリンシパルの権限とシークレットの登録は github-actions.md。
platform / github 方式は Step 7・8 のプラットフォーム ビルドを使う。
出力
最後に次を報告する: アプリ名と App ID、プロジェクトのパス、リポジトリ方式と Git remote、
追加したコネクタ、validate_project.py の結果、preview / live URL（ms app info）、共有先。
実行していない手順（deploy・共有など）は「未実施」と書く。
参考