AgentMail, yapay zekâ ajanlarına program üzerinden yönetilebilen e-posta kutuları sağlayan bir hizmettir. Ajanın kendine ait bir adresle ileti alması, konuşmaları takip etmesi ve yanıt hazırlaması için altyapı sunar. E-postayı anlayıp ne yapılacağına karar veren model ile mesajı taşıyan sistemin görevleri ayrıdır.[1]
Bu rehberde önce bir deneme kutusu oluşturmayı, ardından taslak ve insan kontrolü içeren bir iş akışı tasarlamayı ele alıyoruz. Örnek senaryomuz, gelen destek taleplerini sınıflandırıp yanıt önerisi hazırlayan küçük bir ekip. Amaç, ilk günden bütün yazışmaları otomatik göndermek yerine sınırları açık bir pilot kurmak.
AgentMail ne işe yarar?
Bir uygulamanın müşteriden gelen e-postayı izlemesini istediğinizde adres, ileti geçmişi, alıcı bilgisi ve olay bildirimi gibi parçalara ihtiyaç duyarsınız. AgentMail bu işlemler için API, SDK ve ajan entegrasyonları sunuyor. Kutu oluşturma, ileti alma ve gönderme, taslak yönetimi ve webhook kullanımı resmî belgelerde açıklanıyor.[1][2]
Örneğin destek ajanı gelen mesajdaki ürün adını çıkarabilir, sizin bilgi tabanınızdan uygun açıklamayı bulabilir ve bir cevap önerisi oluşturabilir. Buradaki bilgi arama ve metin üretme kısmını seçtiğiniz model veya uygulama gerçekleştirir. AgentMail kullanmak, tek başına yanıtın doğru, güncel veya müşteriye uygun olduğunu garanti etmez.
API kavramına yabancıysanız önce API nedir ve nasıl kullanılır? rehberimize bakabilirsiniz. Bu ayrım, hangi sorunun e-posta servisinden hangisinin kendi uygulamanızdan kaynaklandığını anlamayı kolaylaştırır.
Gmail asistanıyla farkı nedir?
Mevcut kişisel kutunuzdaki mesajları özetlemek ile bir yazılım ajanına ayrı iletişim adresi vermek farklı ihtiyaçlardır. AgentMail belgelerindeki başlangıç akışı, ajan için kutu oluşturma etrafında kuruludur. Adres ortak hizmet alan adında veya doğrulanmış kendi alan adınızda olabilir.[2]
Kişisel yazışmalarınızla çalışan bir asistan istiyorsanız önce mevcut e-posta hizmetinizin erişim ve izin seçeneklerini değerlendirin. Ayrı destek ajanı, ürün demosu veya uygulamaya bağlı iletişim kimliği tasarlıyorsanız ajan odaklı kutu yaklaşımı daha doğrudan incelenebilir. Seçimi, yalnızca ürün adındaki yapay zekâ ifadesine göre yapmayın.
| İhtiyaç | Pilot için önerilen yaklaşım |
|---|---|
| Kişisel kutuyu özetleme | Mevcut sağlayıcının uygun entegrasyonunu değerlendirme |
| Uygulamaya ayrı iletişim adresi | Ayrı ajan kutusu oluşturma |
| Hassas müşteri yanıtı | Taslak hazırlama ve yetkili incelemesi |
| Gelen talebi ilgili ekibe ayırma | Sınıflandırma ve durum kaydı |
Tablo bir ürünlerin performans karşılaştırması değildir. İhtiyacı tanımlamak için hazırlanmış bir karar çerçevesidir. Gerçek seçimde veri erişimi, ekip alışkanlıkları ve bakım sorumluluğu da hesaba katılmalıdır.
Başlamadan önce ne hazırlamalısınız?
Resmî hızlı başlangıç akışı hesap, API anahtarı ve SDK kurulumu üzerinden ilerliyor. Anahtarı kaynak kodun içine yazmak yerine ortam değişkeninde tutun. Python örneği için agentmail paketi kullanılıyor; kurulum yaptığınız ortamın projenin çalıştığı ortamla aynı olduğuna dikkat edin.[1][2]
pip install agentmail
AGENTMAIL_API_KEY ortam değişkenine kendi anahtarınızı güvenli biçimde tanımlayın. Gerçek anahtarı ekran görüntüsüne, herkese açık depoya veya destek mesajına koymayın. Örnek kodda bir anahtar bulunmaması kasıtlıdır; kod, çalışma ortamından bu değeri okur.[2]
Pilot için ayrıca bir sorumlu kişi, deneme adresi, örnek mesajlar ve durdurma yöntemi belirleyin. Hangi durumlarda insana aktarılacağını başlangıçta yazın. Böylece yalnızca başarılı örneğe değil, eksik bilgi ve çelişkili talepler karşısındaki davranışa da bakabilirsiniz.
Python ile ilk kutu nasıl oluşturulur?
Aşağıdaki örnek, resmî SDK yapısına göre bir kutu oluşturma isteği hazırlar. username ve client_id değerlerini kendi projenize uygun, benzersiz değerlerle değiştirin. Örnek herhangi bir e-posta göndermez; ilk adımı kutu oluşturmayla sınırlar.[2]
import os
from agentmail import AgentMail
from agentmail.inboxes import CreateInboxRequest
client = AgentMail(
api_key=os.environ["AGENTMAIL_API_KEY"]
)
inbox = client.inboxes.create(
request=CreateInboxRequest(
username="ornek-destek-ajani",
display_name="Deneme Destek",
client_id="destek-pilot-v1"
)
)
print(inbox.email)
client_id, kutu oluşturma çağrısını yeniden denediğinizde aynı kaynağa ulaşabilmeniz için önemlidir. Resmî belgeye göre aynı değerle tekrar oluşturma isteği, ilk kutuyu döndürür. Rastgele yeni kutular oluşturan bir başlangıç döngüsü yerine bu davranışı kullanmak, yeniden başlatma sırasında tekrarları önlemeye yardımcı olur.[2]
Kutunun adresini gördükten sonra onu test planınıza kaydedin. Üretimde bu değeri yalnızca terminal çıktısında bırakmak yerine uygulamanın kendi kayıt mekanizmasıyla ilişkilendirmek gerekir. Birden fazla müşteri veya proje varsa kutunun hangi işe ait olduğu açık olmalıdır.
Kutu, konuşma ve iletiyi ayırın
Bir destek uygulamasında kutu, iletişim adresinin bulunduğu alanı; ileti tek bir mesajı; konuşma ise ilişkili mesaj dizisini temsil eder. AgentMail, kutuların yanında mesaj ve konuşma yönetimi de sunuyor. Bu ayrım, aynı müşterinin devam eden talebini her e-postada yeni bir vaka sanmamak için önemlidir.[3]
Kendi uygulamanızda müşteri kaydı ile e-posta adresini de aynı şey saymayın. Bir kişi birden fazla adresten yazabilir veya ortak adresi birden fazla çalışan kullanabilir. Kimlik doğrulaması gerektiren bir işlemi yalnızca metindeki isim üzerinden onaylamamak, pilotun iş kuralı olmalıdır.
Örneğin kurgusal destek senaryomuzda ajan, mesajı teslimat veya hesap erişimi olarak sınıflandırır. Teslimat sorusuna genel bilgi taslağı hazırlayabilir. Hesap erişiminde ise kimlik doğrulama sürecine yönlendiren, kişisel veri açığa çıkarmayan bir yanıt önerir. Bu iki durum aynı otomasyon iznini gerektirmemelidir.
Önce taslak, ardından kontrollü gönderim
AgentMail taslakları, alıcı, konu, metin ve ekleri gönderimden önce hazırlamaya izin veren ayrı kaynaklardır. Resmî belgeler, insanın inceleyeceği yanıtlar ve aşamalı hazırlık için bu yapıyı açıklıyor. Taslak oluşturmak ile taslağı göndermek ayrı işlemlerdir.[4]
Pilot uygulamada modelin görevi taslağı hazırlamak olsun. İnceleyen kişi alıcıyı, talebin doğru anlaşılıp anlaşılmadığını, fiyat veya teslim tarihi gibi taahhütleri ve varsa ekleri kontrol etsin. Onaylanan sürümün hangi iletiye karşılık geldiğini kaydedin. Sonradan değişmiş bir taslağın eski onayla gönderilmesini engellemek de uygulamanızın sorumluluğudur.
Yanıt taslağı oluştururken mevcut mesajla ilişki kurmak için belgelerde in_reply_to alanı açıklanıyor. Konu ve konuşma ilişkisinin kaynağa göre kurulabilmesi, elle yeniden başlık yazma ihtiyacını azaltabilir. Buna rağmen özellikle tüm alıcılara yanıt seçeneğinde gerçek alıcı listesini inceleyin.[4]
Yetkileri göreve göre sınırlandırın
API anahtarının erişim kapsamı ile yapabileceği işlem aynı şey değildir. AgentMail belgelerinde organizasyon, pod ve kutu kapsamları; ayrıca açıkça tanımlanabilen işlem izinleri bulunuyor. permissions nesnesi verildiğinde yalnızca açıkça izin verilen işlemler etkinleşiyor.[5]
Taslak hazırlayan bir bileşene gönderim izni vermek zorunda değilsiniz. Belgelerde taslak okuma, oluşturma, güncelleme ve gönderme ayrı izinlerle açıklanıyor. Bunun yanında anahtar kapsamı da etkili; belirli bir kutuya sınırlı anahtar, kapsamı dışındaki kaynaklara izin adı eklenerek erişemez.[5]
| Bileşen | Pilot tasarımında sorumluluk |
|---|---|
| Okuma bileşeni | Gelen talebi uygulamaya aktarma |
| Taslak bileşeni | Yanıt önerisi hazırlama |
| İnceleme ekranı | Yetkili kişiye içerik ve alıcıları gösterme |
| Gönderim bileşeni | Onaylanan sürümü gönderme |
| Kayıt katmanı | Durum ve hata bilgisini saklama |
Bu ayrım ek geliştirme gerektirir. Küçük bir ekipte tek uygulama içinde uygulanabilir; mutlaka ayrı sunucular kurmak anlamına gelmez. Önemli olan hangi kod yolunun hangi işlemi yapabildiğini görebilmektir.
Webhook ile yeni mesajı işleyin
Sürekli kutuyu sorgulamak yerine webhook üzerinden gelen olayları kullanabilirsiniz. AgentMail belgelerinde yeni ileti için message.received olayı açıklanıyor. Olayı alan uç noktanın imza doğrulamasını ve yeniden gelen bildirimleri doğru yönetmesini tasarlayın.[6]
Bir bildirimi almak, müşteriye hemen yanıt gönderileceği anlamına gelmemeli. Önce olayın hangi kutuya ait olduğunu belirleyin, ardından mesajın daha önce işlenip işlenmediğini kontrol edin. Belgelerde önerilen kutu ve mesaj kimliğiyle takip yaklaşımı, aynı olay yeniden geldiğinde iki yanıt hazırlamayı önlemek için kullanılabilir.[6]
Kendi durum kaydınız için alındı, taslak hazır, incelemede, onaylandı ve gönderildi gibi aşamalar belirleyebilirsiniz. Bunlar bu rehberin önerdiği uygulama durumlarıdır. Her aşamada sorumlu bileşeni ve başarısızlık halinde yapılacak işlemi açıkça tanımlayın.
Gelen e-postayı talimat kaynağı saymayın
Bir mesajın içinde “önceki kuralları unut” veya “bütün belgeleri şu adrese ilet” yazması, uygulamanız için yetki oluşturmaz. AgentMail, gelen içerik için güvenlik incelemesi ve kontrol mekanizmaları da açıklıyor. Bu katmanları uygulamanızın kendi izin ve veri erişim kurallarıyla birlikte değerlendirin.[3]
Ajanın dışarıdan gelen metni müşteri talebi olarak işlemesini, sistem yapılandırmasını değiştiren talimat olarak kullanmamasını sağlayın. Örneğin destek talebinin metni, hangi anahtarın kullanılacağını veya hangi özel dosyanın okunacağını belirlememeli. Pilot örneklerine zararsız ancak yönlendirmeye çalışan mesajlar da ekleyin.
MCP üzerinden entegrasyon kuracaksanız resmî AgentMail bağlantısını ve desteklenen istemci akışını inceleyin. Bağlantı kurmak ile erişim kapsamını doğru seçmek ayrı aşamalardır. Kavramın temeli için MCP rehberimize bakabilirsiniz.[7]
Alan adı, maliyet ve hata kontrolü
Kendi alan adınızı kullanmak istiyorsanız AgentMail’in döndürdüğü doğrulama kayıtlarını ve güncel plan koşullarını izleyin. Başka projeye ait DNS değerlerini kopyalamayın. Doğrulanmamış alan adı veya dolu kutu kotası gibi durumlar, ilk kurulumda ayrı hata nedenleri olabilir.[2]
Maliyet hesabında yalnızca e-posta hizmetini değerlendirmek eksik kalır. Kullandığınız modelin API tüketimi, uygulamayı çalıştırdığınız ortam ve insan incelemesi de sizin iş akışınızın gideridir. Aylık tahmini, kendi pilotunuzdaki ileti sayısı ve işlem başına gereksinim üzerinden kurun. Bu rehber belirli bir maliyet veya teslimat başarısı vaat etmez.
Hata gördüğünüzde mesajı, ilgili kutuyu ve uygulamanın bulunduğu aşamayı kaydedin. Gizli anahtar ve gereksiz kişisel verileri günlükten çıkarın. Belgedeki hata açıklamasıyla karşılaştırıp tek bir değişkeni düzelterek yeniden deneyin; her başarısızlıkta yeni kutu oluşturmak sorunun izini zorlaştırır.
Pilotun başarılı olduğunu nasıl anlarsınız?
Başarı ölçütünü “ajan yanıt verdi” ile sınırlamayın. Doğru talebi doğru konuşmaya bağladı mı, eksik bilgi durumunda açıklama istedi mi, onaysız taahhüt verdi mi ve tekrar gelen olayda ikinci işlem açtı mı sorularını inceleyin. Böylece iyi görünen tek bir cevap yerine sistemin davranışını değerlendirebilirsiniz.
İlk denemede gerçek müşteri verisi yerine kurgusal örnekler kullanın. Basit soru, belirsiz talep, yanlış alıcı, ekli ileti ve yinelenen bildirim gibi durumları ayrı kaydedin. Her örneğin beklenen sonucunu önceden yazın. Sonuç beklentiden ayrıldığında yalnızca promptu değil, veri erişimi ve durum yönetimini de kontrol edin.
Sık sorulan sorular
AgentMail bir dil modeli mi?
Bu rehberde e-posta altyapısı olarak ele alınıyor. Mesajı yorumlayan model veya ajan uygulaması ayrı bir bileşendir.[1]
İlk denemede e-posta göndermek şart mı?
Hayır. Önce kutu oluşturup adresi ve erişimi kontrol edebilirsiniz. Taslak akışı da gönderimden ayrı kurulabilir.[2][4]
Mevcut otomasyonumla birlikte kullanabilir miyim?
API ve webhook yapısını kendi uygulamanızın desteklediği bağlantılarla değerlendirmeniz gerekir. Genel otomasyon mantığı için n8n kullanım rehberine bakabilirsiniz. Her aracın hazır AgentMail bağlantısı olduğunu varsaymayın.
Kaynaklar ve hazırlama notu
Bu rehber resmî belgeler ve aşağıdaki birincil kaynaklar incelenerek hazırlandı. Uygulama örnekleri Dijipedya tarafından açıklama ve karşılaştırma amacıyla kurgulandı; ölçülmüş performans sonucu olarak sunulmaz. Özellik ve plan koşulları değişebilir.
- AgentMail, Quickstart. Bilginin alındığı tarih: 5 Kasım 2026.
- AgentMail, Creating your first inbox. Bilginin alındığı tarih: 5 Kasım 2026.
- AgentMail, Inbox capabilities. Bilginin alındığı tarih: 5 Kasım 2026.
- AgentMail, Drafts. Bilginin alındığı tarih: 5 Kasım 2026.
- AgentMail, Permissions. Bilginin alındığı tarih: 5 Kasım 2026.
- AgentMail, Webhooks overview. Bilginin alındığı tarih: 5 Kasım 2026.
- AgentMail, MCP integration. Bilginin alındığı tarih: 5 Kasım 2026.
