Managed AgentsDelegare il lavoro al tuo agente

Iscriviti ai webhook

Ricevi notifiche quando si verificano eventi importanti senza dover effettuare polling.

Le sessioni sono interazioni di lunga durata. Mentre la maggior parte delle interazioni in tempo reale avviene tramite lo stream di eventi SSE, i webhook ti notificano i principali cambiamenti di stato.

Gli eventi webhook restituiscono il type e l'id dell'evento, non l'oggetto completo. Quando ricevi un evento webhook, devi recuperare l'oggetto direttamente con una chiamata GET. Questo evita di consegnare dati obsoleti durante i tentativi ripetuti e mantiene ogni consegna di piccole dimensioni.

Tipi di evento supportati

Alcuni di questi eventi hanno nomi diversi rispetto agli eventi corrispondenti nello stream di eventi della sessione. Ad esempio, session.status_idle e session.status_running dello stream corrispondono agli eventi webhook session.status_idled e session.status_run_started.

Evento	Attivazione
`session.status_run_started`	L'esecuzione dell'agente è iniziata. Si attiva a ogni transizione dello stato della sessione a `running`.
`session.status_idled`	L'agente è in attesa di input, ad esempio l'approvazione di un permesso per uno strumento o un nuovo messaggio dell'utente.
`session.budget_reached`	La sessione ha raggiunto il suo budget ed è stata messa in pausa. Si attiva al massimo una volta per ogni valore di budget impostato; modificare il budget lo riattiva.
`session.status_rescheduled`	Si è verificato un errore transitorio e la sessione sta ritentando automaticamente.
`session.status_terminated`	La sessione è terminata, a causa di un errore irrecuperabile oppure perché è stata archiviata.
`session.thread_created`	È stato aperto un nuovo thread multiagente: un agente aggiuntivo chiamato dall'agente eseguito dalla sessione sta iniziando a lavorare, oppure viene consultato l'advisor della sessione. Si attiva anche per ogni thread di un'esecuzione di workflow, così come gli altri due eventi di thread in questa tabella.
`session.thread_idled`	Un agente in un'interazione multiagente è in attesa di input.
`session.thread_terminated`	Un thread multiagente è terminato, perché il thread è stato archiviato oppure perché ha esaurito i suoi tentativi. Un subagente che completa il proprio lavoro passa a `idle`, non a `terminated` (un thread advisor termina una volta completata la consultazione, e i thread di un'esecuzione di workflow terminano quando il server li archivia, entro la fine dell'esecuzione). Si attiva solo per i thread figli; la fine del thread principale, inclusa l'archiviazione dell'intera sessione, emerge solo come `session.status_terminated`.
`session.outcome_evaluation_ended`	La valutazione del risultato per una singola iterazione è stata completata.
`session.updated`	Le proprietà della sessione sono cambiate (ad esempio, il suo nome o la sua configurazione sono stati aggiornati).
`session.deleted`	Sessione eliminata definitivamente. Non rimane alcun oggetto da recuperare, quindi considera l'evento stesso come definitivo.

Evento	Attivazione
`vault.created`	Vault creato.
`vault.archived`	Vault archiviato. Viene emesso anche un evento `vault_credential.archived` per ogni credenziale sottostante.
`vault.deleted`	Vault eliminato. Viene emesso anche un evento `vault_credential.deleted` per ogni credenziale sottostante. Non rimane alcun oggetto da recuperare, quindi considera l'evento stesso come definitivo.
`vault_credential.created`	Credenziale creata.
`vault_credential.archived`	Credenziale archiviata, direttamente o come conseguenza dell'archiviazione del vault.
`vault_credential.deleted`	Credenziale eliminata, direttamente o come conseguenza dell'eliminazione del vault. Non rimane alcun oggetto da recuperare, quindi considera l'evento stesso come definitivo.
`vault_credential.refresh_failed`	Una credenziale `mcp_oauth` non può essere aggiornata (refresh token non valido o errore irrecuperabile dal server OAuth).

