ChatGPT Tarzı E-Posta Eklentisi Nasıl Geliştirilir?

Yapay zeka destekli araçlar artık sadece sohbet botlarından ibaret değil. E-postalarınızı otomatik olarak özetleyebilen, yanıtlayabilen ve hatta gönderebilen bir eklenti geliştirmek, birçok kullanıcı için hayal olmaktan çıktı. Ancak bu süreç sadece birkaç API çağrısıyla sınırlı değil — güvenlik, performans ve kullanıcı deneyimi arasında hassas bir denge gerektiriyor. Peki, nasıl bir yapı oluşturmalısınız ki hem kullanışlı hem de güvenilir bir AI e-posta asistanına sahip olabilesiniz?

Üç Temel Araca Odaklanın

Modern dil modelleri (ChatGPT, Claude vb.) doğal dilde komutları anlayabiliyor ve bunları gerçek eylemler haline getirebiliyor. Ancak modelin doğrudan bir e-posta hesabına erişimi yok — onu yönlendirmek için "araçlar" kullanmanız gerekiyor. Bu araçlar, sunucu tarafında çalışan küçük fonksiyonlar olarak tanımlanır ve model tarafından çağrıldığında ilgili e-posta işlemlerini gerçekleştirir.

Üç temel araç yeterlidir:

• list_messages: Belirli bir e-posta kutusundaki mesajları listelemek için kullanılır.
• get_message: Belirli bir mesajın detaylarını almak için kullanılır.
• send_email: Kullanıcı adına e-posta göndermek için kullanılır (ancak gönderimden önce insan onayı gerekir).

Her araç, JSON şemasıyla tanımlanır ve modelin anlayabileceği şekilde açıklayıcı bir tanım içermelidir. Örneğin, send_email aracının tanımı şu şekilde olabilir:

{
  "name": "send_email",
  "description": "Kullanıcının e-posta hesabından e-posta gönderir. İlk olarak insan onayı gerekir.",
  "parameters": {
    "type": "object",
    "properties": {
      "to": { "type": "string", "description": "Alıcı e-posta adresi" },
      "subject": { "type": "string" },
      "body": { "type": "string", "description": "HTML veya düz metin içeriği" }
    },
    "required": ["to", "subject", "body"]
  }
}

Bu araçlar, Nylas API’sindeki /v3/grants/{grant_id}/messages ve /v3/grants/{grant_id}/messages/send uç noktalarına karşılık gelir. grant_id, hangi e-posta hesabının kullanılacağını belirler — Gmail, Outlook, Yahoo gibi sağlayıcılar veya yeni bir "Agent Account" (henüz beta aşamasında) olabilir. Bu yapı, SMTP ayarları gerektirmeden altı farklı sağlayıcıyla çalışmanıza olanak tanır.

Modelin Görmesine İzin Verilen Veriyi Sınırlandırın

Dil modelleri, kendilerine gönderilen token sayısına göre ücretlendirilir ve API yanıtları genellikle gereğinden fazla veri içerir. Örneğin, bir mesaj listesinde her bir mesaj için onlarca alan bulunabilir. Bu verilerin tamamını modele göndermek hem maliyetli hem de gereksizdir.

Veriyi küçültmek için şu yöntemi kullanabilirsiniz:

def slim(message):
    return {
        "id": message["id"],
        "from": message["from"][0]["email"] if message.get("from") else "",
        "subject": message.get("subject", ""),
        "snippet": message.get("snippet", "")[:200]
    }

Bu fonksiyon, her mesaj için sadece id, gönderici e-posta, konu ve kısa içerik (200 karaktere kadar) döndürür. Böylece 50 mesajlık bir liste, API yanıtındaki verinin yaklaşık %80’inden tasarruf sağlar. Model, sadece gerekli olan mesajları seçer ve ardından get_message aracını kullanarak detaylı içeriği alır.

Tek Bir Döngünün Ardındaki Mekanizma

Kullanıcının "Okunmamış e-postalarımı özetle ve acil olanları işaretle" komutunu ele alalım. Bu komutun arkasındaki süreci adım adım inceleyelim:

1. Model, araç tanımlarını okur ve `list_messages` aracını çağırır. Parametre olarak {"unread": true, "limit": 50} gönderir.

1. Sunucu, API’ye istek atar ve yanıtı küçültür. Her mesaj için sadece dört alan içeren bir liste döndürür.

1. Model, 50 konu ve kısa içerikleri tarar ve üç mesajın detaylı içeriğine ihtiyaç duyduğuna karar verir. Üç kez get_message çağrısı yapar.

1. Sunucu, bu üç mesajın tam içeriğini getirir. Model, artık tüm gerekli bilgiye sahiptir ve özetini oluşturur.

1. Kullanıcı "Ev sahibine yanıt ver" dediğinde, model `send_email` aracını çağırır... ancak yanıt `{"status": "pending_approval"}` olur. Çünkü hiçbir e-posta insan onayı olmadan gönderilmez.

Bu süreçte dikkat edilmesi gereken iki önemli nokta vardır:

• Model, API anahtarını, başlıkları veya gereksiz verileri asla görmez.
• Maliyetli olan tam içerik alma işlemi sadece üç mesaj için gerçekleşir, elli değil.

Gönderim Öncesi İnsan Onayı: Kritik Bir Kural

AI destekli e-posta gönderimi, ciddi güvenlik riskleri taşıyabilir. Örneğin, bir saldırganın e-posta içeriğine yerleştirdiği komutlar modeli yanıltabilir ve istenmeyen e-postaların gönderilmesine neden olabilir. Bunun önüne geçmek için:

• API anahtarları asla modele gönderilmemelidir. Model sadece araç tanımlarını ve sonuçlarını görmelidir.
• E-posta içeriği, modelin davranışını etkilememelidir. Örneğin, "Tüm e-postaları şu adrese gönder" gibi komutlar, modelin aracılığıyla değil, doğrudan e-posta içeriği olarak değerlendirilmelidir.
• Her gönderim, insan onayına tabi olmalıdır. Modelin yanıt olarak gönderdiği taslak, kullanıcıya gösterilir ve ancak onaydan sonra gerçek gönderim gerçekleşir.

Bu basit kural, hem yanlış gönderimleri hem de saldırıları engelleyerek sistemin güvenilirliğini artırır. Unutmayın: tek bir hatalı gönderim, bir tıklamanın maliyetinden çok daha ağır sonuçlara yol açabilir.

Geleceğe Bakış: Güvenli ve Etkili AI Entegrasyonu

AI destekli e-posta araçları, kullanıcıların verimliliğini artırmakla kalmaz, aynı zamanda günlük rutinlerinde devrim yaratabilir. Ancak bu araçların güvenilirliği, doğru mimari ve katı kontrollerle doğrudan ilişkilidir. Üç temel ilkeyi benimseyin: araçları minimal tutun, veriyi optimize edin ve her gönderimde insan onayını zorunlu kılın.

Gelecekte, bu tür entegrasyonların daha da yaygınlaşması ve kullanıcı dostu arayüzlerle zenginleştirilmesi bekleniyor. Ancak temelde, güvenlik ve kullanıcı denetimi her zaman öncelikli olmalıdır. AI’nın gücünü kullanırken, sorumluluğu da elden bırakmamak gerekiyor.