> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 自动化

> 按时间表或在某事发生时运行的请求，以及每次运行留下了什么。

自动化位于“管理 → 自动化 → 定时任务”。这个页面有两个列表：定时任务，在设定的时间运行；触发器，在收到事件时运行。在对话中，`/schedules` 和 `/triggers` 可以列出它们。

## 定时任务

定时任务会自行发送请求，比如每天早上的总结或每周的检查。按**新建定时任务**：

| 字段 | 设置内容 |
| - | - |
| **名称** | 小写字母、数字和 `-` |
| **它应该做什么？** | 请求内容 |
| **时间** | **一次**、每隔几分钟、在选定的日子的某个时间，或一个 cron 表达式。时间按你的时区计算 |
| **位置** | 运行所在的对话，或要回复的聊天 |
| **只发送新动态（仅检查，夜间静默）** | 只在有事要说时才回复，免打扰时段内从不回复 |
| **重要程度** | 运行失败时如何报告（见下文） |

也可以直接在对话中说“明天 9 点提醒我”，智能体会创建定时任务。如果在聊天频道中提出，回复会发回那个聊天。

定时任务在应用打开时运行。应用关闭时，由后台服务运行（`archetype daemon install`，见 [CLI](https://docs.archetype.ing/zh/start/cli.md)）。如果电脑曾关机，只补运行最近一次错过的，而且只运行一次。最多同时运行 4 个定时任务，其余的排队等待。

完全不使用模型、只运行命令的定时任务只能在终端中创建：`archetype --create-schedule … -- PROGRAM`。

## 触发器

触发器在某事发生时运行请求。按**新建触发器**，选择唤醒它的事件：

* \*\*来自插件的事件。\*\*一些现成的选项：**收到付款时**、**会议开始前**、**邮件需要回复时**、**待办今天到期时**、**有人的生日或纪念日临近时**。可以按事件的字段缩小范围。文字匹配不区分大小写，开头或结尾的 `*` 可以匹配词的一部分。彼此相隔 20 秒以内到达的事件会在同一轮中一起运行。
* **收到事件时**：另一个服务（构建失败、新的 issue）调用一个地址。这个地址带有秘密令牌。开启**要求签名（推荐）**，会得到一个密钥，可以粘贴到 GitHub webhook 中。它**仅此时显示**。每个事件只运行一次，即使重复发送也一样。

事件作为数据随请求一起发送，而不是作为指令。

## 每次运行留下什么

* \*\*它的对话。\*\*每次运行都是自动化对话中的一轮（你选定的对话，或它自己的对话）。**打开它的对话**可以打开它。不是由人亲自发起的一轮，会说明是什么启动了它。
* **最近运行**：每次运行的时间和结果。**下次运行**显示下一次的时间。**立即运行**马上运行一次。
* **运行失败**，按**重要程度**报告：**已置顶**会立即通知你，**普通**会列在**待你处理**中并通知你的设备，**后台**只保留在记录中。
* **运行请求的批准。**默认最多等待 60 分钟，之后被拒绝，运行会报告它没能完成的事。开启**无人值守时的批准**后，运行会停下，请求在 [Arch](https://docs.archetype.ing/zh/use/arch.md) 中等你。你回答后运行继续。
* **输出**：命令类定时任务保留最近 20 次运行的输出。

移除自动化会停止它。它的对话和回复会保留。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.