Copilot マネージド ランタイムのアーキテクチャ

Copilot マネージド ランタイムのアーキテクチャは、次の要素で構成されています:

  • Copilot マネージド ランタイム SDK (@microsoft/cmr-apps)
  • Microsoft Copilot マネージド ランタイム CLI (@microsoft/cmr-cli)
  • コネクタ用に生成されたモデルとサービス
  • ms.config.json構成ファイル
  • アプリの Git リポジトリ (プラットフォームで管理されるリポジトリまたは指定した外部 GitHub リポジトリのいずれか)
  • Microsoft Copilot マネージド ランタイム ホスト

Copilot マネージド ランタイム アーキテクチャ: マネージド ホストは顧客 SPA を実行し、Launch、アプリ資産と API コネクタを提供するランタイム ゲートウェイに接続し、データ ソース、エージェント、Work IQ と Cowork に直接接続します。

これらのパーツが開発、公開、実行時の実行を通じてどのように連携するかを理解することで、より成功することができます。 詳細については、次の記事を参照してください。

  • 各レイヤーのロール: コード、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 サーフェスを超えてアプリ コードに規則を課すことはありません。