# Gmail

> Gmail 을 연결해 에이전트가 메일을 검색·읽기·초안 작성하게 하고, 발송은 승인했을 때만 하도록 합니다.

Gmail 커넥터는 에이전트가 받은편지함에서 일하게 해줍니다. 검색하고, 메시지와 스레드를 읽고, 초안을 준비하고, 사용자의 [승인](/ko/docs/work/approvals/)이 있으면 발송합니다.

## 언제 쓰는가

Gmail 은 대부분의 에이전트가 값을 하는 커넥터입니다. 받은편지함 일은 반복적이고 규칙의 모양을 하고 있기 때문입니다. 분류하고, 요약하고, 지난 화요일에 누가 요청한 것을 찾고, 어차피 쓰게 될 답장을 초안으로 만드는 일이죠.

## 연결하기

<Steps>

1. **[에이전트 빌더](/ko/docs/build/agent-builder/)에서 커넥터를 열고** Gmail 을 고릅니다.

2. **Google 로 로그인하고 접근을 승인합니다.** Endue 는 동의 화면에 나열된 것만 받습니다.

3. **쓸 에이전트에 바인딩합니다.**

</Steps>

<Aside type="caution" title="어느 Google 계정으로 로그인하는지 확인하세요">
  회사 계정과 개인 계정에 모두 로그인돼 있으면 Google 이 엉뚱한 쪽을 고를 수 있습니다. 연결은
  승인한 그 계정에 묶입니다.
</Aside>

## 에이전트가 할 수 있는 일

| 작업 | 관문 |
| --- | --- |
| 메시지 검색, 스레드 검색 | 없음 |
| 메시지 읽기, 스레드 전체를 순서대로 읽기 | 없음 |
| 라벨 목록, 초안 목록 | 없음 |
| 초안 작성 | 없음 |
| **발송** | **있음** |

검색은 Gmail 자체 문법을 받습니다 — `from:`, `label:`, `is:unread`, `after:`, 따옴표로 묶은 구절 같은 것들이죠. *"이번 주 사라가 보낸 안 읽은 메일"* 이라고 말하면 충분합니다. 질의는 에이전트가 만듭니다.

## 초안, 그다음 발송

초안과 발송을 가르는 것이 안전한 메일 워크플로의 모양입니다.

- **초안**은 관문에 걸리지 않습니다. 자리를 비운 사이 에이전트가 답장 열 개를 준비해 둘 수 있고, 그것들은 Gmail 초안함에 있습니다.
- **발송**은 멈춰 서서 수신자·제목·본문을 보여줍니다. 승인하면 정확히 그 메시지가 나갑니다.

자는 동안 도는 [루틴](/ko/docs/automate/routines/)에는 초안을 요청하세요. 지켜보는 사람이 없는 실행에서의 발송은 대기열에 쌓이는 게 아니라 거절됩니다.

## 결과를 좋게 만들기

- **"처리했다" 가 무슨 뜻인지 말하세요.** *"나에게 직접 질문한 것을 표시하고 그 질문을 인용해줘, 뉴스레터는 무시하고"* 가 *"받은편지함 요약해줘"* 보다 낫습니다.
- **라벨을 가리키세요.** 이미 관리하고 있는 라벨에서 시작하는 에이전트는 사용자의 분류 기준을 새로 만드는 대신 물려받습니다.
- **메일함 하나로 유지하세요.** Google 계정이 둘이면 연결을 둘 승인하고 각각 필요한 에이전트에 바인딩하세요.

## 한계

- 연결 하나에 Gmail 계정 하나입니다.
- 에이전트는 승인 범위 안의 것은 무엇이든 읽을 수 있습니다. 그 범위가 마음에 걸린다면 Gmail 을 꼭 필요한 에이전트에만 바인딩하세요.
- 첨부파일은 읽지 않습니다.
- 발송은 항상 승인이 필요합니다. 지켜보는 사람 없이 보내도록 허용하는 설정은 없습니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="Google Workspace"
    href="/ko/docs/connect/google-workspace/"
    description="캘린더 · 드라이브 · 문서 · 스프레드시트 · 슬라이드 · 태스크 · 주소록."
  />
  <LinkCard
    title="승인"
    href="/ko/docs/work/approvals/"
    description="메시지가 나가기 전에 보게 되는 것."
  />
  <LinkCard
    title="루틴"
    href="/ko/docs/automate/routines/"
    description="일어나기 전에 도는 받은편지함 브리핑."
  />
</CardGrid>
