본 콘텐츠는 사용자의 편의를 고려해 자동 기계 번역 서비스를 사용하였습니다. 영어 원문과 다른 오류, 누락 또는 해석상의 미묘한 차이가 포함될 수 있습니다. 필요하시다면 영어 원문을 참조하시기를 바랍니다.
이메일은 세계에서 가장 액세스하기 쉬운 인터페이스입니다. 이는 유비쿼터스입니다. 맞춤 채팅 애플리케이션이나 채널별 맞춤 SDK도 필요 없습니다. 모든 사람은 이미 이메일 주소를 가지고 있습니다. 즉, 누구나 이미 여러분의 응용 프로그램 또는 에이전트와 상호 작용할 수 있습니다. 그리고 에이전트는 누구와도 상호 작용할 수 있습니다.
애플리케이션을 개발하는 중이라면 이미 등록, 알림, 청구서를 이메일에 의존하고 있을 것입니다. 애플리케이션 로직에서만 이 채널이 필요한 것이 아닌 경우가 점점 더 많아지고 있습니다. 에이전트도 마찬가지입니다. 비공개 베타 기간 동안, 고객 지원 에이전트, 청구서 처리 파이프라인, 계정 인증 흐름, 멀티 에이전트 워크플로우 등을 구축하고 있는 개발자들과 이야기를 나눴습니다. 모든 것이 이메일을 기반으로 구축되었습니다. 패턴은 분명합니다. 이메일은 에이전트를 위한 핵심 인터페이스가 되고 있으며 개발자는 이메일을 위해 특별히 구축된 인프라가 필요합니다.
Cloudflare Email Service가 바로 그 부분입니다. Email Routingを使用すると、アプリケーションまたはエージェントにメールを受信できます。 Email Sending, 으로 이메일에 회신하거나 아웃바운드로 이메일을 보내 에이전트가 작업을 마치면 사용자에게 알릴 수 있습니다. 그리고 나머지 개발자 플랫폼과 함께 전체 이메일 클라이언트 및 Agents SDK onEmail hook을 기본 기능으로 구축할 수 있습니다.
오늘 Agents Week의 일환으로 Cloudflare Email Service의 공개 베타 버전이 출시되어 모든 애플리케이션과 에이전트가 이메일을 전송할 수 있게 됩니다. 또한 이메일 네이티브 에이전트 구축을 위한 툴킷도 완성하고 있습니다.
Email Sending: 현재 공개 베타 중
이메일 전송 기능이 오늘 비공개 베타에서 공개 베타 로 전환됩니다. 이제 API 키나 비밀 관리가 필요 없는 기본 Workers 바인딩을 통해 Workers에서 직접 거래 이메일을 전송할 수 있습니다.
export default {
async fetch(request, env, ctx) {
await env.EMAIL.send({
to: "user@example.com",
from: "notifications@your-domain.com",
subject: "Your order has shipped",
text: "Your order #1234 has shipped and is on its way."
});
return new Response("Email sent");
},
};
또는 REST API와 TypeScript, Python, Go SDK를 사용하여 모든 플랫폼, 모든 언어에서 전송할 수 있습니다.
curl "https://api.cloudflare.com/client/v4/accounts/{account_id}/email-service/send" \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
"to": "user@example.com",
"from": "notifications@your-domain.com",
"subject": "Your order has shipped",
"text": "Your order #1234 has shipped and is on its way."
}'
실제로 수신함에 도달하는 이메일을 전송하려면 SPF, DKIM, DMARC 레코드와 씨름해야 합니다. 도메인을 이메일 서비스에 추가하면 모두 자동으로 구성됩니다. 이메일은 인증되어 전달되며, 스팸으로 분류되지는 않습니다. 또한, 이메일 서비스는 Cloudflare 네트워크에 구축된 글로벌 서비스이므로 이메일이 짧은 대기 시간으로 전 세계 어디에 있든 전달됩니다.
수년간 무료로 제공되었던 Email Routing을 결합하면 이제 단일 플랫폼 내에서 완전한 양방향 이메일이 제공됩니다. Cloudflare 내에서 이메일 수신, Worker에서 처리, 회신 등 모든 작업이 가능합니다.
이메일 발송에 대한 자세한 내용은 생일 주간 공지를 참조하세요. 이 게시물의 나머지 부분에서는 이메일 서비스가 에이전트를 위해 무엇을 제공하는지 설명합니다.
Agents SDK: 에이전트가 이메일 네이티브입니다
Cloudflare에 에이전트를 구축하기 위한 Agents SDK에는 이미 인바운드 이메일을 수신하고 처리하기 위한 최고 수준의 onEmail hook 이 있습니다. 하지만 지금까지는 Cloudflare 계정 구성원에게만 이메일을 보내거나 동기적으로 응답할 수 있었습니다.
With Email Sending, 이러한 제약이 사라졌습니다. 이것이 챗봇과 에이전트의 차이점입니다.
이메일 에이전트는 메시지를 수신하고, 플랫폼 전반에서 작업을 오케스트레이션하며, 비동기적으로 응답합니다.
챗봇은 즉시 응답하거나 전혀 응답하지 않습니다. 에이전트는 자신의 타임라인에 따라 생각하고 행동하며 소통합니다. 이메일 전송을 통해 에이전트는 메시지를 수신하고, 데이터를 처리하는 데 1시간 동안, 다른 시스템 3개를 확인하면, 그럴듯한 답변을 할 수 있습니다. 이는 후속 조치를 예약할 수 있습니다. 엣지 케이스를 감지하면 확대할 수 있습니다. 이는 독립적으로 작동할 수 있습니다. 다시 말해, AI는 질문에 대답하는 데 그치지 않고 실제로 작동할 수 있습니다.
다음은 수신, 지속, 회신의 전체 파이프라인이 끝난 지원 에이전트의 모습입니다.
import { Agent, routeAgentEmail } from "agents";
import { createAddressBasedEmailResolver, type AgentEmail } from "agents/email";
import PostalMime from "postal-mime";
export class SupportAgent extends Agent {
async onEmail(email: AgentEmail) {
const raw = await email.getRaw();
const parsed = await PostalMime.parse(raw);
// Persist in agent state
this.setState({
...this.state,
ticket: { from: email.from, subject: parsed.subject, body: parsed.text, messageId: parsed.messageId },
});
// Kick off long running background agent task
// Or place a message on a Queue to be handled by another Worker
// Reply here or in other Worker handler, like a Queue handler
await this.sendEmail({
binding: this.env.EMAIL,
fromName: "Support Agent",
from: "support@yourdomain.com",
to: this.state.ticket.from,
inReplyTo: this.state.ticket.messageId,
subject: `Re: ${this.state.ticket.subject}`,
text: `Thanks for reaching out. We received your message about "${this.state.ticket.subject}" and will follow up shortly.`
});
}
}
export default {
async email(message, env) {
await routeAgentEmail(message, env, {
resolver: createAddressBasedEmailResolver("SupportAgent"),
});
},
} satisfies ExportedHandler<Env>;
Agents SDK의 이메일 기능을 처음 접하는 경우를 위한 내부 상황은 다음과 같습니다.
각 에이전트는 단일 도메인에서 고유한 ID를 가져옵니다. 주소 기반 확인자는 support@yourdomain.com을 "지원" 에이전트 인스턴스로, sales@yourdomain.com을 "sales" 인스턴스로 라우팅하는 식으로 이어집니다. 라우팅이 주소에 내장되어 있으므로 별도의 수신함을 프로비저닝할 필요가 없습니다. 하위 주소 지정(NotificationAgent+user123@yourdomain.com)을 사용해 다른 에이전트 네임스페이스 및 인스턴스로 라우팅할 수도 있습니다.
상태는 이메일 전체에 걸쳐 유지됩니다. 에이전트는 Durable Objects의 지원을 받으므로 this.setState()를 호출하면 에이전트가 세션 전반의 대화 내역, 연락처 정보, 컨텍스트를 기억합니다. 받은 편지함은 별도의 데이터베이스나 벡터 저장소가 없어도 에이전트의 메모리가 됩니다.
안전한 응답 라우팅이 내장되어 있습니다. 에이전트가 이메일을 보내고 응답을 예상하는 경우 원래 메시지를 전송한 정확한 에이전트 인스턴스로 응답이 라우팅되도록 DMAC-SHA256을 사용하여 라우팅 헤더에 서명할 수 있습니다. 이렇게 하면 공격자가 임의의 에이전트 인스턴스로 이메일을 라우팅하기 위해 헤더를 위조하지 못하게 됩니다(대부분의 "에이전트용 이메일" 솔루션에서 해결되지 않은 보안 문제).
이메일을 수신하고, 분석하고, 분류하고, 상태를 유지하고, 비동기 워크플로우를 시작하고, 회신하거나 에스컬레이션하는 등, 모든 작업을 Cloudflare의 네트워크에서 전 세계에 배포된 하나의 에이전트 클래스에서 처리할 수 있도록 팀에서 처음부터 새로 구축하고 있는 이메일 에이전트 파이프라인이 만들어졌습니다.
이메일 서비스는 Cloudflare에서 실행되는 에이전트만을 위한 것이 아닙니다. 로컬 또는 원격 환경에서 실행되는 Claude Code, Cursor, Copilot 등의 코딩 에이전트, 컨테이너 또는 외부 클라우드에서 실행되는 프로덕션 에이전트까지, 에이전트는 모든 곳에서 실행됩니다. 이들은 모두 이러한 환경에서 이메일을 보내야 합니다. Cloudflare는 이메일 서비스의 실행 위치와 관계없이 모든 에이전트에 이메일 서비스를 제공하는 세 가지 통합을 제공할 예정입니다.
이메일은 이제 상담원에게 전체 Cloudflare API에 대한 액세스 권한을 제공하는 동일한 코드 모드 기반 서버인 Cloudflare MCP 서버를통해 사용할 수 있습니다. 이 MCP 서버를 통해 에이전트는 이메일 엔드포인트를 찾고 호출을 통해 이메일을 전송하고 구성할 수 있습니다. 간단한 프롬프트가 포함된 이메일을 보낼 수 있습니다.
"Send me a notification email at hello@example.com from my staging domain when the build completes"
컴퓨터나 bash 액세스 샌드박스에서 실행되는 에이전트의 경우 Wrangler CLI는 코드 모드 블로그 게시물에서 다룬 MCP 컨텍스트 창 문제를 해결합니다. 즉, 에이전트가 단일 메시지 처리를 시작하기도 전에 도구 정의가 수만 개의 토큰을 소비할 수 있습니다. Wrangler를 사용하면 에이전트가 거의 제로에 가까운 컨텍스트 오버헤드를 가진 상태에서 시작하여 `--help` 명령을 통해 온디맨드 방식으로 기능을 탐색할 수 있습니다. 에이전트가 Wrangler를 통해 이메일을 보내는 방법은 다음과 같습니다.
wrangler email send \
--to "teammate@example.com" \
--from "agent@your-domain.com" \
--subject "Build completed" \
--text "The build passed. Deployed to staging."
에이전트에 Cloudflare MCP를 제공하든 Wrangler CLI를 제공하든 관계없이, 프롬프트만 표시되면 에이전트가 사용자를 대신해 이메일을 전송할 수 있습니다.
저희는 또한 Cloudflare Email Service 기술을 게시하고 있습니다. 이 가이드는 에이전트에게 Workers 바인딩 구성, REST API 또는 SDK를 통한 이메일 전송, Email Routing 구성으로 인바운드 이메일 처리, Agents SDK를 사용한 구축, Wrangler CLI 또는 MCP를 통한 이메일 관리 등의 완전한 지침을 제공합니다. 또한 전달 가능성 모범 사례와 스팸이 아닌 수신함에 도착하는 좋은 거래 이메일을 만드는 방법을 다룹니다. 프로젝트에 투입하면 코딩 에이전트가 Cloudflare에서 프로덕션에 사용할 수 있는 이메일을 구축하는 데 필요한 모든 것을 제공해줍니다.
비공개 베타 기간 동안 Cloudflare는 이메일 에이전트도 실험했습니다. 이메일을 검토하고 에이전트가 무엇을 하는지 확인하기 위해 휴먼인더루프(human-in-the-loop) 요소를 계속 사용하고 싶은 경우가 많아졌습니다.이를 수행하는 가장 좋은 방법은 에이전트 자동화가 내장된 완벽한 기능을 갖춘 이메일 클라이언트를 사용하는 것입니다.
그래서 Cloudflare는 Agentic Inbox를 개발했습니다. 이는 대화 스레딩, 이메일 렌더링, 이메일과 첨부 파일의 수신 및 저장, 이메일에 자동으로 회신하는 기능을 모두 갖춘 참조 애플리케이션입니다. 전용 MCP 서버가 내장되어 있으므로, 외부 에이전트가 에이전트 수신함에서 전송하기 전에 검토용 이메일 초안을 작성할 수 있습니다.
저희는 인바운드를 위한 Email Routing, 아웃바운드를 위한 Email Sending, 분류를 위한 Workers AI, 첨부 파일을 위한 R2, 상태 저장 에이전트 로직을 위한 Agents SDK를 사용하여 완전한 이메일 애플리케이션을 구축하는 방법에 대한 참조 애플리케이션으로 Agentic Inbox를 오픈 소싱 하고 있습니다. 오늘 배포하기만 하면 클릭 한 번으로 전체 수신함, 이메일 클라이언트, 이메일 에이전트를 구성할 수 있습니다.
Cloudflare는 이메일 에이전트 도구가 구성 가능하고 재사용 가능하기를 원합니다. 모든 팀이 동일한 인바운드 분류 응답 파이프라인을 다시 구축하는 대신, 이 참조 애플리케이션으로 시작하세요. 이를 분기, 확장, 귀사의 워크플로우에 맞는 자체 이메일 에이전트를 위한 출발점으로 사용하세요.
이메일은 세계에서 가장 중요한 워크플로우가 있는 곳이지만, 상담원이 접근하기 어려운 채널인 경우가 많습니다. 이제 Email Sending 이 공개 베타 버전으로 출시되면 Cloudflare Email Service는 완전한 양방향 커뮤니케이션 플랫폼이 되어 수신함이 에이전트에게 가장 중요한 인터페이스가 됩니다.
수신함에서 고객을 만나는 지원 에이전트를 구축하든, 팀에 실시간으로 소식을 전달하는 백그라운드 프로세스를 구축하든, 이제 에이전트는 전 세계 규모와 원활하게 소통할 수 있습니다. 받은 편지함은 더 이상 사일로가 아닙니다. 이제 에이전트가 도움을 줄 수 있는 곳이 하나 더 생겼습니다.