Konfigurieren und Verwalten von Verbindungen

Agents verwenden Tools und Wissen, um Aktionen im Auftrag von Benutzern durchzuführen und relevante kontextbezogene Informationen zu sammeln. Diese Tools und Wissensquellen werden häufig in externen Systemen gespeichert, z. B. in Microsoft Dataverse, Microsoft SharePoint oder anderen APIs. Für den sicheren Zugriff auf diese Ressourcen müssen sich Agents authentifizieren, um Verbindungen herzustellen. Der Agent kann je nach Szenario die Agent-Autorenauthentifizierung oder die Benutzerauthentifizierung verwenden.

In Microsoft Copilot Studio werden Verbindungen verwendet, um sicher auf authentifizierte Dienste für Tools und Wissen zuzugreifen. Sie können Verbindungen zu verschiedenen Datenquellen erstellen, z. B. zu Microsoft Dataverse, Microsoft SharePoint oder externen APIs.

Agentenverbindungen anzeigen und verwalten

In Copilot Studio können Sie die von Ihrem Agent verwendeten Verbindungen auf der Seite Verbindungseinstellungen anzeigen und konfigurieren.

Auf der Seite Verbindungseinstellungen können Sie die von Ihrem Agent verwendeten Verbindungen konfigurieren und verwalten. Sie können vorhandene Verbindungen anzeigen, neue erstellen und Verbindungen bearbeiten oder trennen, ganz nach Bedarf.

Verbindungen auf der Seite „Verbindungseinstellungen“ anzeigen

1. Navigieren Sie zu Ihrer Agent-Seite in Copilot Studio, indem Sie Agents auswählen und dann den Agent auswählen, den Sie betrachten möchten.

   Die Agentenübersichtseite wird geöffnet.

2. Wählen Sie Einstellungen aus, um die Seite mit den Einstellungen des Agents zu öffnen.

3. Wählen Sie im linken Navigationsbereich Verbindungseinstellungen aus.

Eine Liste wird in einer Tabelle mit allen Verbindungen angezeigt, die Ihrem Agent zugeordnet sind. Für jede Verbindung können Sie den Namen, die Tools und die Wissensquellen über die Verbindung, den Verbindungsstatus und das Datum der letzten Aktualisierung der Verbindung anzeigen.

Verbindungen filtern

Wenn Sie über viele Verbindungen auf Ihrem Agent verfügen, können Sie sie filtern, um eine eingegrenztere Ansicht zu erhalten und die gewünschte Verbindung zu finden. Sie können verschiedene Filter anwenden, um Verbindungen basierend auf ihrem Status anzuzeigen, darunter z. B. Aktiviert/Deaktiviert, Verbunden/Nicht verbunden, Deaktiviert, Abgelaufen oder Verbindungsfehler.

Wählen oder erstellen Sie eine Verbindung

1. Wählen Sie unter Status für den Verbindungseintrag in der Liste Verwalten aus, um den Bereich Verbindung erstellen oder auswählen zu öffnen.

2. Öffnen Sie die Konfiguration Verbindung . Wählen Sie eine vorhandene Verbindung aus der Liste aus, oder klicken Sie auf Neue Verbindung erstellen, um eine neue zu erstellen.

   Wenn Sie Neue Verbindung erstellen auswählen, wird ein Bereich zum Einrichten der Verbindung geöffnet. Sie werden ggf. aufgefordert, sich beim Dienst anzumelden oder zusätzliche Informationen bereitzustellen, um die Verbindungseinrichtung abzuschließen.

3. Wenn Sie fertig sind, wählen Sie Übermitteln aus, um die Änderungen zu speichern.

   Die Verbindung ist jetzt mit Ihrem Agenten verknüpft, und Ihr Agent kann die Verbindung verwenden, um auf die Tools und Wissensquellen zuzugreifen.

Verbindungsparameter konfigurieren

Wählen Sie unter Verwalten für den Verbindungseintrag in der Liste Details anzeigen aus, um weitere Details zur Verbindung anzuzeigen.

Informationen werden auf zwei Registerkarten angezeigt:

• Details: Zeigt den Verbindungsnamen, die Beschreibung, den Status und die Erstellungsdetails an.
• Verbindungsparameter: Zeigt die Verbindungsparameter an, z. B. Authentifizierungsdetails, API-Schlüssel oder andere erforderliche Informationen, und ermöglicht Ihnen die Konfiguration der Details.

Verbindungsparametern für die On-Behalf-Of-(OBO-)Authentifizierung freigeben

Bei einigen Verbindungen, die einmaliges Anmelden (Single Sign-On, SSO) unterstützen, können Sie die Verbindung so einrichten, dass die OBO-Authentifizierung (On-Behalf-Of) verwendet wird. Bei einem OBO-Flow delegiert der Benutzer den Agent, um die freigegebenen Verbindungsparameter für den Dienst im Namen des Benutzers zu verwenden. Dies ist hilfreich, wenn der Agent auf Ressourcen zugreifen muss, die benutzerspezifische Berechtigungen erfordern, oder wenn Aktionen im Kontext der Identität eines Benutzers ausgeführt werden müssen.

Die Parameterfreigabe für OBO aktivieren

Unter Verbindungsparameter für den Verbindungseintrag in der Liste können Sie dem Benutzer erlauben, die Freigabe bestimmter Verbindungsparameter zu autorisieren.

1. Aktivieren Sie unter Verbindungsparameter die Option Berechtigung zum Teilen von Parametern gewähren.

   

2. Wählen Sie die Kontrollkästchen der Parameter aus, die der Benutzende freigeben darf.

   Der Benutzer wird aufgefordert, die Berechtigung für diese Parameter zu erteilen, wenn der Agent die OBO-Authentifizierung verwendet.

Benutzererfahrung für die OBO-Authentifizierung

Wenn der Agent die OBO-Authentifizierung verwendet, wird der Benutzer aufgefordert, dem Agent die Berechtigung zur Verwendung seiner Verbindungsparameter zu erteilen. Der Benutzer kann diese Berechtigung erteilen oder verweigern. Wenn der Benutzer sie erteilt, kann der Agent im Auftrag des Benutzers auf Ressourcen zugreifen und Aktionen ausführen. Der Agent stellt mithilfe der freigegebenen Verbindungsparameter transparent eine Verbindung mit dem Dienst bereit.

Zugehöriger Inhalt

• OBO-Authentifizierung für benutzerdefinierte Connectors konfigurieren