Agent Platform Sessions – Übersicht

Agent Platform-Sitzungen speichern den Verlauf der Interaktionen zwischen einem Nutzer und KI-Agenten. Sitzungen sind Quellen für die langfristig gemerkten Informationen und den Unterhaltungskontext.

Sie haben mehrere Möglichkeiten, Agent Platform-Sitzungen zu verwenden:

  • Agent Development Kit (ADK): Sobald Sie Ihren ADK-Agenten in der Gemini Enterprise Agent Platform bereitstellen, wird die Sitzungsverwaltung automatisch übernommen.

  • API-Aufrufe: Sie können direkte API-Aufrufe an Agent Platform-Sitzungen senden, wenn Sie Sitzungen nicht mit einem ADK-Agenten verwalten möchten.

Wichtige Konzepte

  • Sitzung: Eine Sitzung stellt die chronologische Abfolge von Nachrichten und Aktionen (Ereignissen) für eine einzelne, laufende Interaktion zwischen einem Nutzer und Ihrem Agentensystem dar.

  • Ereignis: In einem Ereignis werden der Inhalt der Unterhaltung sowie die von den KI-Agenten ausgeführten Aktionen wie Funktionsaufrufe gespeichert. Ereignisse unterstützen ein flexibles Schema, um benutzerdefinierte Daten und verschiedene Frameworks zu berücksichtigen.

  • Status: Ein Status enthält temporäre Daten, die nur während der aktuellen Unterhaltung relevant sind.

  • Gemerkte Informationen: Gemerkte Informationen sind personalisierte Informationen, auf die über mehrere Sitzungen hinweg für einen bestimmten Nutzer zugegriffen werden kann. Der KI-Agent kann gemerkte Informationen verwenden, um Antworten für den Nutzer zu personalisieren und die Kontinuität über mehrere Sitzungen hinweg zu gewährleisten.

Hauptfunktionen

Zu den Hauptfunktionen von Agent Platform-Sitzungen gehören:

  • Neue Unterhaltungen starten: Erstellen Sie neue Sitzungen, wenn ein Nutzer eine Interaktion mit einem Agenten beginnt.

  • Bestehende Unterhaltungen fortsetzen: Eine bestimmte Sitzung abrufen, damit der KI-Agent eine pausierte Unterhaltung fortsetzen kann.

  • Fortschritt speichern: Neue Interaktionen (Ereignisse) werden an den Verlauf einer Sitzung angehängt, um die Sitzung zu aktualisieren.

  • Unterhaltungen auflisten: Finden Sie die aktiven Sitzungsthreads für einen bestimmten Nutzer und eine bestimmte Anwendung.

  • Bereinigen: Löschen Sie Sitzungsobjekte und die zugehörigen Daten, wenn Unterhaltungen beendet sind oder nicht mehr benötigt werden.

Sicherheit und Governance für Unternehmen

Agent Platform-Sitzungen unterstützen Sicherheitskontrollen für Unternehmen, um den Unterhaltungsverlauf, den Sitzungsstatus und Ereignisse vor unbefugtem Zugriff oder Datenabfluss zu schützen.

VPC Service Controls (VPC Service Controls)

Agent Platform-Sitzungen unterstützen VPC Service Controls, um das Risiko einer Daten-Exfiltration für Ihre Sitzungsdaten und Unterhaltungsereignisse zu minimieren. Da sessions und events untergeordnete Ressourcen einer Agent Runtime-Instanz (reasoningEngines) sind, die über die Agent Platform API (aiplatform.googleapis.com) bereitgestellt wird, werden durch das Hinzufügen der Agent Platform API zu einem VPC Service Controls-Dienstperimeter alle Sitzungsvorgänge (CreateSession, GetSession, ListSessions, UpdateSession, DeleteSession, AppendEvent und ListEvents) geschützt.

