Molayo

© 2026 Molayo

Dev.to헤드라인2026. 06. 22. 03:53

AI 에이전트에게 전용 편지함 제공하기: API 및 CLI를 통한 Nylas Agent Accounts

요약

Nylas가 AI 에이전트가 독립적인 발신자 평판을 구축할 수 있도록 전용 이메일 및 캘린더 계정을 제공하는 'Agent Accounts' 기능을 출시했습니다. 기존 Nylas API와 엔드포인트를 그대로 활용하여 에이전트가 직접 메시지를 주고받고 이벤트를 관리할 수 있는 환경을 구축하는 방법을 안내합니다.

핵심 포인트

  • 에이전트 전용 이메일 주소와 캘린더를 통해 독립적인 발신자 평판 구축 가능
  • 기존 Nylas API 엔드포인트(Messages, Calendars 등)와 완벽히 호환
  • CLI 및 raw API를 통해 간편하게 에이전트 계정 프로비저닝 가능
  • 자체 도메인 사용 시 에이전트를 진정한 퍼스트 클래스 발신자로 운영 가능

대부분의 "AI 이메일" 데모는 OAuth를 통해 모델을 사람의 편지함에 연결합니다. 이는 에이전트가 직접 참여자가 되고 싶을 때, 즉 사람들이 답장을 보내고, 캘린더 초대를 보내며, 자체적인 발신자 평판 (sender reputation)을 구축할 수 있는 자신만의 주소를 갖기를 원할 때까지는 괜찮습니다. 누군가의 개인 편지함을 가리키는 것만으로는 이를 달성할 수 없습니다.

Nylas Agent Accounts는 다른 접근 방식을 취합니다. 에이전트가 엔드 투 엔드 (end to end)로 소유하는 실제 name@yourdomain.com 메일함과 캘린더를 제공합니다. 에이전트는 메시지를 보내고, 받고, 이벤트를 호스팅하며, RSVP(참석 회신)를 합니다. 상대방 입장에서는 사람이 운영하는 계정과 구별할 수 없습니다. 이 기능은 2026년 6월에 GA (General Availability)되었습니다.

SRE로서 제가 좋아하는 부분은 이것이 새로운 API 접점이 아니라는 점입니다. Agent Account는 단지 또 다른 Nylas grant일 뿐입니다. 이는 여러분이 이미 사용 중인 모든 엔드포인트(Messages, Drafts, Threads, Folders, Attachments, Calendars, Events, Webhooks)와 작동하는 grant_id를 할당받습니다. 데이터 평면 (data plane)에서 새로 배울 것은 없습니다.

이 가이드에서는 두 가지 방식(CLI 및 raw API)으로 하나를 프로비저닝(provision)한 다음, 메시지 전송, 수신, RSVP 및 가드레일 (guardrails)을 추가하는 과정을 살펴봅니다.

제공되는 기능

Agent Account를 생성하면, Nylas는 여러분이 등록한 도메인(또는 Nylas의 *.nylas.email 체험용 도메인)에 실제 메일함을 프로비저닝합니다. 각 계정에는 다음이 포함됩니다:

  • 다른 메일함과 마찬가지로 송수신이 가능한 이메일 주소
  • 6개의 시스템 폴더(inbox, sent, drafts, trash, junk, archive) 및 사용자가 생성하는 사용자 정의 폴더
  • 표준 iCalendar/ICS를 통해 이벤트를 호스팅하고 RSVP를 처리하는 기본 캘린더
  • 모든 기존 Nylas 엔드포인트를 위한 grant_id

시작하기 전에

두 가지가 필요합니다:

  1. Nylas API 키. 가장 빠른 방법은 CLI를 사용하는 것입니다. nylas init 명령 하나로 계정을 생성하고 키를 생성할 수 있습니다.
  2. 도메인. 몇 분 안에 테스트할 수 있는 Nylas 제공 *.nylas.email 체험용 서브도메인 또는 MX + TXT 레코드가 설정된 자체 커스텀 도메인 중 하나가 필요합니다. Organization Settings → Domains에서 등록하세요.

왜 자체 도메인이 필요할까요? 자체 도메인은 에이전트를 공유 릴레이 주소(shared relay address)가 아닌 진정한 퍼스트 클래스 발신자(first-class sender)로 만들어 줍니다. 사람들이 그 주소로 답장을 보내고, 캘린더 초대를 보내며, 해당 메일은 귀하로부터 발송된 것으로 인증됩니다. 새로운 도메인은 약 4주간의 점진적인 발송을 통해 발신자 평판(sender reputation)을 구축하므로, 평판을 격리하기 위해 고객 또는 사용 사례당 하나의 도메인을 운영하세요.

