Freigeben über

Aktualisieren einer Fähigkeit zur Unterstützung von Einzelmandanten- und Multitenant-Agents

Copilot Studio-Benutzer können fähigkeiten in Copilot Studio implementieren.

Anmerkung

Weitere Informationen finden Sie unter Einschränkung desselben Mandanten.

Diese Fähigkeiten verfügen über die folgenden Artefakte, die sich auf Multitenant- und Einzelmandantenimplementierungen beziehen:

  • Eine Entra-ID-App-Registrierung
  • bereitstellung (auch als Deskriptor bezeichnet)
  • Quellcode

Der Copilot Studio-Agent ruft die Fähigkeiten basierend auf dem Bot Framework SDK auf, wie in der folgenden Abbildung dargestellt:

Grafik, die den Anruffluss zwischen einem Copilot Studio-Agent und einer Bot Framework-Fähigkeit veranschaulicht.

In diesem Szenario treten die folgenden Aktionen auf:

  • Copilot Studio erstellt das Token gemäß der App-Registrierungseinstellung. Bei neu erstellten Copilot Studio-Agents ist dies ein Mandant, was bedeutet, dass die Tokengruppe auf dieselbe Mandanten-ID wie der Agent festgelegt ist.
  • Copilot Studio akzeptiert nur Token für die Mandanten-ID, in der sich der Agent befindet, oder für den Bot Framework-Mandanten.
  • Entra-ID gibt nur Token für den Bot Framework-Mandanten aus, wenn die Fähigkeit multitenant ist.

Für Fähigkeiten, die bereits auf demselben Mandanten wie der Copilot Studio-Agent bereitgestellt wurden, aber die Fähigkeit wird von einem vorhandenen Mehrinstanzen-Agent verwendet, müssen Sie die Multiinstanzenfähigkeit aktualisieren, um auch ein Einzelmandanten-Qualifikationstoken zu akzeptieren.

  1. Aktualisieren Sie die Überprüfungskonfiguration der Qualifikation so, dass sie die Mandanten-ID des Agents enthält. Beginnen Sie beispielsweise mit dem Hinzufügen dieses Codes zum Startup.cs Ihrer Fähigkeiten. Aktualisieren Sie Zeile 38 des Codeausschnitts, um die Mandanten-ID-Zeichenfolge inline anzugeben.

  2. Legen Sie in der Konfiguration Ihrer Fähigkeiten nicht fest MicrosoftAppTenantId.

  3. Behalten Sie den Wert MicrosoftAppType in der Konfiguration auf MultiTenant.

  4. Erstellen Sie die Fähigkeiten, und stellen Sie sie erneut bereit.

  5. Die Anwendungsregistrierung der Qualifikation muss sich im selben Mandanten wie Ihr Agent befinden, um mit einem Einzelmandanten zu arbeiten.

Sie können jetzt die aktualisierte Fähigkeit zu einem Einzelmandanten- oder Mehrinstanzen-Agent hinzufügen. Für jeden Copilot Studio-Agent muss die Fähigkeit mit ihrer Anwendungsregistrierung im Mandanten bereitgestellt werden, in dem der Agent mit der Fähigkeit erstellt wurde.