Hinzufügen eines Anzeigenamensuffixs zur Identifizierung von Agents in umgebungenübergreifenden Umgebungen (Vorschau)

[Dieser Artikel ist die Vorabveröffentlichungsdokumentation und unterliegt Änderungen.]

Wenn Sie dieselbe Agentlösung in mehreren Umgebungen (Entwicklung, Test und Produktion) bereitstellen, verwenden alle Agentinstanzen denselben Anzeigenamen in Microsoft Teams und Microsoft 365 Copilot. Daher könnten Benutzer Schwierigkeiten haben, zu erkennen, zu welcher Umgebung ein Agent gehört.

Um dieses Problem zu beheben, konfigurieren Sie ein Kanalanzeigenamensuffix , das einen Umgebungsvariablenwert an den Anzeigenamen Ihres Agents in Teams und Microsoft 365 Copilot anfügt. Da Umgebungsvariablen in jeder Umgebung unterschiedliche Werte aufweisen können, zeigt Ihr Agent automatisch den richtigen Umgebungsbezeichner ohne Änderungen an der Lösung selbst an.

Wenn Ihr Agent beispielsweise "HR Support Agent" heißt und Sie eine Suffix-Umgebungsvariable konfigurieren:

Umgebung Umgebungsvariablenwert Anzeigename in Teams
Allgemeine Tastaturbelegung (Entwicklung) HR-Support-Agent (Entwicklung)
Testen (Test) HR Support Agent (Test)
Produktion (leer) HR-Supportmitarbeiter

Schein

Der Anzeigename des Agents in Copilot Studio ändert sich nicht. Das Suffix wird nur in den veröffentlichten Kanälen (Teams und Microsoft 365 Copilot) angezeigt.

Wichtig

Dieser Artikel enthält die Vorschaudokumentation von Microsoft Copilot Studio und kann geändert werden.

Vorschaufunktionen sind nicht für den Produktionsgebrauch gedacht und verfügen möglicherweise über eingeschränkte Funktionalität. Diese Funktionen stehen vor dem offiziellen Release zur Verfügung, damit Sie früher Zugriff darauf erhalten und Feedback geben können.

Wenn Sie einen produktionsreifen Agenten erstellen, finden Sie weitere Informationen unter Übersicht über Microsoft Copilot Studio.

Voraussetzungen

Konfigurieren des Suffixes des Kanalanzeigenamens

  1. Öffnen Sie in Copilot Studio den Agent, den Sie konfigurieren möchten.

  2. Wählen Sie "Einstellungen" und dann " Erweitert" aus.

  3. Suchen Sie unter Lösungen das Feld Kanalanzeigename-Suffix.

  4. Wählen Sie im Dropdownmenü eine Umgebungsvariable aus, die als Suffix verwendet werden soll. Es werden nur Umgebungsvariablen vom Typ "String " aufgeführt.

    Um ein zuvor konfiguriertes Suffix zu entfernen, löschen Sie die Auswahl, damit das Feld leer ist.

  5. Wählen Sie Speichern.

  6. Veröffentlichen Sie Ihren Agent , damit die Änderungen in Teams und Microsoft 365 Copilot wirksam werden.

Wichtig

Nur Umgebungsvariablen vom Typ "String " werden für das Suffix des Kanalanzeigenamens unterstützt. Andere Umgebungsvariablentypen, z. B. "Zahl" oder "JSON", werden nicht in der Dropdownliste angezeigt.

Funktionsweise mit Anwendungslebenszyklusverwaltung und Lösungsbereitstellungen

Wenn Sie Lösungen für die Anwendungslebenszyklusverwaltung verwenden, ist die Lösung die Quelle der Wahrheit für Ihre Agentkonfiguration. Die Einstellung für das Suffix des Kanalanzeigenamens ist Teil der Lösung. Wenn Sie die Bereitstellung ausführen, wird das Anzeigenamensuffix in allen Umgebungen beibehalten.

Da Sie immer eine verwaltete Lösung bereitstellen, ändert sich nichts in Ihren Zieltest- oder Produktionsumgebungen, mit Ausnahme der Umgebungsvariablenwerte, die Sie pro Umgebung aktualisieren können. Sie können Power Platform-Pipelines verwenden, um die Variablenwerte ihrer Lösung bereitzustellen und umgebungsvariable Werte im Rahmen des Bereitstellungsprozesses zu aktualisieren.

Beispiele:

  1. Erstellen Sie in Ihrer Entwicklungsumgebung eine Zeichenfolgenumgebungsvariable (z. Bdev_EnvironmentDescription. ) mit einem Standardwert von (Development).

  2. Konfigurieren Sie das Kanalanzeigenamensuffix des Agents, um diese Umgebungsvariable zu verwenden.

  3. Exportieren Sie die Lösung, und stellen Sie sie in Ihrer Testumgebung bereit. Aktualisieren Sie den Wert der Umgebungsvariable auf (Test).

  4. Stellen Sie die Lösung in Ihrer Produktionsumgebung bereit. Lassen Sie den Wert der Umgebungsvariable leer, damit dem Agentnamen nichts angefügt wird.

Wichtig

Die Umgebungsvariable sollte sich in derselben Lösung wie Ihr Agent befinden. Umgebungsvariablen aus anderen Lösungen werden in der Dropdown-Liste angezeigt, sind jedoch bei der Bereitstellung möglicherweise in der Zielumgebung nicht vorhanden, was dazu führt, dass das Suffix nicht angewendet wird.

Unterstützte Kanäle

Das Suffix für den Kanalnamen wird nur angewendet, wenn Sie Ihren Agenten in den folgenden Kanälen veröffentlichen:

  • Microsoft Teams
  • Microsoft 365 Copilot

Diese Einstellung wirkt sich nicht auf andere Kanäle wie Facebook, SharePoint oder benutzerdefinierte Websites aus.