Beachten Sie beim Konfigurieren von VPC Service Controls für Sitzungen die folgenden Richtlinien:

  • Perimeterkonfiguration: Fügen Sie die Agent Platform API (aiplatform.googleapis.com) Ihrem VPC Service Controls-Dienstperimeter hinzu. Achten Sie darauf, dass Ihr Projekt dem Dienstperimeter hinzugefügt wird, bevor Sie die übergeordnete Agent Runtime-Instanz erstellen, die Ihre Sitzungen hostet.
  • Private Endpunktverbindung: Leiten Sie Anfragen an LOCATION-aiplatform.googleapis.com (oder aiplatform.googleapis.com für globale Endpunkte) von Ihrem VPC-Netzwerk über restricted.googleapis.com (199.36.153.4/30) oder einen internen Private Service Connect-Endpunkt für Google APIs weiter.
  • Sitzungen mit Agent Gateway in einem Dienstperimeter verwenden: Wenn ein in der Agent Runtime bereitgestellter Agent an ein erzwingendes Agent Gateway im Agent-to-Anywhere-Modus (ausgehend) gebunden ist, werden ausgehende API-Aufrufe von Ihrem Agenten an Sitzungen über das Gateway geleitet. So vermeiden Sie Perimeter- oder Gateway-Sperren:
    • Konfigurieren Sie das Gateway mit einer Vorlage für die Agentenkonnektivität (AgentConnectivityTemplate), wobei vpcEgress auf ALL_TRAFFIC festgelegt ist, und mit privatem Cloud DNS-Peering für googleapis.com.. Weitere Informationen finden Sie unter VPC Service Controls-Compliance für Agent Gateway.
    • Registrieren Sie die regionalen und mTLS-Agent Platform API-Endpunkte in der Agent Registry und setzen Sie sie auf die Zulassungsliste, damit Ihr KI-Agent den Sessions-Endpunkt (https://LOCATION-aiplatform.googleapis.com/API_VERSION/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/sessions) aufrufen kann. Gewähren Sie Ihrer KI-Agentenidentität die Rolle „IAP Egressor“ (roles/iap.egressor). Eine detaillierte Anleitung finden Sie unter Agent Runtime-Traffic über das Agent Gateway weiterleiten.

Kundenverwaltete Verschlüsselungsschlüssel (CMEK, Customer-Managed Encryption Keys)

Standardmäßig verschlüsselt Google Cloud Sitzungsstatus und Unterhaltungsereignisse im Ruhezustand mit Google-owned and Google-managed encryption keys. Wenn Sie Ihre Sitzungsdaten mit Schlüsseln schützen möchten, die Sie in Cloud Key Management Service (Cloud KMS) verwalten, geben Sie beim Erstellen der übergeordneten Agent Runtime-Instanz den encryption_spec (kms_key_name) an. Alle Sitzungen und Ereignisse, die unter dieser Instanz gespeichert sind, übernehmen die CMEK-Konfiguration. Allgemeine Schritte zur Projekt- und Schlüsseleinrichtung finden Sie unter CMEK für die Gemini Enterprise Agent Platform.

Bei der Verwendung von CMEK mit Sitzungen gelten die folgenden Einschränkungen:

  • Einschränkungen für globale Endpunkte und bereitgestellte Laufzeiten: Sie können CMEK nicht verwenden, wenn Sessions für die Verwendung des global-Endpunkts (location="global") konfiguriert ist, da Cloud Key Management Service erfordert, dass sich Verschlüsselungsschlüssel innerhalb einer geografischen Datenstandortgrenze befinden. Wenn Sie CMEK verwenden möchten, erstellen Sie eine eigenständige übergeordnete Instanz (ohne Agent-Laufzeitcode bereitzustellen) an einem unterstützten regionalen oder multiregionalen Standort mit einem passenden Cloud KMS-Schlüssel. Verwenden Sie für multiregionale Instanzen einen us-Schlüssel für us oder einen europe-Schlüssel für eu. Wenn die übergeordnete Instanz auch einen Agenten in der Agent Runtime bereitstellt, müssen Sie einen Standort in einer einzelnen Region verwenden, da bereitgestellte Laufzeiten CMEK auf multiregionalen Endpunkten (us oder eu) nicht unterstützen.
  • Verschlüsselungsschlüssel kann nicht aktualisiert werden: Nachdem eine Instanz mit einem Cloud KMS-Schlüssel erstellt wurde, können Sie den Schlüssel für diese Instanz nicht mehr ändern. Wenn Sie einen anderen Schlüssel verwenden möchten, müssen Sie eine neue Instanz erstellen.

Nächste Schritte