Automatisierung aktualisieren
Aktualisiert eine Automatisierung.
Vorhandene Gruppen werden standardmäßig mitgliedsweise zusammengeführt (RFC 7396): Nicht angegebene Mitglieder behalten ihren gespeicherten Wert, explizite null-Werte löschen ihn. Listenmitgliedschaften werden vollständig ersetzt, und jedes gesendete Element wird mit dem gespeicherten Element desselben Typs zusammengeführt, wenn dieser Typ auf beiden Seiten genau einmal vorkommt.
Berechtigungen
ManageOrgAutomations auf Organisationsebene.
Merge-Semantik
merge_patch werden PATCH-Felder auf Mitgliedsebene zusammengeführt (nach RFC 7396): Nicht übermittelte Mitglieder behalten ihren gespeicherten Wert, explizite Nullwerte löschen sie, und leere Gruppen sind No-Ops. Metadaten werden pro Schlüssel zusammengeführt, wobei Nullwerte Schlüssel löschen. Listen werden vollständig ersetzt. Jedes gesendete Element wird jedoch mit dem gespeicherten Element desselben Typs zusammengeführt, sofern dieser Typ auf beiden Seiten genau einmal vorkommt.
Bei der Semantik replace_groups wird nichts zusammengeführt: Eine gesendete Objektgruppe ersetzt die gespeicherte Gruppe vollständig, und eine gesendete Liste triggers oder actions ersetzt die gespeicherte Liste vollständig ohne elementweise Zusammenführung. Übermitteln Sie jedes Mitglied erneut, das Sie beibehalten möchten – nicht übermittelte Mitglieder werden gelöscht oder auf ihren Standardwert zurückgesetzt. metadata wird ebenfalls vollständig ersetzt. Um einen Schlüssel zu entfernen, übermitteln Sie den Satz erneut, ohne diesen Schlüssel einzuschließen. Nullwerte für Metadaten werden mit einem Fehler 400 abgelehnt, anstatt Schlüssel zu löschen. Nicht übermittelte Felder der obersten Ebene bleiben unverändert.
Prüfen Sie vor der Nutzung eines der beiden Verhaltensweisen im Feld update_semantics des Endpunkts für Ereignisschemas, welche Semantik für Ihre Organisation aktiv ist. Behandeln Sie es als offene Enum und tolerieren Sie auch andere Werte als die beiden oben genannten.
Webhook-Auslöser
webhook:incoming-Auslösers wird ein neues Secret generiert und in der Aktualisierungsantwort zurückgegeben. Das Secret wird nur dann angezeigt. Speichern Sie es daher, sobald Sie es erhalten. Beim Ersetzen oder Beibehalten eines vorhandenen Webhook-Auslösers bleibt das vorhandene Secret erhalten.Autorisierungen
Servicebenutzer-Anmeldedaten (Präfix: cog_)
Pfadparameter
Organisations-ID (Präfix: org-)
"org-abc123def456"
Body
PATCH-Felder werden standardmäßig eigenschaftsweise zusammengeführt: Weggelassene Eigenschaften bleiben erhalten,
ausdrückliche null-Werte löschen sie, und leere Gruppen haben keine Wirkung. Metadaten werden pro Schlüssel zusammengeführt,
wobei null-Werte Schlüssel löschen. Listen werden vollständig ersetzt (Löschen = erneutes Senden
der Liste ohne das Element), während jedes gesendete Element mit dem
gespeicherten Element desselben Typs zusammengeführt wird, wenn dieser Typ auf beiden
Seiten genau einmal vorkommt. Elementeigenschaften, die beim Erstellen erforderlich sind (prompt,
setup_prompt, die Slack-Konfigurationen für Überwachung/Triage, scan_id), können
weggelassen werden, wenn ein Gegenstück vorhanden ist – sie werden wie jede andere Eigenschaft übernommen;
ausdrückliches null wird abgelehnt.
- AutomationStartSessionActionUpdate
- AutomationMessageSessionActionUpdate
- AutomationMonitorSessionActionUpdate
1 - 500Identität, unter der die gestarteten Sitzungen ausgeführt werden. organization: die Automatisierungsidentität der Organisation (der System User in der App) – Sitzungen verwenden Systemberechtigungen, daher können MCP-Server, die mit einer persönlichen (nutzerbezogenen) Verbindung installiert wurden, nicht ausgewählt werden. Wird eine Automatisierung auf organization umgestellt, werden sie aus ihrer Auswahl entfernt. creator: persönliche Automatisierung – wird mit den eigenen Berechtigungen des Erstellers ausgeführt und ist nur für den Ersteller und Organisationsadministratoren sichtbar; wird für von Service-Benutzern erstellte Automatisierungen abgelehnt. Beim Erstellen erforderlich; null bei Aktualisierung setzt auf organization zurück.
- AutomationRunAsOrganization
- AutomationRunAsCreator
Die eigene Sicherheitsprofilbindung der Automatisierung: Eine profile_id pinnt dieses Profil, {"profile_id": null} speichert eine ausdrückliche Abwahl und ausdrückliches null stellt die Vererbung von der Organisation/dem Enterprise wieder her. Erfordert die Berechtigung zur Verwaltung von Sicherheitsprofilen.
Wird auf jede Sitzung angewendet, die diese Automatisierung startet (einschließlich Überwachungssitzungen).
Antwort
Erfolgreiche Antwort
- AutomationStartSessionAction
- AutomationMessageSessionAction
- AutomationMonitorSessionAction
Ein Nutzer- oder Service-Benutzer-Principal, der einer Action oder Ressource zugeordnet ist.
Ein Nutzer- oder Service-Benutzer-Principal, der einer Action oder Ressource zugeordnet ist.
Identität, unter der gestartete Sitzungen ausgeführt werden. organization: die Automatisierungsidentität der Organisation (der System User in der App) — Sitzungen verwenden Systemberechtigungen, daher können MCP-Server mit einer persönlichen (nutzerbezogenen) Verbindung nicht ausgewählt werden; beim Umschalten einer Automatisierung auf organization werden sie aus der Auswahl entfernt. creator: persönliche Automatisierung — wird mit den Berechtigungen des Erstellers ausgeführt und ist nur für den Ersteller und Organisationsadministratoren sichtbar; für Automatisierungen, die von Service-Benutzern erstellt wurden, nicht zulässig. Beim Erstellen erforderlich; null bei Updates setzt den Wert auf organization zurück.
- AutomationRunAsOrganization
- AutomationRunAsCreator
Die Sicherheitsprofilbindung der Automatisierung und die ermittelten maßgeblichen Profile. null, wenn Sicherheitsprofile für die Organisation nicht aktiviert sind.
Wird auf jede Sitzung angewendet, die diese Automatisierung startet (einschließlich Überwachungssitzungen).

