En plus des instructions générales sur l'utilisation d'un agent, cette page décrit les fonctionnalités spécifiques à AdkApp
.
Avant de commencer
Ce tutoriel suppose que vous avez lu et suivi les instructions des articles suivants:
- Développer un agent Agent Development Kit: pour développer
agent
en tant qu'instance deAdkApp
. - Authentification de l'utilisateur pour vous authentifier en tant qu'utilisateur afin d'interroger l'agent.
Opérations compatibles
Les opérations suivantes sont acceptées pour AdkApp
:
stream_query
: pour diffuser une réponse à une requête.create_session
: pour créer une session.list_sessions
: pour lister les sessions disponibles.get_session
: pour récupérer une session spécifique.delete_session
: pour supprimer une session spécifique.
Pour répertorier toutes les opérations compatibles, exécutez la commande suivante:
import pprint
pprint.pprint(remote_app.operation_schemas())
Gérer des sessions
AdkApp
utilise des sessions gérées dans le cloud une fois que vous avez déployé l'agent dans Vertex AI Agent Engine. Cette section explique comment utiliser les sessions gérées.
Créer une session
Pour créer une session pour un utilisateur:
session = remote_app.create_session(user_id="USER_ID")
où USER_ID est un ID défini par l'utilisateur avec une limite de 128 caractères.
Répertorier les sessions
Pour afficher les sessions d'un utilisateur:
remote_app.list_sessions(user_id="USER_ID")
où USER_ID est un ID défini par l'utilisateur avec une limite de 128 caractères.
Obtenir une session
Pour obtenir une session spécifique, vous avez besoin à la fois de l'ID utilisateur et de l'ID de session:
session = remote_app.get_session(user_id="USER_ID", session_id="SESSION_ID")
Supprimer une session
Pour supprimer une session, vous avez besoin de l'ID utilisateur et de l'ID de session:
remote_app.delete_session(user_id="USER_ID", session_id="SESSION_ID")
Lire en continu une réponse à une requête
Pour diffuser les réponses d'un agent dans une session:
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)