Inspecter les sessions et suivre l'utilisation
Inspectez une session dans la Claude Console, consultez son utilisation de tokens et son coût au tarif public, et déboguez les comportements inattendus de l'agent.
Utilisez la visionneuse de sessions de la Claude Console pour inspecter ce qu'un agent a fait au cours d'une session, sans écrire de code. Utilisez les totaux usage de la session pour voir ce que ce travail a consommé.
Inspecter une session dans la Console
La visionneuse de sessions n'est accessible qu'aux développeurs et aux administrateurs. Pour l'ouvrir, accédez à la barre latérale de la Console et sélectionnez Sessions sous Managed Agents. La liste affiche chaque session de l'espace de travail avec son statut, son agent, son utilisation de tokens, son coût et sa date de création. Sélectionnez une session pour l'ouvrir.
La visionneuse de sessions affiche :
- Mini-carte de la chronologie : Une vue d'ensemble zoomable de l'activité de la session au fil du temps, avec une piste par thread dans les sessions multiagent. Sélectionnez une piste pour afficher ce thread, ou sélectionnez un repère pour accéder à son événement.
- Transcription : La conversation regroupée par requête au modèle, y compris la réflexion, les appels d'outils avec leurs entrées et leurs résultats, et le texte des messages au fur et à mesure de leur streaming. Vous pouvez filtrer les événements et les copier ou les télécharger au format JSON.
- Inspecteur : Un panneau latéral redimensionnable contenant des détails sur la session, répartis en cinq onglets.
| Onglet de l'Inspecteur | Ce qu'il affiche |
|---|---|
| Session | Les détails et les métadonnées de la session, son coût cumulé au fil du temps, et les dépenses par rapport au budget de la session lorsqu'un budget est défini. |
| Events | Chaque événement brut du thread actuel, dans l'ordre dans lequel le serveur l'a envoyé. Sélectionnez un événement pour voir son JSON. Un message diffusé en streaming pendant que la page était ouverte dispose également d'une vue Deltas de ses deltas d'événements. |
| Tools | Les outils avec lesquels les agents de la session sont configurés, ainsi que le nombre d'appels, les échecs et la durée médiane. Sélectionnez un outil pour voir ses appels et accéder à l'un d'eux dans la transcription. |
| Resources | Les fichiers, dépôts et magasins de mémoire montés, à leurs chemins dans le conteneur, y compris les mémoires de chaque magasin et les modifications que cette session y a apportées. Liste également les fichiers que l'agent a écrits dans /mnt/session/outputs et les skills associés aux agents de la session. |
| Threads | Chaque thread avec son statut, la taille de son contexte et son coût. Sélectionnez un thread pour afficher ses détails, tels que l'agent, le modèle, l'utilisation du contexte et le coût. |
Ajoutez ?event={event_id} à l'URL d'une session pour ouvrir la session à un événement spécifique.
Avec ant beta:sessions connect, vous pouvez ouvrir la même visionneuse depuis la CLI ant ou suivre la session dans votre terminal. Consultez Se connecter à une session Managed Agents depuis votre terminal.
Suivre l'utilisation
L'objet session inclut un champ usage contenant l'utilisation cumulée de la session : le nombre de tokens, l'utilisation d'outils serveur, le temps actif et le coût au tarif public suivi. Récupérez la session une fois qu'elle est devenue inactive pour lire les derniers totaux.
{
"id": "sesn_01...",
"status": "idle",
"usage": {
"input_tokens": 5000,
"output_tokens": 3200,
"cache_read_input_tokens": 20000,
"cache_creation": {
"ephemeral_5m_input_tokens": 2000,
"ephemeral_1h_input_tokens": 0
},
"list_cost": {
"amount": "187",
"currency": "USD"
},
"active_seconds": 342.5,
"server_tool_use": {
"web_search_requests": 3,
"web_fetch_requests": 0
}
}
}| Champ | Description |
|---|---|
input_tokens | Les « input tokens » (tokens d'entrée) non mis en cache sur l'ensemble des appels au modèle de la session. |
output_tokens | Le total des « output tokens » (tokens de sortie) sur l'ensemble des appels au modèle de la session. |
cache_read_input_tokens | Les tokens lus depuis le cache de prompts. |
cache_creation | Les tokens de création de cache, ventilés par durée de vie du cache (ephemeral_5m_input_tokens et ephemeral_1h_input_tokens). |
list_cost | La consommation cumulée de la session, valorisée aux tarifs publics, exprimée sous forme d'un nombre entier de centimes dans une chaîne, avec un code de devise. |
active_seconds | Le temps cumulé pendant lequel au moins un thread de la session était en cours d'exécution. L'activité simultanée de threads concurrents n'est comptée qu'une seule fois. Le coût d'exécution de la session est calculé sur cette durée. |
server_tool_use | Le nombre de requêtes d'outils exécutées côté serveur, à des fins de tarification. Les requêtes de recherche web sont intégrées au coût au tarif public par requête. Les requêtes de récupération web n'entraînent aucun frais par requête et ne sont pas comptabilisées, donc web_fetch_requests indique 0. |
Les entrées du cache utilisent par défaut un TTL de 5 minutes, de sorte que les tours successifs dans cette fenêtre bénéficient de lectures depuis le cache, ce qui réduit le coût par token.
L'objet stats de la session possède son propre active_seconds, qui additionne le temps actif propre à chaque thread au lieu de ne compter qu'une seule fois l'activité simultanée.
Utilisation par thread
Le usage propre à chaque thread de session contient également list_cost et active_seconds. Les chiffres par thread sont arrondis indépendamment et excluent le coût du temps d'exécution de la session, de sorte que leur somme ne correspond pas exactement au list_cost de la session. Le chiffre de la session fait foi.
Lire l'utilisation depuis le flux
Vous n'avez pas besoin d'interroger la session pour observer ces totaux. L'événement session.usage transporte le même instantané cumulé sur le flux de la session et dans l'historique des événements. L'instantané contient l'objet usage ainsi que le budget de la session, qui vaut null lorsque la session n'en a pas.
L'événement est émis lors des transitions vers l'état inactif plutôt que selon une minuterie :
- La session en émet un juste avant de devenir inactive, quelle que soit la raison de l'arrêt.
- La session en émet un lorsqu'un thread se met en pause en atteignant un budget de session.
Appliquer une limite de dépenses
Pour appliquer une limite de dépenses, définissez un budget de session plutôt que d'interroger l'utilisation et d'arrêter la session vous-même. La plateforme valorise en continu la consommation de la session et met chaque thread en pause avant sa prochaine requête au modèle dès que le coût au tarif public atteint le plafond. Consultez Lorsqu'une session atteint son budget pour voir à quoi cela ressemble sur le flux.
Conseils de débogage
- Vérifiez les événements de la session : La session signale les erreurs au moyen d'événements
session.error. - Examinez les résultats des outils : Les échecs d'exécution des outils expliquent souvent un comportement inattendu de l'agent. L'onglet Tools de l'Inspecteur affiche les échecs de chaque outil.
- Utilisez les invites système : Ajoutez des instructions de journalisation à l'invite système afin que l'agent résume ce qu'il a fait et ce qu'il a trouvé.
- Dépannez les aperçus : Si un flux qui active les deltas d'événements ne se comporte pas comme prévu, consultez Dépanner les aperçus.
Étapes suivantes
Envoyez des événements, diffusez les réponses en streaming, et interrompez ou redirigez votre session en cours d'exécution.
Plafonnez les dépenses d'une session avec un budget strict en dollars appliqué aux tarifs publics.
Was this page helpful?