Panoramica di Agent Platform Sessions

Agent Platform Sessions mantiene la cronologia delle interazioni tra un utente e gli agenti. Le sessioni forniscono le origini definitive per la memoria a lungo termine e il contesto della conversazione.

Hai diverse opzioni per utilizzare Agent Platform Sessions:

  • Agent Development Kit (ADK): una volta eseguito il deployment dell'agente ADK in Gemini Enterprise Agent Platform, la gestione delle sessioni viene gestita automaticamente.

  • Chiamate API: puoi effettuare chiamate API dirette alle sessioni di Agent Platform se non vuoi gestire le sessioni utilizzando un agente ADK.

Concetti principali

  • Sessione: una sessione rappresenta la sequenza cronologica di messaggi e azioni (eventi) per una singola interazione in corso tra un utente e il tuo sistema di agenti.

  • Evento: un evento memorizza i contenuti della conversazione, nonché le azioni intraprese dagli agenti, come le chiamate di funzione. Gli eventi supportano uno schema flessibile per adattarsi a dati personalizzati e framework diversi.

  • Stato: uno stato contiene dati temporanei pertinenti solo durante la conversazione corrente.

  • Memoria: la memoria è costituita da informazioni personalizzate a cui è possibile accedere in più sessioni per un determinato utente. L'agente può utilizzare i ricordi per personalizzare le risposte all'utente e garantire la continuità tra le sessioni.

Funzionalità di base

Le funzionalità di base delle sessioni di Agent Platform includono:

  • Avvio di nuove conversazioni: crea nuove sessioni quando un utente inizia un'interazione con un agente.

  • Ripresa di conversazioni esistenti: recupero di una sessione specifica in modo che l'agente possa riprendere una conversazione che è stata messa in pausa.

  • Salvataggio dei progressi: aggiungi nuove interazioni (eventi) alla cronologia di una sessione per aggiornarla.

  • Elenco delle conversazioni: trova i thread delle sessioni attive per un utente e un'applicazione specifici.

  • Pulizia: elimina gli oggetti sessione e i dati associati quando le conversazioni sono terminate o non sono più necessarie.

Sicurezza e governance di livello enterprise

Le sessioni della piattaforma degli agenti supportano i controlli di sicurezza aziendali per aiutarti a proteggere la cronologia delle conversazioni, lo stato della sessione e gli eventi da accessi non autorizzati o esfiltrazione di dati.

Controlli di servizio VPC (Controlli di servizio VPC)

Le sessioni della piattaforma dell'agente supportano i Controlli di servizio VPC per mitigare il rischio di esfiltrazione di dati per i dati delle sessioni e gli eventi di conversazione. Poiché sessions e events sono risorse secondarie di un'istanza di Agent Runtime (reasoningEngines) gestita tramite l'API Agent Platform (aiplatform.googleapis.com), l'aggiunta dell'API Agent Platform a un perimetro di servizio dei Controlli di servizio VPC protegge tutte le operazioni della sessione (CreateSession, GetSession, ListSessions, UpdateSession, DeleteSession, AppendEvent e ListEvents).

Quando configuri i Controlli di servizio VPC per le sessioni, segui queste linee guida:

  • Configurazione del perimetro: aggiungi l'API Agent Platform (aiplatform.googleapis.com) al perimetro di servizio dei Controlli di servizio VPC. Assicurati che il progetto sia aggiunto al perimetro di servizio prima di creare l'istanza di Agent Runtime padre che ospita le sessioni.
  • Connettività degli endpoint privati: instrada le richieste a LOCATION-aiplatform.googleapis.com (o aiplatform.googleapis.com per gli endpoint globali) dalla tua rete VPC tramite restricted.googleapis.com (199.36.153.4/30) o un endpoint Private Service Connect interno per le API di Google.
  • Utilizzo delle sessioni con Agent Gateway in un perimetro di servizio: quando un agente di cui è stato eseguito il deployment su Agent Runtime è associato a un Agent Gateway in modalità Agent-to-Anywhere (in uscita), le chiamate API in uscita dall'agente alle sessioni attraversano il gateway. Per evitare blocchi del perimetro o del gateway:
    • Configura il gateway utilizzando un template di connettività dell'agente (AgentConnectivityTemplate) con vpcEgress impostato su ALL_TRAFFIC e il peering Cloud DNS privato per googleapis.com.. Per maggiori dettagli, consulta Conformità dei Controlli di servizio VPC per Agent Gateway.
    • Registra e inserisci nella lista consentita gli endpoint Agent Platform API regionali e mTLS in Agent Registry in modo che l'agente possa chiamare l'endpoint Sessions (https://LOCATION-aiplatform.googleapis.com/API_VERSION/projects/PROJECT_ID/locations/LOCATION/reasoningEngines/RESOURCE_ID/sessions) e concedi all'identità dell'agente il ruolo IAP Egressor (roles/iap.egressor). Per istruzioni passo passo, consulta Instrada il traffico di Agent Runtime tramite Agent Gateway.

Chiavi di crittografia gestite dal cliente (CMEK)

Per impostazione predefinita, Google Cloud cripta lo stato della sessione e gli eventi della conversazione at-rest utilizzando Google-owned and Google-managed encryption keys. Per proteggere i dati della sessione utilizzando le chiavi che gestisci in Cloud Key Management Service (Cloud KMS), specifica encryption_spec (kms_key_name) quando crei l'istanza di runtime dell'agente principale. Tutte le sessioni e gli eventi archiviati in quell'istanza ereditano la relativa configurazione CMEK. Per i passaggi generali di configurazione del progetto e delle chiavi, consulta CMEK per Gemini Enterprise Agent Platform.

Quando utilizzi CMEK con le sessioni, si applicano le seguenti limitazioni:

  • Limitazioni relative all'endpoint globale e al runtime di cui è stato eseguito il deployment: non puoi utilizzare CMEK quando Sessions è configurato per utilizzare l'endpoint global (location="global"), perché Cloud Key Management Service richiede che le chiavi di crittografia risiedano all'interno di un confine geografico di residenza dei dati. Per utilizzare CMEK, crea un'istanza principale autonoma (senza eseguire il deployment del codice di runtime dell'agente) in una località regionale o multiregionale supportata con una chiave Cloud KMS corrispondente (per le istanze multiregionali, utilizza una chiave us per us o una chiave europe per eu). Se l'istanza principale esegue anche il deployment di un agente su Agent Runtime, devi utilizzare una località a regione singola, perché i runtime di cui è stato eseguito il deployment non supportano CMEK su endpoint multiregionali (us o eu).
  • La chiave di crittografia non può essere aggiornata: una volta creata un'istanza con una chiave Cloud KMS, non puoi modificare la chiave per l'istanza. Per utilizzare una chiave diversa, devi creare una nuova istanza.

Passaggi successivi