工具与自动化

触发器与调度

智能体不需要被人盯着。触发器是一个统一的原语——当条件成立时，运行一个效果——支撑着每一种「让某件事之后发生」：一个调度计划、一个入站 webhook，或者一个像新邮件这样的外部事件。

按计划

按一个时间间隔或 cron 节奏运行一个智能体——一份早间摘要、每小时的检查、一项夜间任务。触发器带着一个提示唤醒会话；智能体完成工作后重新休眠，所以你只需要在它运行时付费。

create_trigger

# Wake this agent every morning to run a task.
# tool: create_trigger
{ "kind": "cron", "everySeconds": 86400, "prompt": "Summarize overnight orders and flag anything stuck." }

通过 webhook

创建一个 webhook 触发器，你会得到一个保密的触发 URL。任何能发起 HTTP 请求的东西——一个表单、一个 CI 任务、另一个服务——向它发送 POST 请求，智能体就会带着你的提示（以及请求负载）被唤醒。这是把一个外部系统连接到智能体最简单的方式。

create_trigger

# A webhook trigger returns a secret fire URL you can POST to.
# tool: create_trigger
{ "kind": "webhook", "prompt": "A new signup arrived — onboard them." }
# → { "id": "trg_…", "fireUrl": "https://api.commandagi.com/triggers/trg_…/fire?secret=…" }

依据外部事件

触发器也可以订阅平台事件，让智能体对世界做出反应：一封入站邮件或短信、一次日历变更、另一个智能体发来的消息。这就是「当客户发邮件来时，起草一份回复」如何变成一个触发器，而不是一个轮询循环。

开发者接口

GET/app/threads/:id/triggers列出一个会话的触发器。

POST/app/threads/:id/triggers创建一个触发器（cron | webhook | event）。

PATCH/app/threads/:id/triggers/:trigId更新或暂停一个触发器。

POST/triggers/:id/fire触发一个 webhook 触发器（需要 ?secret=）。

同样的操作也是智能体工具（create_trigger、list_triggers、update_trigger、delete_trigger），而 set_autonomy 则是构建在一个空闲心跳触发器之上的语法糖。

按计划

create_trigger

# Wake this agent every morning to run a task.
# tool: create_trigger
{ "kind": "cron", "everySeconds": 86400, "prompt": "Summarize overnight orders and flag anything stuck." }

通过 webhook

create_trigger

# A webhook trigger returns a secret fire URL you can POST to.
# tool: create_trigger
{ "kind": "webhook", "prompt": "A new signup arrived — onboard them." }
# → { "id": "trg_…", "fireUrl": "https://api.commandagi.com/triggers/trg_…/fire?secret=…" }

开发者接口

GET/app/threads/:id/triggers列出一个会话的触发器。

POST/app/threads/:id/triggers创建一个触发器（cron | webhook | event）。

PATCH/app/threads/:id/triggers/:trigId更新或暂停一个触发器。

POST/triggers/:id/fire触发一个 webhook 触发器（需要 ?secret=）。

同样的操作也是智能体工具（create_trigger、list_triggers、update_trigger、delete_trigger），而 set_autonomy 则是构建在一个空闲心跳触发器之上的语法糖。