Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.jsonKonfigurationsdatei - Das Git-Repository der App, entweder das plattformseitig verwaltete Repository oder ein externes GitHub-Repository, das Sie bereitstellen
- Der Microsoft Copilot Managed Runtime-Host
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.