에이전트 계정 생성하기 (Create an Agent Account)

옵션 A — CLI (가장 빠름)

nylas init 이후, 프로비저닝(provisioning)은 명령어 하나로 완료됩니다:

nylas agent account create test@your-application.nylas.email

CLI는 커넥터(connector) 및 상태 세부 정보와 함께 새로운 권한 ID(grant ID)를 출력합니다. 몇 가지 보조 명령어는 다음과 같습니다:

# 모든 에이전트 계정 목록 표시
nylas agent account list

...

마지막 명령어인 nylas agent overview는 계정별로 트리 구조를 렌더링하며, 삭제된 정책/규칙에 대한 유효하지 않은 참조(dangling references)를 표시합니다. 설정이 잘못된 것처럼 보일 때 제가 가장 먼저 사용할 명령어입니다.

옵션 B — API

내부적으로 CLI는 `

수신 메일은 표준 message.created 웹훅을 발생시킵니다. 이 웹훅의 형태는 다른 모든 권한(grant)에 대한 message.created와 동일하므로, 이미 가지고 있는 핸들러를 그대로 사용할 수 있습니다. 게다가 Agent Account는 발송된 메일을 추적하기 위해 message.delivered, message.bounced, message.complaint와 같은 전달 가능성 웹훅(deliverability webhooks)을 발생시킵니다.

메일 보내기 (Send mail)

연결된 권한에 대해 사용하는 것과 동일한 /messages/send 엔드포인트를 사용합니다:

curl --request POST \
  --url "https://api.us.nylas.com/v3/grants/<GRANT_ID>/messages/send" \
  --header "Authorization: Bearer <NYLAS_API_KEY>"
...

수신자는 에이전트의 주소에서 온 일반적인 메시지를 받게 되며,

이들은 개별 권한(grants)이 아닌 **워크스페이스 (workspaces)**를 통해 연결됩니다. 하나의 워크스페이스는 하나의 policy_id와 rule_ids 배열을 가지며, 그 안의 모든 계정은 이 두 가지를 모두 상속받습니다. 각 애플리케이션에는 기본 워크스페이스가 있으므로, 이를 구성하면 할당되지 않은 모든 계정을 한 번에 제어할 수 있습니다.

CLI에서 이를 검사하세요:

nylas agent policy list
nylas agent rule list
nylas agent list list

그리고 CLI에서 각 요소를 생성하세요:

# 규칙의 in_list 조건에서 참조할 수 있는 도메인 유형 목록
nylas agent list create --name "Blocked domains" --type domain --item spam.com

...

--action archive를 --action block으로 바꾸면 규칙이 메시지를 거부합니다. 이는 메시지가 편지함(수신, inbound)이나 제공업체(발신, outbound)에 도달하기 전에 수행됩니다. 이는 데이터 유실 방지(DLP), 테스트 도메인을 운영 환경에서 제외하기, 또는 에이전트가 잘못된 사람에게 이메일을 보내는 것을 방지하는 데 유용합니다. 수신(Inbound) 및 발신(Outbound) 규칙은 격리되어 있습니다. 수신 규칙은 발신 시 절대 실행되지 않으며, 발신 규칙은 저장된 발신 사본을 다시 평가하지 않습니다.

정책(Policies)은 선택 사항입니다. 정책을 건너뛰면 계정은 결제 플랜의 최대 한도 내에서 작동하며 모든 수신 메시지를 받은 편지함으로 전달합니다.

알려진 제한 사항 (무료 플랜)

차원 (Dimension)기본값참고 사항
발신율 (Send rate)계정당 일일 200개 메시지유료 플랜은 기본적으로 일일 제한이 없음
...

마무리

Agent Accounts를 핵심적으로 만드는 점은 별도의 시스템이 필요 없다는 것입니다. 단 한 번의 CLI 명령어나 API 호출로 ID를 프로비저닝(provision)하면, 그 시점부터는 연결된 Gmail이나 Microsoft 권한(grant)에서 사용하던 것과 동일한 Messages, Events, Webhooks 인터페이스를 사용하게 됩니다. 다만 이제는 사용자로부터 빌려온 것이 아니라 에이전트가 소유하게 됩니다.

더 자세히 알고 싶다면:

작성자: Qasim Muhammad, Pouya Sanooei

AI 자동 생성 콘텐츠

본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0