无需任何人发起就开始的工作。

触发器就是时钟或签名。其他配置——以哪个代理运行、提示内容是什么、会话落在哪个位置——两种方式完全相同。

• 两种类型都会指定运行身份的代理，并继承该代理默认拒绝的访问权限。
• 两种类型都会携带一个提示词模板，作为会话的第一条消息。
• 两种类型都是 kortix.yaml 中的条目，因此都有历史记录和作者。

项目中的每个触发器占一行：名称、触发时间、使用的时区、运行身份的代理，以及触发后进入的会话。无需点击进入，任何内容都不是隐藏状态。

时区是真实存在的

触发器存储的是 IANA 时区名称，而不是偏移量，默认使用 UTC。设置为 America/Los_Angeles 后，即使发生夏令时切换，也会保持在当地时间 09:00。像 PST 这样的缩写会被拒绝，而不是被猜测解释。

无需手写 cron

“计划”页面是一个选择器——每隔几分钟、工作日、每月一次，或在你选择的某个时刻运行。原始 cron 是其背后的高级选项，而不是入门门槛。

一个开关暂停全部任务

项目级暂停会一次性停止所有触发器，并叠加在每个触发器自身的启用状态之上。当同一代码仓库运行在两个控制平面上时，可用它防止任务触发两次。

突发任务会排队，不会丢失

默认情况下，一个项目同时运行 3 个触发会话。超过该限制的触发会进入队列，并在有空闲槽位时运行，而不是失败。

触发器与代理和沙箱镜像一起存放在 kortix.yaml 中。每个触发器都会指定代理、计划或密钥，以及作为会话第一条消息的提示词模板。

每个 webhook 触发器都会指定用于签名的项目密钥。没有密钥的触发器会在验证时被拒绝——不存在可以稍后再补救的未认证 webhook。

筛选器是一个点号路径，会匹配提示词所看到的同一载荷。它用于打破循环：如果来源同时报告对话双方，否则代理会因自己的回复再次触发。

默认情况下，每次触发都是全新开始。当工作属于正在进行的线程，而不是一次新的任务时，触发器可以重新提示它已拥有的会话。Kortix 会按顺序尝试这些模式，失败后继续回退，因此触发不会悄然消失。

1. 01

   pinned

   重新提示由 id 指定的某个确切会话。如果该会话已消失或失败，则继续回退。

2. 02

   按键匹配

   从载荷生成一个键，然后重新提示最近一个带有完全相同键且状态健康的会话。一个客户对应一个线程。不会回退到其他键的会话。

3. 03

   reuse

   重新提示此触发器创建的最近一个健康会话。固定触发器会先回退到此模式，再继续回退。

4. 04

   fresh

   创建新分支并启动新的云端计算机。这是默认模式，也是其他所有模式的最终回退方案。

触发的会话对整个项目可见，不属于配置触发器的个人。空闲 5 分钟后会自动停止，因此凌晨 3 点运行的自动化不会让机器计费到早上。

自动化不会获得人类无法获得的权限。相同的隔离、相同的作用域范围，以及同一条回到 main 的路径。

它以代理身份运行

触发器指定一个代理，并准确继承该代理的授权——其 kortix.yaml 区块列出的连接器、密钥和技能，仅此而已。没有授权的代理无法访问任何内容。

它拥有自己的计算机

每次新的触发都会在自己的分支上启动一台独立隔离的机器，就像你手动启动的会话一样。它安装或破坏的任何内容都不会影响其他会话。

不会自动合并任何内容

工作只能通过由人员审查并批准的变更请求进入 main。你可以在喝咖啡时阅读差异。机器从未拥有最终决定权。

自动化本身也有历史记录

触发器是仓库中的一段 YAML。谁添加了凌晨 3 点的任务、何时添加，以及要求它说什么，都会记录在日志中——与其他变更相同。