Copilot Managed Runtime-Architektur

Die Copilot Managed Runtime-Architektur besteht aus:

  • Das Copilot Managed Runtime SDK (@microsoft/cmr-apps)
  • Die Microsoft Copilot Managed Runtime-CLI (@microsoft/cmr-cli)
  • Generierte Modelle und Dienste für Connectors
  • Die ms.config.json Konfigurationsdatei
  • Das Git-Repository der App, entweder das plattformseitig verwaltete Repository oder ein externes GitHub-Repository, das Sie bereitstellen
  • Der Microsoft Copilot Managed Runtime-Host

Copilot Managed Runtime-Architektur: Ein verwalteter Host führt die Kunden-SPA aus und stellt eine Verbindung zu Launch, zu einem Laufzeitgateway her, das App-Ressourcen und API-Connectors bereitstellt, und direkt zu Datenquellen, Agents und Work IQ und Cowork.

Wenn Sie verstehen, wie diese Teile bei Entwicklung, Veröffentlichung und Laufzeitausführung zusammenarbeiten, werden Sie erfolgreicher. Lesen Sie diesen Artikel, um mehr zu erfahren:

  • Die Rolle der einzelnen Ebenen: Ihr Code, das Copilot Managed Runtime SDK und der Copilot Managed Runtime-Host.
  • Wie Modelle und Dienste generiert und genutzt werden, wenn Sie Connectors hinzufügen oder entfernen.
  • Was verpackt und veröffentlicht wird, wenn Sie ms app deploy.

App-Entwicklung

Eine TypeScript- oder JavaScript-Single-Page-Anwendung (SPA) ist eine Voraussetzung für die Verwendung von Apps. Die Copilot Managed Runtime-CLI erstellt ein Projekt, das bereits das Copilot Managed Runtime SDK enthält. Zusammen ermöglichen die CLI und das SDK die Verwendung von Connectors und das Hosten in einer Copilot Managed Runtime-Umgebung.

Komponente Beschreibung
ms.config.json Eine Datei, die von der Copilot Managed Runtime-CLI generiert wurde und Metadaten enthält. Die CLI und das SDK lesen diese Metadaten, um Verbindungen zu verbinden und die App in einer Umgebung bereitzustellen. Es wird nicht erwartet, dass Ihre App-Logik direkt mit ms.config.json ihr interagiert.
Copilot Managed Runtime SDK Das @microsoft/cmr-apps npm-Paket. Sie macht typisierte APIs verfügbar, die Ihre App direkt aufruft, und enthält die Logik, die Modelle und Dienste verwaltet, wenn Verbindungen zur App hinzugefügt oder daraus entfernt werden.
Copilot Managed Runtime-CLI Das @microsoft/cmr-cli npm-Paket, aufgerufen als ms. Es erstellt Apps, erstellt Projekte, verwaltet Connectors und stellt sie auf der Copilot Managed Runtime-Plattform bereit.
Git-Repository Das Git-Repository ist die einzige Quelle der Wahrheit. Es kann auf der Plattform bereitgestellt werden oder ein externes GitHub-Repository sein, das Sie bereitstellen. Erstellt und stellt den Flow aus echten Commits in diesem Repository bereit.

Wichtig

Nicht direkt bearbeiten ms.config.json . Die CLI und das SDK besitzen diese Datei, und manuelle Änderungen können dazu führen, dass der lokale Zustand Ihrer App nicht mehr mit der Plattform synchronisiert ist. Aktualisieren Sie stattdessen den Inhalt über die entsprechenden ms Befehle. Zum Beispiel zum ms app add data-source Registrieren eines Connectors oder ms app set-setting zum Ändern von App-Einstellungen.

Laufzeit

Wenn eine App ausgeführt wird, verwendet sie drei logische Komponenten:

  • Ihr Code
  • Das Copilot Managed Runtime SDK: macht APIs verfügbar, die Ihr Code verwendet, sowie die generierten Modelle und Dienste, die Ihre App verwendet, um Datenanforderungen über Connectors auszuführen.
  • Der Copilot Managed Runtime-Host: verwaltet die Endbenutzerauthentifizierung über Microsoft Entra, Laden von Apps, Laufzeitgovernance (bedingter Zugriff, DLP, ACP, Freigabelimits) und zeigt kontextbezogene Meldungen an, wenn die App nicht geladen werden kann.

Projektdateien

Die Copilot Managed Runtime-CLI erstellt ein Standard-SPA-Projektlayout. Die für Apps spezifischen Dateien sind:

Datei oder Ordner Zweck
ms.config.json App-Metadaten, einschließlich der App-ID, der gebundenen Umgebung und der registrierten Connectors. Diese Datei wird vom CLI und dem SDK verwaltet. Bearbeiten Sie die Datei nicht direkt. Verwenden Sie ms Befehle wie ms app set-setting "oder ms app add data-source ", um den Inhalt zu aktualisieren.
generated/ Stark typisierte Modelle und Dienste, die generiert von ms app add data-source. Ihr Code wird aus diesem Ordner importiert, um Datenquellen aufzurufen.
package.json Schließt das Copilot Managed Runtime SDK als Abhängigkeit und alle Frameworkskripts ein, die Ihr Projekt verwendet.

Der Rest des Projekts, einschließlich Komponenten, Routen, Stile und Tests, ist das, was dein Framework erfordert. Copilot Managed Runtime erzwingt keine Konventionen für Ihren App-Code, die über die SDK-API-Oberfläche hinausgehen.