> ## 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.

# 日历

> 你的 Google Calendar：按周查看的页面、空闲时间，以及只在你同意后才添加或更改日程的智能体工具。

日历在 Archetype 中显示你的 Google Calendar，并让智能体读取它。它默认开启，在侧边栏中显示为**日历**。开启和关闭插件，见[插件](https://docs.archetype.ing/zh/extend/plugins.md)。

## 连接

在“管理 → 连接 → 应用”中连接 Google Calendar。日历插件自己不保存密钥，通过这个连接访问 Google。

连接了多个 Google 账号时，它们的日程会一起显示。新日程添加到第一个账号的主日历；更改、删除或回复会发到日程所在的账号。

## 页面

页面按周显示你个人的主日历。

* **编辑日程**：标题、地点、描述、全天、日期和时间。邀请对象和所属日历保持不变。新的时间会先请你确认。
* **重复**：每天、每周的选定星期几、每月的同一日期或每年，直到某一天或重复一定次数。重复日程标有 ↻。更改或删除重复日程时，会问要处理哪些：仅此一次、全部，或此次及之后的。
* **找时间**：查找不短于你要求时长的空闲时段，范围是工作日 09:00 到 18:00，最多往后 31 天。你已拒绝或标为空闲的日程不算忙碌。
* **其他日历**：用开关在页面上显示或隐藏你的其他日历。它们的日程只读；页面上的所有更改都写入主日历。

如果日程在你打开之后已在 Google 中被更改，保存会停止，并提示你先刷新。

## 智能体能做什么

| 工具 | 作用 | 是否询问你 |
| - | - | - |
| `calendar_events` | 读取日程 | 否 |
| `calendar_free_time` | 查找空闲时间；带上 `attendees` 时，也考虑这些人的忙碌时间 | 否 |
| `calendar_add_event` | 添加日程，最多邀请 50 人 | 每次都问 |
| `calendar_update_event` | 只更改它指定的字段 | 每次都问 |
| `calendar_propose_event` | 留下它找到的约会，由你决定是否添加 | 否：你在**通知**中决定 |

添加和更改每次都会询问你，即使在 `yolo` 模式下也是如此；没有人回答时，会被拒绝。见[批准](https://docs.archetype.ing/zh/use/approvals.md)。

## 通知和事件

* **建议的约会**在**通知**中等你处理，带有 **Add** 和 **Dismiss**。**Add** 会创建日程。
* **`calendar.starting`**：在你自己日历上的日程开始前发送。全天日程和你已拒绝的日程不会提醒。[触发器](https://docs.archetype.ing/zh/use/automations.md)可以由它唤醒。它带有标题、开始时间、剩余分钟数、参加者、地点和会议链接，从不带描述。

## 设置

在“管理 → 插件 → 日历”中：

| 设置 | 默认值 | 作用 |
| - | - | - |
| **会议前几分钟提醒** | 10 | 日程开始前多久发送 `calendar.starting`（1 到 120） |

## 提供的配置文件

**会议准备**（只读）：每次会议前，用几行告诉你：谁参加，上次和他们聊了什么（邮件、消息、笔记、录音），你们之间还有哪些未了的事，以及要带上或要决定的事。它由 `calendar.starting` 唤醒。在“管理 → 配置文件 → 新配置文件”中创建。

## 配合使用

联系人的时间线、手机上的“现在”、每日简报和录音都通过日历读取你的日程。关闭日历后（在[配置](https://docs.archetype.ing/zh/reference/config.md)中设置 `"plugins": { "calendar": false }`），不再有日历页面，智能体没有日历工具，上面这些功能会在没有你日程的情况下继续工作。


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