Skip to main content
POST
创建自动化

权限

需要一个在组织级别具有 ManageOrgAutomations 权限的服务用户。

运行身份

run_as 字段为必填项。由服务用户创建的自动化必须使用 organization;具有 UsePersonalAutomations 权限的人工 API 调用方可使用 creator,以创建者的权限运行会话。

触发器和操作

当自动化的任一 triggers 与某个事件匹配时,自动化便会触发并运行其 actions (例如,使用提示启动 Devin 会话) 。使用事件架构端点查看支持的触发事件类型、其条件字段和运算符,以及各事件类型支持的回复动词。 触发器 conditions 使用两层嵌套结构 — {"any": [{"all": [...]}]} — 来定义 {field, operator, value} 条件;null conditions 对象会匹配所有事件。

Webhook 触发器

包含 webhook:incoming 触发器 (最多一个) 的自动化在创建时会获分配一个收件箱 URL 和密钥。更新时重新添加 webhook 触发器会重新生成并返回该密钥;此后无法再次获取,请在收到时妥善保存。外部系统会通过 X-Webhook-Secret 标头发送该密钥。

授权

Authorization
string
header
必填

服务用户凭据(前缀:cog_)

路径参数

org_id
string
必填

组织 ID(前缀:org-)

示例:

"org-abc123def456"

请求体

application/json
actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
必填

非空。限制:最多只能有一个 start_session;monitor_session 必须是唯一的 action。

name
string
必填
Required string length: 1 - 500
run_as
AutomationRunAsOrganization · object
必填

必填:明确选择启动的会话使用的身份(组织或创建者)。

triggers
AutomationTriggerRequest · object[]
必填

任一触发器匹配时触发,每个事件仅触发一次。最多只能有一个 webhook:incoming 触发器。

concurrency
AutomationConcurrency · object | null
enabled
boolean
默认值:true
limits
AutomationLimits · object | null
metadata
Metadata · object

用于组织和过滤自动化的组织可见键值标签。最多 16 对;键最长 32 个字符;值最长 128 个字符。

notifications
AutomationNotifications · object | null
security_profile
AutomationSecurityProfileSelection · object | null

自动化自身的安全 Profile 绑定;省略则从组织/企业继承。需要安全 Profile 管理权限。

session_settings
AutomationSessionSettings · object | null

应用于此自动化启动的会话。

template_id
string | null

仅在创建时使用的来源标记;通过 templates 端点解析 ID。设置后,如果省略 tools.mcp_servers,则应用模板的 required_mcps。

tools
AutomationTools · object | null

响应

成功响应

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
必填
automation_id
string
必填
created_at
integer
必填
created_by
ActorResponse · object
必填

归因于某项操作或资源的用户或服务用户主体。

enabled
boolean
必填
name
string
必填
triggers
AutomationTriggerResponse · object[]
必填
updated_at
integer
必填
concurrency
AutomationConcurrency · object | null
last_edited_by
ActorResponse · object | null

归因于某项操作或资源的用户或服务用户主体。

last_invocation
AutomationLastInvocation · object | null
limits
AutomationLimits · object | null
metadata
Metadata · object
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

启动的会话使用的身份。organization:组织的自动化身份(应用中的系统用户)— 会话使用系统权限,因此无法选择通过个人(用户作用域)连接安装的 MCP 服务器;将自动化切换为 organization 会将这些服务器从可选项中移除。creator:个人自动化 — 使用创建者自身的权限运行,且仅创建者和组织管理员可见;由服务用户创建的自动化不允许使用此值。创建时必填;更新时设为 null 将重置为 organization。

security_profile
AutomationSecurityProfileResponse · object | null

自动化的安全 Profile 绑定及解析后适用的 Profile。组织未启用安全 Profile 时为 null。

session_settings
AutomationSessionSettings · object | null

应用于此自动化生成的每个会话(包括监控 会话)。

template_id
string | null
tools
AutomationTools · object | null