> ## 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 캘린더. 주 단위 화면과 빈 시간 찾기, 그리고 내가 승인해야만 일정을 추가하거나 고치는 에이전트 도구.

캘린더는 내 Google 캘린더를 Archetype에서 보여 주고, 에이전트가 읽을 수 있게 합니다. 기본으로 켜져 있고 사이드바에 **캘린더**로 나옵니다. 플러그인을 켜고 끄는 방법은 [플러그인](https://docs.archetype.ing/ko/extend/plugins.md)을 보세요.

## 연결하기

**관리 → 연결 → 앱**에서 Google 캘린더를 연결합니다. 캘린더 플러그인은 자기 키를 갖지 않고, 이 연결로만 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/ko/use/approvals.md)을 보세요.

## 알림과 이벤트

* **제안된 약속**은 **알림**에서 **추가**와 **닫기**로 기다립니다. **추가**를 누르면 일정이 만들어집니다.
* **`calendar.starting`**: 내 캘린더의 일정이 곧 시작할 때 보냅니다. 종일 일정과 거절한 일정은 알리지 않습니다. [트리거](https://docs.archetype.ing/ko/use/automations.md)가 이 이벤트로 깨어날 수 있습니다. 제목, 시작 시각, 남은 분, 참석자, 장소, 회의 링크를 담고, 설명은 담지 않습니다.

## 설정

**관리 → 플러그인 → 캘린더**에서:

| 설정 | 기본값 | 하는 일 |
| - | - | - |
| **회의 몇 분 전에 알릴지** | 10 | 일정 몇 분 전에 `calendar.starting`을 보낼지 (1\~120) |

## 제공하는 프로필

**회의 준비**(읽기 전용): 회의마다 시작 전에 몇 줄로 알려 줍니다. 누가 오는지, 그 사람들과 지난번에 무슨 얘기를 했는지(메일, 메시지, 노트, 녹음), 서로 걸려 있는 일, 챙기거나 정할 것. `calendar.starting`에 깨어납니다. **관리 → 프로필 → 새 프로필**에서 시작합니다.

## 함께 쓰는 곳

사람의 타임라인, 휴대폰의 **지금**, 하루 브리핑, 녹음이 캘린더를 통해 일정을 읽습니다. 캘린더를 끄면([설정 파일](https://docs.archetype.ing/ko/reference/config.md)에 `"plugins": { "calendar": false }`) 캘린더 화면과 에이전트의 캘린더 도구가 없어지고, 그 기능들은 일정 없이 동작합니다.


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