Questi eventi tracciano il ciclo di vita delle risorse agente nel tuo workspace e sono distinti dagli eventi dell'agente consegnati nello stream di eventi di una sessione.

Evento	Attivazione
`agent.created`	Agente creato.
`agent.updated`	È stata pubblicata una nuova versione dell'agente. Gli aggiornamenti che non creano una nuova versione non attivano questo evento.
`agent.archived`	Agente archiviato.
`agent.deleted`	Agente eliminato definitivamente. Non rimane alcun oggetto da recuperare, quindi considera l'evento stesso come definitivo.

Evento	Attivazione
`deployment.created`	Deployment pianificato creato.
`deployment.updated`	Le proprietà del deployment sono cambiate (ad esempio, la sua pianificazione è stata aggiornata).
`deployment.paused`	Deployment messo in pausa, su richiesta oppure automaticamente quando un'esecuzione pianificata fallisce con un errore irrecuperabile, come un subagente archiviato o un ambiente archiviato. I fallimenti recuperabili, inclusi i limiti di velocità, non mettono in pausa il deployment. Consulta Comportamento in caso di errore.
`deployment.unpaused`	Deployment riattivato, con ripresa della sua pianificazione.
`deployment.archived`	Deployment archiviato, direttamente oppure perché il suo agente è stato archiviato. Se invece l'agente viene eliminato, un deployment pianificato viene archiviato alla sua successiva esecuzione pianificata; un deployment senza pianificazione non viene archiviato automaticamente.
`deployment.deleted`	Deployment eliminato definitivamente. Non rimane alcun oggetto da recuperare, quindi considera l'evento stesso come definitivo.

Evento	Attivazione
`deployment_run.started`	È iniziata un'esecuzione pianificata. Solo le esecuzioni pianificate emettono eventi `deployment_run`; le esecuzioni manuali no.
`deployment_run.succeeded`	Un'esecuzione pianificata ha creato la sua sessione. L'evento contiene lo stesso `data.id` (l'ID dell'esecuzione) dell'evento `deployment_run.started` dell'esecuzione. Per seguire il lavoro della sessione, iscriviti ai suoi eventi di sessione (la scheda Eventi di sessione), oppure recupera l'esecuzione del deployment per ottenere il suo `session_id`.
`deployment_run.failed`	Un'esecuzione pianificata non ha creato una sessione. L'evento contiene lo stesso `data.id` dell'evento `deployment_run.started` dell'esecuzione. Recupera l'esecuzione del deployment per i dettagli dell'errore.

Evento	Attivazione
`environment.created`	Ambiente creato.
`environment.updated`	Ambiente aggiornato con almeno un campo modificato. Un aggiornamento senza modifiche non emette nulla.
`environment.archived`	Ambiente archiviato. Archiviare nuovamente un ambiente già archiviato non emette nulla.
`environment.deleted`	Ambiente eliminato, inclusa l'eliminazione di un ambiente già archiviato. Non rimane alcun oggetto da recuperare, quindi considera l'evento stesso come definitivo.

Gli elementi di lavoro di un ambiente non emettono eventi webhook.

Evento	Attivazione
`memory_store.created`	Memory store creato, da te oppure da un processo gestito da Anthropic che clona uno dei tuoi store esistenti.
`memory_store.archived`	Memory store archiviato. Archiviare nuovamente uno store già archiviato non emette nulla.
`memory_store.deleted`	Memory store eliminato, inclusa l'eliminazione di uno store già archiviato. L'eliminazione di uno store si propaga a cascata alle sue memorie e alle versioni delle memorie senza emettere eventi per singola memoria; il singolo evento `memory_store.deleted` è il segnale. Non rimane alcun oggetto da recuperare, quindi considera l'evento stesso come definitivo.

Le singole memorie e le versioni delle memorie non emettono eventi webhook.

Tipi di evento supportati

Tipi di evento supportati