Freigeben über


Erste Schritte mit Bot Framework Composer

Wichtig

Power Virtual Agents-Fähigkeiten und -Funktionen sind jetzt Teil von Microsoft Copilot Studio nach erheblichen Investitionen in generative KI und verbesserte Integrationen in Microsoft Copilot.

Einige Artikel und Screenshots beziehen sich möglicherweise auf Power Virtual Agents während wir Dokumentation und Schulungsinhalte aktualisieren.

Anmerkung

Microsoft Copilot Studio unterstützt diese Funktion jetzt ohne Composer.

Um den Bot Framework Composer zur Erweiterung Ihres Microsoft Copilot Studio-Bots zu verwenden, müssen Sie Ihren Bot zuerst in ein Composer-Projekt importieren.

Anforderungen

Öffnen Sie Ihren Bot in Composer

Wichtig

Sie sollten den Composer immer von Microsoft Copilot Studio aus öffnen. Damit wird sichergestellt, dass Composer über alle erforderlichen Plug-Ins verfügt, die für die Integration in Microsoft Copilot Studio erforderlich sind.

  1. Gehen Sie auf die Seite Themen für den Bot, den Sie bearbeiten möchten, und wählen Sie das Pfeil-nach-unten-Symbol neben + Neues Thema aus.

  2. Wählen Sie In Bot Framework Composer öffnen im Dropdownmenü, um Ihren Bot im Composer zu öffnen.

    Screenshot der Schaltfläche zum Öffnen eines Bots in Composer.

  3. Wenn Sie Composer noch nicht installiert haben:

    1. Wählen Sie Composer herunterladen aus.

      Screenshot des hervorgehobenen Links zum Herunterladen des Composers.

    2. Wählen Sie im Fenster Bot Framework Composer herunterladenComposer herunterladen aus.

      Screenshot des Fensters Microsoft Copilot Studio Composer, das angibt, dass Composer nicht installiert ist.

    3. Wenn der Download abgeschlossen ist, führen Sie ihn aus, um Composer zu installieren.

    4. Nachdem Sie Composer installiert haben, gehen Sie zurück zu Microsoft Copilot Studio. Gehen Sie zurück zur Seite Themen und wählen Sie das Pfeil-nach-unten-Symbol neben + Neues Thema aus.

      Anmerkung

      In einigen Fällen blockiert eine Firewall möglicherweise einige Funktionen in Composer, und Sie müssen möglicherweise den Zugriff explizit zulassen. Details erhalten Sie von Ihrem Administrator.

  4. Wenn Microsoft Copilot Studio Composer nicht automatisch starten kann, können Sie ihn manuell starten:

    1. Wählen Sie Link kopieren, um den Link in die Zwischenablage zu kopieren.

      Screenshot der Schaltfläche „Link kopieren“.

    2. Öffnen Sie eine neue Registerkarte und fügen Sie den Link in die Adressleiste Ihres Webbrowsers ein.

  5. Wenn Sie einen Microsoft Copilot Studio Bot zum ersten Mal in Composer öffnen, wird er in ein neues Composer-Projekt importiert. Der Name, den Sie in Microsoft Copilot Studio angegeben haben, wird automatisch als Name für das Projekt verwendet, aber Sie können auch einen benutzerdefinierten Namen eingeben.

    Screenshot des Bildschirms zum Importieren in Composer.

  6. Wählen Sie Erstellen aus, um den Import Ihres Bots in Composer abzuschließen.

    Screenshot des Importieren-Bildschirms in Composer mit hervorgehobener Schaltfläche „Erstellen“.

Testen Sie Composer-Inhalte innerhalb von Microsoft Copilot Studio

Sie können den Bot Framework Emulator kann nicht zum Testen von Composer-Inhalten verwenden, die für Microsoft Copilot Studio Bots erstellt wurden. Stattdessen müssen Sie Ihre Composer-Inhalte auf Ihrem Microsoft Copilot Studio Bot veröffentlichen und dann den Bereich „Testbot“ verwenden.

Wichtig

Wählen Sie Veröffentlichen in Composer stellt die Änderungen zum Testen zur Verfügung, veröffentlicht jedoch nicht automatisch Ihren Bot.

Veröffentlichen Sie Ihren Bot in Microsoft Copilot Studio, um ihn auf allen Kanälen, mit denen er verbunden ist zu aktualisieren.

  1. Gehen Sie zur Seite Veröffentlichen.

    Screenshot der Registerkarte „Veröffentlichen“ in Composer.

  2. Wählen Sie in der Bot-Liste Ihren Bot und dann Ausgewählte Bots veröffentlichen aus.

    Screenshot des für die Veröffentlichung ausgewählten Bots.

  3. Geben Sie optional eine Nachricht für Kommentare ein und wählen Sie dann Okay aus.

    Screenshot des Veröffentlichungsfensters.

  4. Wechseln Sie nach Abschluss der Veröffentlichung zu Microsoft Copilot Studio. Möglicherweise müssen Sie die Seite aktualisieren, um die neuen Themen anzuzeigen, die Sie in Composer hinzugefügt haben.

  5. Öffnen Sie den Bereich Testbot und beginnen Sie eine Unterhaltung, indem Sie einen Triggerausdruck eingeben.

Das Veröffentlichungsprotokoll anzeigen

Wenn Sie Probleme beim Veröffentlichen Ihres Composer-Inhalts in Microsoft Copilot Studio haben, können Sie zur Fehlerbehebung das Veröffentlichungsprotokoll durchgehen. Das Veröffentlichungsprotokoll enthält eine detaillierte Beschreibung aller Warnungen oder Fehler, die während der Prüfung aufgetreten sind, sowie Vorschläge zu deren Behebung.

Anmerkung

Wenn Sie Probleme mit Ihrem Microsoft Copilot Studio Bot haben, verwenden Sie stattdessen die Themenprüfung.

  1. Gehen Sie im Composer zur Seite Veröffentlichung.

  2. Wählen Sie den Rechtspfeil (>) neben Ihrem Bot aus. Möglicherweise müssen Sie das Composer-Fenster vergrößern, damit der Pfeil sichtbar wird.

    Screenshot des Rechtspfeils.

  3. Wählen Sie unter VeröffentlichungsverlaufProtokoll anzeigen aus.

    Screenshot der Schaltfläche „Protokoll anzeigen“ unter „Veröffentlichungsverlauf“.

  4. Überprüfen Sie im Fenster Veröffentlichungsprotokoll die Protokolle auf Fehler oder Warnungen.

    Screenshot des Veröffentlichungsprotokolls.

Wenn Sie bei der Entwicklung in Composer auf Probleme stoßen, können Sie:

Nächste Schritte,

Um Ihnen den Einstieg in die Verwendung von Composer zu erleichtern, haben wir vier Beispiele erstellt, die verschiedene Szenarien beschreiben: