--- title: Inspecter les sessions et suivre l'utilisation url: https://platform.claude.com/docs/fr/managed-agents/session-observability description: 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. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- 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` (csharp, go: `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 page [Sessions](https://platform.claude.com/sessions) (`platform.claude.com/sessions`) dans la Claude Console. 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](https://platform.claude.com/docs/fr/managed-agents/multiagent-orchestration). 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](https://platform.claude.com/docs/fr/managed-agents/budgets) 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](https://platform.claude.com/docs/fr/managed-agents/event-deltas). | | **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](https://platform.claude.com/docs/fr/managed-agents/files), [dépôts](https://platform.claude.com/docs/fr/managed-agents/github) et [magasins de mémoire](https://platform.claude.com/docs/fr/managed-agents/memory) 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](https://platform.claude.com/docs/fr/managed-agents/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](https://platform.claude.com/docs/fr/cli-sdks-libraries/cli/sessions-connect). ## 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. ```json { "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 [fil de session](https://platform.claude.com/docs/fr/managed-agents/session-threads) contient également `list_cost` et `active_seconds`. Les chiffres par fil 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` (csharp, go: `Usage`), ainsi que le `budget` (csharp, go: `Budget`) de la session si elle en a un. 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](https://platform.claude.com/docs/fr/managed-agents/budgets). ### 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](https://platform.claude.com/docs/fr/managed-agents/budgets#when-a-session-reaches-its-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`](https://platform.claude.com/docs/fr/managed-agents/reference#event-types). * **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](https://platform.claude.com/docs/fr/managed-agents/event-deltas#troubleshoot-previews). ## É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.