Utilizzare un agente Agent Development Kit

Oltre alle istruzioni generali per l'utilizzo di un agente, in questa pagina sono descritte le funzionalità specifiche di AdkApp.

Prima di iniziare

Questo tutorial presuppone che tu abbia letto e seguito le istruzioni riportate in:

Operazioni supportate

Per AdkApp sono supportate le seguenti operazioni:

Per elencare tutte le operazioni supportate, esegui il seguente comando:

import pprint

pprint.pprint(remote_app.operation_schemas())

Gestire le sessioni

AdkApp utilizza sessioni gestite basate su cloud dopo aver eseguito il deployment dell'agente in Vertex AI Agent Engine. Questa sezione descrive come utilizzare le sessioni gestite.

Creare una sessione

Per creare una sessione per un utente:

session = remote_app.create_session(user_id="USER_ID")

dove USER_ID è un ID definito dall'utente con un limite di 128 caratteri.

Elenco sessioni

Per elencare le sessioni di un utente:

remote_app.list_sessions(user_id="USER_ID")

dove USER_ID è un ID definito dall'utente con un limite di 128 caratteri.

Recupera una sessione

Per ottenere una sessione specifica, devi disporre sia dell'ID utente sia dell'ID sessione:

session = remote_app.get_session(user_id="USER_ID", session_id="SESSION_ID")

Eliminare una sessione

Per eliminare una sessione, devi disporre sia dell'ID utente sia dell'ID sessione:

remote_app.delete_session(user_id="USER_ID", session_id="SESSION_ID")

Riprodurre in streaming una risposta a una query

Per riprodurre in streaming le risposte di un agente in una sessione:

for event in remote_app.stream_query(
    user_id="USER_ID",
    session_id="SESSION_ID",  # Optional
    message="What is the exchange rate from US dollars to SEK today?",
):
   print(event)

Passaggi successivi