AgentMail Nedir, Nasıl Kullanılır? Yapay Zekâ Ajanına E-posta Adresi Verme Rehberi

1. agentmail.to adresine gidin ve Get Started düğmesiyle ücretsiz hesap açın. Kredi kartı istenmez.
2. Yönetim panelinde (Console) API Keys bölümünden yeni bir anahtar oluşturun. Anahtar am_ ile başlar.
3. Projenizin kök klasöründe .env adlı bir dosya oluşturup anahtarı buraya yazın:

AGENTMAIL_API_KEY=am_...

Panelden de elle gelen kutusu açıp e-postaları görebilirsiniz; ancak AgentMail'in asıl gücü bu işlemleri koddan, ajanın kendisinin yapabilmesidir.

Python için resmî SDK'yı ve .env dosyasını okumak için yardımcı paketi kurun:

pip install agentmail python-dotenv

Ardından ilk gelen kutusunu oluşturun:

from dotenv import load_dotenv
from agentmail import AgentMail

load_dotenv()
client = AgentMail()  # AGENTMAIL_API_KEY ortam değişkeninden okunur

inbox = client.inboxes.create()
print(inbox.inbox_id)

Alan adı belirtmezseniz kutu …@agentmail.to adresiyle açılır. Ekrana yazdırılan inbox_id aynı zamanda kutunun e-posta adresidir; sonraki adımlarda bu değeri kullanacaksınız.

TypeScript kullanıyorsanız npm install agentmail dotenv ile kurup await client.inboxes.create() çağırmanız yeterlidir. Komut satırını tercih edenler için agentmail-cli aracı da var.

Oluşturduğunuz kutudan kendi e-posta adresinize bir deneme gönderin:

client.inboxes.messages.send(
    inbox.inbox_id,
    to="sizin-adresiniz@example.com",
    subject="Merhaba, ben destek ajanınız",
    text="Bu e-posta AgentMail ile bir yapay zekâ ajanı tarafından gönderildi.",
)

Gerçek bir ajanda text alanını sabit yazmak yerine dil modelinin ürettiği metinle doldurursunuz. Biçimli e-posta için html alanını da ekleyebilirsiniz; düz metin sürümünü de vermek, e-postanın her istemcide okunabilmesini sağlar.

Kutudaki son mesajları listeleyin:

result = client.inboxes.messages.list(inbox.inbox_id, limit=10)

for msg in result.messages:
    print(msg.subject)
    print(msg.extracted_text)

Yanıt e-postalarında alt kısımda genellikle önceki yazışmanın alıntısı bulunur. AgentMail bu alıntıyı ayıklayıp yalnızca yeni yazılan kısmı extracted_text (ve biçimli hâli için extracted_html) alanında verir. Bu alanı dil modeline göndermek hem daha az token harcar hem de ajanın aynı metni tekrar tekrar okumasını önler.

Aynı konudaki mesajlar konuşma zinciri (thread) altında toplanır; ajanın bağlamı kaybetmemesi için yanıt yazmadan önce zincirin tamamını okuması iyi bir alışkanlıktır.

Gelen kutusunu sürekli sorgulamak yerine AgentMail'in yeni e-posta geldiğinde sizin sunucunuza haber vermesini sağlayın:

client.webhooks.create(
    url="https://alanadiniz.com/webhooks/agentmail",
    event_types=["message.received"],
)

Akış şöyle işler:

1. Kutuya e-posta gelir, AgentMail adresinize message.received olayını gönderir.
2. Sunucunuz mesajın tamamını alır ve extracted_text ile konuşma geçmişini dil modeline verir.
3. Model yanıt taslağını üretir; ajan bunu aynı zincire yanıt olarak gönderir (client.inboxes.messages.reply).

Yerel bilgisayarınızda denerken sunucunuzu internete açmak için ngrok gibi bir tünel aracı kullanabilirsiniz. Olay listesinde gönderim, teslim ve geri dönme (message.sent, message.delivered, message.bounced) gibi olaylar da bulunur.

Kod yazmadan denemek istiyorsanız AgentMail'in MCP sunucusunu bir yapay zekâ istemcisine bağlayabilirsiniz. Böylece "Destek kutusundaki okunmamış e-postaları özetle" ya da "Bu müşteriye kibar bir yanıt taslağı hazırla" gibi isteklerle e-postalarınızı sohbetten yönetirsiniz.

• Claude: Ayarlar > Bağlayıcılar bölümünde özel bağlayıcı ekle seçeneğine sunucu adresi olarak https://mcp.agentmail.to/mcp yazın; giriş tarayıcıda onaylanır.
• Cursor: MCP ayarlarına aynı adresi ekleyin ve API anahtarınızı x-api-key başlığıyla verin.

Sunucu gelen kutusu oluşturma, mesaj arama, gönderme, yanıtlama, iletme ve taslak yönetimi gibi araçlar sunar. Hangi araçların kullanılacağını istemcinizin izin ekranından sınırlayabilirsiniz.

Gerçek kullanıcılara e-posta gönderecekseniz destek@sirketiniz.com gibi kendi alan adınızı kullanın. Özel alan adı ücretli planlarda açılır; AgentMail size eklenecek DNS kayıtlarını (SPF, DKIM, DMARC) gösterir. Bu kayıtlar e-postalarınızın spam klasörüne düşmesini önler ve alıcının sizin adınıza gönderilen e-postaya güvenmesini sağlar.

Bilmeniz gereken sınırlar:

• Ücretsiz planda günlük ve aylık gönderim limiti vardır ve e-postaların altına AgentMail imzası eklenir.
• Servisin arayüzü ve belgeleri İngilizcedir; e-posta içeriği ise Türkçe dahil her dilde olabilir.
• Soğuk satış e-postası ve izinsiz toplu gönderim hem servis kurallarına hem de ticari elektronik ileti mevzuatına aykırıdır; yalnızca sizinle iletişime geçmiş ya da onay vermiş kişilere yazın.
• Ajanın gönderdiği her e-posta sizin adınıza gönderilmiş sayılır. Ajanın ne yazdığını düzenli aralıklarla gözden geçirin.