Copilot マネージド ランタイムのアーキテクチャは、次の要素で構成されています:
- Copilot マネージド ランタイム SDK (
@microsoft/cmr-apps) - Microsoft Copilot マネージド ランタイム CLI (
@microsoft/cmr-cli) - コネクタ用に生成されたモデルとサービス
-
ms.config.json構成ファイル - アプリの Git リポジトリ (プラットフォームで管理されるリポジトリまたは指定した外部 GitHub リポジトリのいずれか)
- Microsoft Copilot マネージド ランタイム ホスト
これらのパーツが開発、公開、実行時の実行を通じてどのように連携するかを理解することで、より成功することができます。 詳細については、次の記事を参照してください。
- 各レイヤーのロール: コード、Copilot マネージド ランタイム SDK、Copilot マネージド ランタイム ホスト。
- コネクタを追加または削除するときにモデルとサービスが生成および使用される方法。
-
ms app deployを実行するときにパッケージ化および公開される内容。
アプリ開発
アプリを使用するには、TypeScript または JavaScript シングルページ アプリケーション (SPA) が前提条件になります。 Copilot マネージド ランタイム CLI は、Copilot マネージド ランタイム SDK が既に含まれているプロジェクトをスキャフォールディングします。 CLI と SDK を組み合わせることで、アプリはコネクタを使用し、Copilot マネージド ランタイム環境でホストできるようになります。
| コンポーネント | 説明 |
|---|---|
ms.config.json |
メタデータを含む Copilot マネージド ランタイム CLI によって生成されたファイル。 CLI と SDK はこのメタデータを読み取り、接続を接続し、アプリを環境にデプロイします。 アプリ ロジックは ms.config.json と直接対話することは想定されていません。 |
| Copilot マネージド ランタイム SDK |
@microsoft/cmr-apps npm パッケージ。 アプリが直接呼び出す型指定された API を公開し、接続がアプリに追加または削除されるときにモデルとサービスを管理するロジックが含まれています。 |
| Copilot マネージド ランタイム CLI |
@microsoft/cmr-cli npm パッケージで、ms として呼び出されます。 アプリを作成し、プロジェクトをスキャフォールディングし、コネクタを管理し、Copilot マネージド ランタイム プラットフォームに展開します。 |
| Git リポジトリ | Git リポジトリは信頼できる唯一のソースです。 プラットフォームでプロビジョニングすることも、指定した外部 GitHub リポジトリにすることもできます。 このリポジトリ内の実際のコミットからフローをビルドして配置します。 |
重要
ms.config.json直接編集しないでください。 このファイルは CLI と SDK によって所有されるため、手動で編集すると、アプリのローカル状態がプラットフォームと同期しなくなる可能性があります。 代わりに適切な ms コマンドを使用して内容を更新します。たとえば、 ms app add data-source を使用してコネクタを登録するか、 ms app set-setting を使用してアプリの設定を変更します。
ランタイム
アプリは、実行時の 3 つの論理コンポーネントを使用します。
- ご利用コード
- Copilot マネージド ランタイム SDK: コードが使用する API と、コネクタを介してデータ要求を実行するためにアプリが使用する生成されたモデルとサービスを公開します。
- Copilot マネージド ランタイム ホスト: Microsoft Entra、アプリの読み込み、ランタイム ガバナンス (条件付きアクセス、DLP、ACP、共有制限) を通じてエンドユーザー認証を管理し、アプリの読み込みに失敗した場合はコンテキスト メッセージを表示します。
プロジェクト ファイル
Copilot マネージド ランタイム CLI は、標準の SPA プロジェクト レイアウトをスキャフォールディングします。 アプリに固有のファイルは次のとおりです。
| ファイルまたはフォルダー | 用途 |
|---|---|
ms.config.json |
アプリ ID、バインドされた環境、登録済みコネクタを含むアプリ メタデータ。 CLI と SDK は、このファイルを管理します。 直接編集しないでください。
ms app set-setting や ms app add data-source などの ms コマンドを使用して、その内容を更新します。 |
generated/ |
ms app add data-source によって生成された厳密に型指定されたモデルとサービス。 データ ソースを呼び出すコードは、このフォルダーからインポートされます。 |
package.json |
依存関係として Copilot マネージド ランタイム SDK と、プロジェクトで使用するフレームワーク スクリプトが含まれます。 |
コンポーネント、ルート、スタイル、テストなど、プロジェクトの残りの部分は、フレームワークが要求するものになります。 Copilot マネージド ランタイムは、SDK API サーフェスを超えてアプリ コードに規則を課すことはありません。