Aggiorna l'automazione
Aggiorna un’automazione.
Per impostazione predefinita, i gruppi presenti vengono uniti membro per membro (RFC 7396): i membri omessi mantengono il valore memorizzato, mentre i valori null espliciti li eliminano. L’appartenenza a un elenco viene sostituita integralmente e ogni elemento inviato viene unito all’elemento memorizzato dello stesso tipo quando quel tipo ricorre esattamente una volta in entrambi.
Autorizzazioni
ManageOrgAutomations a livello di organizzazione.
Semantica di merge
merge_patch, i campi PATCH vengono uniti membro per membro (in stile RFC 7396): i membri omessi mantengono il valore memorizzato, i valori null espliciti cancellano e i gruppi vuoti non producono effetti. I metadati vengono uniti per chiave e i valori null eliminano le chiavi. Gli elenchi vengono sostituiti integralmente, mentre ogni elemento inviato viene unito all’elemento memorizzato dello stesso tipo quando tale tipo compare esattamente una volta in entrambi.
Con la semantica replace_groups, non viene eseguito alcun merge: un gruppo di oggetti inviato sostituisce integralmente il gruppo memorizzato e un elenco triggers o actions inviato sostituisce integralmente l’elenco memorizzato, senza merge a livello di elemento. Invia nuovamente ogni membro che desideri mantenere: i membri omessi vengono cancellati o reimpostati al valore predefinito. Anche metadata viene sostituito integralmente, quindi per rimuovere una chiave devi inviare nuovamente l’insieme senza quella chiave; i valori null nei metadati vengono rifiutati con un errore 400 anziché eliminare le chiavi. I campi di primo livello omessi rimangono comunque invariati.
Verifica il campo update_semantics dell’endpoint degli schemi degli eventi per conoscere la semantica attiva nella tua organizzazione prima di fare affidamento su uno dei due comportamenti. Consideralo un enum aperto e gestisci anche valori diversi dai due indicati sopra.
Trigger webhook
webhook:incoming genera un nuovo segreto e lo restituisce nella risposta di aggiornamento. Il segreto viene mostrato solo in questa occasione, quindi acquisiscilo quando lo ricevi. La sostituzione o il mantenimento di un trigger webhook esistente preserva il segreto esistente.Autorizzazioni
Credenziale dell'utente del servizio (prefisso: cog_)
Parametri del percorso
ID dell'organizzazione (prefisso: org-)
"org-abc123def456"
Corpo
Per impostazione predefinita, i campi PATCH vengono uniti membro per membro: i membri omessi vengono mantenuti,
i valori null espliciti li cancellano e i gruppi vuoti non producono effetti. I metadati vengono uniti per chiave,
con valori null che eliminano le chiavi. Le liste vengono sostituite integralmente (eliminazione = inviare nuovamente
la lista senza l'elemento), mentre ogni elemento inviato viene unito all'elemento
memorizzato dello stesso tipo quando tale tipo ricorre esattamente una volta su entrambi
i lati. I membri dell'elemento obbligatori alla creazione (prompt,
setup_prompt, le configurazioni Slack di monitoraggio/triage, scan_id) possono essere
omessi quando esiste una controparte: vengono mantenuti come qualsiasi altro membro;
null esplicito viene rifiutato.
- AutomationStartSessionActionUpdate
- AutomationMessageSessionActionUpdate
- AutomationMonitorSessionActionUpdate
1 - 500Identità con cui vengono eseguite le sessioni generate. organization: l'identità di automazione dell'org (l'utente di sistema nell'app) — le sessioni usano le autorizzazioni di sistema, quindi non è possibile selezionare server MCP installati con una connessione personale (con ambito utente) e il passaggio di un'automazione a organization li rimuove dalla relativa selezione. creator: automazione personale — viene eseguita con le autorizzazioni del creatore ed è visibile solo al creatore e agli amministratori dell'org; rifiutata per le automazioni create da utenti di servizio. Obbligatorio alla creazione; null durante l'aggiornamento reimposta su organization.
- AutomationRunAsOrganization
- AutomationRunAsCreator
L'associazione al profilo di sicurezza dell'automazione: un profile_id blocca quel profilo, {"profile_id": null} registra un'esclusione esplicita e null esplicito ripristina l'ereditarietà dall'org/Enterprise. Richiede l'autorizzazione per la gestione dei profili di sicurezza.
Applicato a ogni sessione generata da questa automazione (incluse le sessioni di monitoraggio).
Risposta
Risposta riuscita
- AutomationStartSessionAction
- AutomationMessageSessionAction
- AutomationMonitorSessionAction
Un principal utente o utente di servizio associato a un'azione o a una risorsa.
Un principal utente o utente di servizio associato a un'azione o a una risorsa.
Identità con cui vengono eseguite le sessioni generate. organization: l'identità di automazione dell'org (l'Utente di sistema nell'app) — le sessioni usano autorizzazioni di sistema, quindi non è possibile selezionare server MCP installati con una connessione personale (con ambito utente); passando un'automazione a organization, tali server vengono rimossi dalla selezione. creator: automazione personale — viene eseguita con le autorizzazioni del creatore ed è visibile solo al creatore e agli admin dell'org; non consentita per le automazioni create da utenti di servizio. Obbligatorio alla creazione; null in aggiornamento reimposta a organization.
- AutomationRunAsOrganization
- AutomationRunAsCreator
L'associazione dell'automazione al profilo di sicurezza e i profili applicabili risultanti. null quando i profili di sicurezza non sono abilitati per l'organizzazione.
Applicato a ogni sessione generata da questa automazione (incluse le sessioni di monitoraggio).