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.
Eine Agent-Flotte ist eine Reihe von Agents, die auf einer freigegebenen Cloud-Runtime ausgeführt werden. Eine Plattform, über die Teams oder Kunden ihre eigenen Agenten bereitstellen können, hosten beispielsweise jeden neuen Agenten auf derselben Compute- und Codebasis. Jeder Agent in der Flotte erhält seine eigene Agent-Identität, sodass seine Anmeldungen, Berechtigungen und Überwachungsdatensätze von den anderen Agents getrennt bleiben.
Die Laufzeitumgebung enthält eine einzelne Agentidentitätsblueprint-Anmeldeinformation und verwendet sie zum Abrufen von Token für jede Agentidentität, die über diesen Blueprint erstellt wurde. Die Laufzeit wählt aus, welche Agentidentität für jede Tokenanforderung verwendet werden soll.
Wählen Sie zwischen einem einzelnen Agenten und einer Flotte
| Consideration | Einzelner Agent | Agent-Flotte |
|---|---|---|
| Anzahl der Agents pro Bereitstellung | Eins | Viele, hinzugefügt und entfernt zur Laufzeit |
| Beim Erstellen von Agentidentitäten | Bevor der Agent von einem Entwickler oder Administrator bereitgestellt wird | Wenn jeder Agent von der Laufzeit oder von Agent 365 bereitgestellt wird |
| Woher die Agentidentitäts-ID stammt | Configuration | Ein Lookup für jede Anforderung |
| So wird der Zugriff gewährt | Für die Agentidentität, bevor der Agent bereitgestellt wird | Zu jeder Agentidentität, wenn der Agent bereitgestellt wird |
| Guidance | Erstellen von Cloud-Agents mit ASP.NET Core oder dem Auth SDK-Sidecar | Dieser Artikel und die darauf folgenden Flottenartikel |
Die Flottenlaufzeit wählt die Identität eines Agenten für jeden Vorgang aus. Folgen Sie den Flottenbeispielen im Verlauf dieses Leitfadens: Die Cloud-Agent-Tutorials verwenden eine konfigurierte Identität und lassen die für eine Flotte erforderliche Identitätsauswahl pro Anforderung aus.
Components
| Component | Purpose | Cardinality |
|---|---|---|
| Agentenidentitätsentwurf | Definiert die Berechtigungen, den eingehenden Geltungsbereich und die App-Rollen der Flotte. Erstellt und löscht Agentidentitäten. | Eine pro Flotte oder eine pro Agenttyp |
| Blueprint-Anmeldedaten | Authentifiziert die Laufzeit als Blueprint. Verwenden Sie eine verwaltete Identitätsverbund-Anmeldeinformation in der Produktion. | Eine pro Blueprint |
| Agentidentität | Stellt einen Agenten dar. Empfängt die Zugriffstoken, die zum Aufrufen von APIs verwendet werden. | Einer pro Agent |
| Benutzerkonto des Agenten | Gibt einem Agent ein Benutzerobjekt für Microsoft 365 Workloads, z. B. ein Postfach oder eine Teams-Mitgliedschaft. | Optional, höchstens eine pro Agentidentität |
| Agentverzeichnis | Der Speicher der Laufzeit, der jeden Agenten seiner Agentidentität und dem Benutzerkonto des Agenten zuordnet. | Eine pro Flotte |
| Bereitstellungsdienst | Erstellt und löscht Identitäten, wenn Agents bereitgestellt und zurückgezogen werden. | Eine pro Flotte |
| Token-Broker | Erwirbt Token für eine bestimmte Agentidentität. Microsoft.Identity.Web im Laufzeitprozess oder im Auth SDK-Sidecar. | Eine oder mehrere pro Laufzeit |
Agent-Lebenszyklus
- Bereitstellen. Ein Benutzer oder eine Pipeline stellt einen neuen Agent in der Runtime bereit.
- Bereitstellung. Der Bereitstellungsdienst erstellt eine Agentidentität aus dem Blueprint. Wenn der Agent Microsoft 365-Benutzerfunktionen benötigt, erstellt er auch das Benutzerkonto eines Agenten. Es zeichnet beide IDs im Agentverzeichnis auf, und der Agentidentität wird der Zugriff gewährt, den dieser Agent benötigt.
- Ausführen. Für jeden Vorgang sucht die Laufzeit die Identität des Agents im Agentverzeichnis und übergibt sie an den Tokenbroker.
- Stilllegen. Der Bereitstellungsdienst löscht das Benutzerkonto des Agents und dann die Agentidentität und entfernt den Agentverzeichniseintrag.
Auswählen, wie Agents bereitgestellt werden
| Auswahl | Funktionsweise | Verwenden Sie ihn, wenn |
|---|---|---|
| Die Laufzeit stellt Identitäten bereit. | Der Bereitstellungsdienst authentifiziert sich als Blueprint und ruft Microsoft Graph auf, um Agentidentitäten und die Benutzerkonten des Agenten zu erstellen und zu löschen. | Die Laufzeit steuert die Agentbereitstellung. |
| Agent 365 provisioniert Identitäten | Agent 365 erstellt die Agentidentität, wenn ein Agent bereitgestellt wird. Die Laufzeit lauscht auf Agentbereitstellungsereignisse, die die Agent-Identitäts-ID enthalten, und zeichnet sie im Agentverzeichnis auf. | Agents werden über Microsoft 365 Funktionen erstellt. Ausführliche Informationen finden Sie in der Agent 365-Entwicklerdokumentation. |
Beide Optionen erzeugen denselben Agent-Verzeichniseintrag. Die restlichen Flottenleitlinien gelten für beide Optionen.
Auswählen der Agentidentität bei jeder Anforderung
Die Blueprint-Anmeldeinformationen können Token für jede agent-Identität abrufen, die aus dem Blueprint erstellt wurde. Der Laufzeitcode, der die Agentidentität auswäht, ist daher eine Sicherheitsgrenze.
- Auflösen der Agentidentität aus dem Agentverzeichnis mithilfe eines Schlüssels, der von der Laufzeit gesteuert wird, z. B. der eigenen Agent-ID.
- Akzeptieren Sie keine Agentidentitäts-Client-ID oder die Benutzerkonto-ID des Agents aus einer Anforderung, Aufforderung oder Toolausgabe.
- Vergewissern Sie sich, dass der Aufrufer den Ziel-Agent verwenden darf, bevor Sie dafür ein Token anfordern.
Vertrauensgrenzen planen
- Halten Sie die Anmeldeinformationen von Agent-Code fern. Halten Sie die Blueprint-Anmeldeinformationen in der Laufzeit oder im Sidecar, niemals im Code, den ein Agent autor oder modell steuert.
- Isolieren Sie den Tokenbroker. Wenn Agents nicht vertrauenswürdigen oder vom Kunden bereitgestellten Code ausführen, lassen Sie diesen Code nicht direkt den Tokenbroker aufrufen. Ein Prozess, der den Broker erreichen kann, kann ein Token für jeden Agenten in der Flotte anfordern.
- Trennen Sie die Bereitstellung vom Tokenerwerb. Der Bereitstellungsdienst verwendet Blueprinttoken, die Identitäten erstellen und löschen können. Führen Sie ihn mit seinem eigenen Zugriffspfad aus, damit agent-Code diese Token nicht anfordern kann.
- Begrenzen Sie den Schadensradius. Verwenden Sie mehrere Blaupausen, wenn Gruppen von Agents in unterschiedlichen Vertrauenszonen ausgeführt werden oder zu verschiedenen Kunden gehören.
Planen von Grenzwerten
Ein Blueprintprinzipal kann höchstens 250 Agentidentitäten erstellen. Erstellen Sie für eine größere Flotte mehr Blaupausen, und weisen Sie jedem Agenten einen Blueprint zu, wenn er bereitgestellt wird. Zeichnen Sie den Blueprint im Agentverzeichniseintrag auf. Ausführliche Informationen finden Sie unter Prinzipale des Agentidentitäts-Blueprints.
Die folgenden Implementierungsartikel verwenden einen Blueprint pro Laufzeitkonfiguration. Wenn Sie sie auf mehrere Blueprints erweitern, lösen Sie auch die entsprechende Blueprintkonfiguration und Anmeldeinformationen für jeden Agent auf. Wenn Sie nur eine Agent-ID auswählen, wird kein anderer Blueprint ausgewählt. Der Beispielverzeichnisdatensatz muss für diesen Entwurf erweitert werden.
Gewähren Sie jedem Agenten Zugriff
Gewähren Sie jeder Agentidentität nur den Zugriff, den ihr Agent benötigt. Gewähren Sie Anwendungsberechtigungen, delegierte Berechtigungen, Azure Rollenzuweisungen und den Zugriff auf andere Ressourcen direkt der Agentidentität als Teil der Bereitstellung oder kurz danach. Zuschüsse pro Agent behalten den Zugriff jedes Agenten getrennt, sodass Sie den Zugriff eines Agenten überprüfen, ändern oder widerrufen können, ohne dass sich dies auf den Rest der Flotte auswirkt. Informationen zu den Möglichkeiten zum Gewähren des Zugriffs finden Sie unter Erteilen von Anwendungsberechtigungen und Erteilen delegierter Berechtigungen.
Für Berechtigungen, die jeder Agent in der Flotte benötigt, können Sie vererbbare Berechtigungen zur Vereinfachung verwenden. Ein Administrator gewährt diese Berechtigungen einmal im Blueprintprinzipal, und jede vom Blueprint erstellte Agentidentität erhält sie in ihren Token. Geerbte Berechtigungen werden nicht für die Agentidentität angezeigt, sodass die Zuweisungen pro Agent einfacher überwacht werden können.
Benutzeranfragen an Agenten weiterleiten
Benutzer rufen einen Flotten-Agent mit einem Zugriffstoken für den Scope des Blueprints access_agent auf. Jeder Agent in der Flotte teilt diese Zielgruppe, sodass das Token belegt, wer der Benutzer ist, aber nicht den Agenten identifiziert. Die Laufzeit muss:
- Bestimmen Sie den Zielagenten aus der Anforderung, z. B. aus einem Routensegment.
- Vergewissern Sie sich, dass der Benutzer diesen Agent verwenden darf. App-Rollen im Blueprint gelten für die gesamte Flotte, erzwingen also den Zugriff pro Agent in der Laufzeitumgebung.
- Verwenden Sie die Identität des Ziel-Agents für jede On-Behalf-Of (OBO)-Tokenanforderung.
Nächster Schritt
Einrichten eines Agentenidentitäts-Blueprints für eine Flotte