Ispezionare le sessioni e monitorare l'utilizzo
Ispeziona una sessione nella Claude Console, leggi il suo utilizzo di token e il costo di listino, ed esegui il debug di comportamenti imprevisti dell'agente.
Usa il visualizzatore di sessioni nella Claude Console per ispezionare ciò che un agente ha fatto in una sessione, senza scrivere codice. Usa i totali usage della sessione per vedere cosa ha consumato quel lavoro.
Ispezionare una sessione nella Console
Il visualizzatore di sessioni è accessibile solo a Developer e Admin. Per aprirlo, vai nella barra laterale della Console e seleziona Sessions sotto Managed Agents. L'elenco mostra ogni sessione nel workspace con il suo stato, l'agente, l'utilizzo di token, il costo e l'ora di creazione. Seleziona una sessione per aprirla.
Il visualizzatore di sessioni mostra:
- Minimappa della timeline: una panoramica ingrandibile dell'attività della sessione nel tempo, con una corsia per ogni thread nelle sessioni multiagente. Seleziona una corsia per visualizzare quel thread, oppure seleziona un indicatore per passare al relativo evento.
- Trascrizione: la conversazione raggruppata per richiesta al modello, inclusi il ragionamento, le chiamate agli strumenti con i relativi input e risultati, e il testo dei messaggi durante lo streaming. Puoi filtrare gli eventi e copiarli o scaricarli come JSON.
- Inspector: un pannello laterale ridimensionabile con i dettagli sulla sessione, suddiviso in cinque schede.
| Scheda dell'Inspector | Cosa mostra |
|---|---|
| Session | I dettagli e i metadati della sessione, il suo costo cumulativo nel tempo e la spesa rispetto al budget della sessione, quando ne è impostato uno. |
| Events | Ogni evento grezzo sul thread corrente, nell'ordine in cui il server lo ha inviato. Seleziona un evento per vederne il JSON. Un messaggio trasmesso in streaming mentre la pagina era aperta ha anche una vista Deltas dei suoi delta degli eventi. |
| Tools | Gli strumenti con cui sono configurati gli agenti della sessione, insieme al numero di chiamate, agli errori e alla durata mediana. Seleziona uno strumento per vederne le chiamate e passare a una di esse nella trascrizione. |
| Resources | File, repository e memory store montati nei rispettivi percorsi del container, incluse le memorie in ciascuno store e le modifiche che questa sessione vi ha apportato. Elenca anche i file che l'agente ha scritto in /mnt/session/outputs e le skill associate agli agenti della sessione. |
| Threads | Ogni thread con il suo stato, la dimensione del contesto e il costo. Seleziona un thread per visualizzarne i dettagli, come l'agente, il modello, l'utilizzo del contesto e il costo. |
Aggiungi ?event={event_id} all'URL di una sessione per aprire la sessione in corrispondenza di un evento specifico.
Con ant beta:sessions connect, puoi aprire lo stesso visualizzatore dalla CLI ant oppure seguire la sessione nel tuo terminale. Consulta Connettersi a una sessione di Managed Agents dal terminale.
Monitorare l'utilizzo
L'oggetto sessione include un campo usage con l'utilizzo cumulativo della sessione: conteggi dei token, uso degli strumenti lato server, tempo attivo e il costo di listino tracciato. Recupera la sessione dopo che è diventata inattiva per leggere i totali più recenti.
{
"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
}
}
}| Campo | Descrizione |
|---|---|
input_tokens | Token di input non memorizzati nella cache in tutte le chiamate al modello nella sessione. |
output_tokens | Token di output totali in tutte le chiamate al modello nella sessione. |
cache_read_input_tokens | Token letti dalla cache dei prompt. |
cache_creation | Token di creazione della cache, suddivisi per durata della cache (ephemeral_5m_input_tokens e ephemeral_1h_input_tokens). |
list_cost | Il consumo cumulativo della sessione valutato alle tariffe di listino pubbliche, espresso come numero intero di centesimi in una stringa, con un codice valuta. |
active_seconds | Il tempo cumulativo durante il quale la sessione ha avuto almeno un thread in esecuzione. L'attività sovrapposta di thread concorrenti viene conteggiata una sola volta. Il costo di runtime della sessione è calcolato su questa durata. |
server_tool_use | Conteggi delle richieste di strumenti eseguite lato server, ai fini della tariffazione. Le richieste di ricerca web sono incluse nel costo di listino per singola richiesta. Le richieste di web fetch non prevedono alcun addebito per richiesta e non vengono misurate, quindi web_fetch_requests riporta 0. |
Le voci della cache usano per impostazione predefinita un TTL di 5 minuti, quindi i turni consecutivi all'interno di quella finestra beneficiano delle letture dalla cache, che riducono il costo per token.
L'oggetto stats della sessione ha un proprio active_seconds, che somma il tempo attivo di ciascun thread invece di conteggiare una sola volta l'attività sovrapposta.
Utilizzo per thread
Anche il campo usage di ciascun thread di sessione contiene list_cost e active_seconds. I valori per thread sono arrotondati in modo indipendente ed escludono il costo del tempo di esecuzione della sessione, quindi la loro somma non corrisponde esattamente al list_cost della sessione. Il valore della sessione è quello di riferimento.
Leggere l'utilizzo dallo stream
Non è necessario interrogare periodicamente la sessione per osservare questi totali. L'evento session.usage contiene la stessa istantanea cumulativa sullo stream della sessione e nella cronologia degli eventi. L'istantanea contiene l'oggetto usage più il budget della sessione, che è null quando la sessione non ne ha uno.
L'evento viene emesso nelle transizioni allo stato inattivo anziché a intervalli di tempo:
- La sessione ne emette uno immediatamente prima di diventare inattiva, qualunque sia il motivo dell'arresto.
- La sessione ne emette uno quando un thread si mette in pausa al raggiungimento di un budget di sessione.
Applicare un limite di spesa
Per applicare un limite di spesa, imposta un budget di sessione anziché interrogare l'utilizzo e arrestare la sessione manualmente. La piattaforma calcola continuamente il costo del consumo della sessione e mette in pausa ciascun thread prima della sua successiva richiesta al modello una volta che il costo di listino raggiunge il limite. Consulta Quando una sessione raggiunge il proprio budget per vedere come appare sullo stream.
Suggerimenti per il debug
- Controlla gli eventi della sessione: la sessione segnala gli errori tramite eventi
session.error. - Esamina i risultati degli strumenti: gli errori di esecuzione degli strumenti spesso spiegano comportamenti imprevisti dell'agente. La scheda Tools dell'Inspector mostra gli errori di ciascuno strumento.
- Usa i prompt di sistema: aggiungi istruzioni di logging al prompt di sistema in modo che l'agente riassuma ciò che ha fatto e ciò che ha trovato.
- Risolvi i problemi delle anteprime: se uno stream che abilita i delta degli eventi non si comporta come previsto, consulta Risoluzione dei problemi delle anteprime.
Passaggi successivi
Invia eventi, ricevi le risposte in streaming e interrompi o reindirizza la sessione durante l'esecuzione.
Limita la spesa di una sessione con un budget rigido in dollari applicato alle tariffe di listino pubbliche.
Was this page helpful?