OpenAI, daha uzun oturumlar boyunca çalışabilen, dış araçları kullanabilen, kod çalıştırabilen ve uzmanlaşmış alt ajanları koordine edebilen yapay zeka ajanları oluşturmak için yönetilen bir API tanıttı.
Yeni Agents API’de yerleşik bir Telegram entegrasyonu yok. Geliştiricilerin onu yine Telegram’ın Bot API’sine bağlaması ve mesajlaşma katmanını kendilerinin kurması gerekiyor.
Ancak bu API, botların neler yapabileceğini değiştirebilir.
Bir Telegram botu tek bir prompt alıp tek bir model yanıtı döndürmek yerine uzun süren bir görev başlatabilir, birkaç araçla çalışabilir ve iş bittiğinde sonucu geri gönderebilir. Bu da ürünü geleneksel bir sohbet botundan çok kalıcı bir asistana yaklaştırıyor.
OpenAI gerçekte neyi kullanıma sundu
Agents API, geliştiricilere OpenAI tarafından yönetilen bir hizmet aracılığıyla Codex’in kullandığı ajan çalışma altyapısına erişim sağlıyor.
Agents API’nin resmî belgelerine göre OpenAI; ajanın oturumlarını, orkestrasyonu, bağlam sıkıştırmayı ve kurtarmayı yönetiyor. Geliştiriciler talimatları sağlıyor, gerekli araçları bağlıyor ve yürütmenin nerede gerçekleşeceğini seçiyor.
Bir ajan yalnızca soruları yanıtlaması ya da dış fonksiyonları çağırması gerekiyorsa sandbox olmadan çalışabilir. Dosya ya da kod içeren görevler için OpenAI’ın barındırdığı bir ortamı ya da geliştiricinin kontrol ettiği, kendi barındırdığı bir ortamı kullanabilir.
Bir ortamın içinde ajan şunları yapabilir:
- Kod ve komut çalıştırmak.
- Dosya okumak, oluşturmak ve düzenlemek.
- MCP sunucularına bağlanmak.
- Geliştiricinin sağladığı fonksiyonları ve dış araçları kullanmak.
- Dosyalar ve başka çıktılar üretmek.
- İşi birden fazla alt ajana devretmek.
API şu anda beta aşamasında. OpenAI’ın hızlı başlangıç kılavuzu, bir betik oluşturan, onu barındırılan bir sandbox’ta çalıştıran ve sonucu döndüren bir ajanı gösteriyor.
Bu, bir Telegram botunun normal bir model çağrısından elde ettiğinden çok daha fazla altyapı demek. Geliştiricinin artık ajan döngüsünün her parçasını kurması, uzun sohbet geçmişini sıkıştırması ya da ajanın çalışma durumunu elle kurtarması gerekmiyor.
Bunun Telegram botları için önemi
Telegram’daki yapay zeka botlarının çoğu hâlâ bilindik bir düzeni izliyor: kullanıcı bir mesaj gönderiyor, bot bunu bir model API’sine iletiyor ve ortaya çıkan metin sohbete geri dönüyor.
Bu, sorular, yazma yardımı, çeviri ve medya üretimi için iyi çalışıyor. Ancak kullanıcı bottan birkaç adımlı bir işi tamamlamasını istediğinde işler zorlaşıyor.
On ürünü karşılaştırıp bir rapor hazırlaması istenen bir araştırma botunu düşünün. Temel bir sohbet botu tüm görevi tek bir yanıtta yapmaya çalışabilir. Bir ajan ise araştırmayı alt ajanlar arasında bölebilir, bulguları toplayabilir, bir belge oluşturabilir ve iş bittiğinde haber verebilir.
Aynı yapı şu tür Telegram botlarını mümkün kılabilir:
- Yüklenen belgeleri inceleyip bitmiş bir rapor üreten botlar.
- Dosyalar ve dış araçlarla teknik bir sorunu araştıran botlar.
- Bir iş akışını izleyip önemli bir değişiklik olduğunda geri dönen botlar.
- Verileri analiz edip bir tablo oluşturan ve sohbete geri gönderen botlar.
- Araştırma, yazma ve doğrulama için uzmanlaşmış ajanları koordine eden botlar.
- Bağlamı her seferinde yeniden kurmadan bir projeyi birkaç mesaj boyunca sürdüren botlar.
Telegram, sohbet ve bildirim arayüzünü sağlıyor. Agents API ise arkadaki yönetilen ajan çalışma ortamını sağlıyor.
Bu ayrım önemli. Yapay zeka Telegram’ın içinde çalışmıyor ve Telegram, OpenAI’ın ajan özelliklerine otomatik olarak erişim kazanmıyor. Bot, Telegram kullanıcısı ile başka bir yerde barındırılan bir ajan oturumu arasında köprü görevi görüyor.
Oturumlar modelin en kullanışlı parçası
Agents API, tek tek isteklere değil, kalıcı oturumlara dayanıyor.
Bir oturum ajanın yapılandırmasını, sohbeti ve kaydedilen çalışmayı zaman içinde saklar. Geliştiriciler boş bir bağlamdan yeniden başlamak yerine aynı oturuma yeni mesajlar gönderebilir. Turlar eşzamansız çalışabilirken uygulamalar ilerlemeyi akışlı olaylar üzerinden takip edebilir ya da durum değişikliklerini webhook’larla alabilir.
OpenAI, oturum yaşam döngüsünü ajan oturumlarını çalıştırma ve sürdürme rehberinde açıklıyor.
Bir Telegram botunda geliştirici her kullanıcıyı, özel sohbeti ya da grup konusunu belirli bir ajan oturumuyla eşleştirebilir. Yeni bir mesaj geldiğinde bot onu aynı oturuma yönlendirir.
Bu, sohbetlerin daha kesintisiz hissettirmesini sağlayabilir. Bir kullanıcı telefonundan bir araştırma görevi başlatabilir, daha sonra başka bir dosya gönderebilir ve ilk talimatları tekrarlamadan ajandan çıktısını düzeltmesini isteyebilir.
Geliştiricinin yine de oturumların ne zaman yeniden kullanılacağına, ayrılacağına ya da silineceğine karar vermesi gerekir. Her sohbeti otomatik olarak tek bir kalıcı oturuma koymak, birbiriyle ilgisiz işleri karıştırabilir ya da bağlamı kullanıcıların beklediğinden uzun süre saklayabilir.
Telegram desteği dahil değil
Potansiyeline rağmen Agents API, kullanıma hazır bir Telegram bot platformu değil.
Telegram güncellemelerini alan, kullanıcıları doğrulayan ya da ajan olaylarını Telegram mesajlarına dönüştüren resmî bir OpenAI paketi yok. Geliştiricilerin bu entegrasyonu Telegram’ın Bot API’sini ya da mevcut bir framework’ü kullanarak kurması gerekiyor.
Entegrasyon katmanının şunları ele alması gerekir:
- Gelen mesajlar, komutlar ve ekler.
- Telegram sohbetlerinin OpenAI oturum kimlikleriyle eşleştirilmesi.
- Telegram dosyalarının ajanın erişebileceği girdilere dönüştürülmesi.
- Sohbeti doldurmadan ilerlemenin aktarılması.
- Nihai metnin, belgelerin ve diğer çıktıların teslimi.
- API, ağ ya da bot teslimat hatalarından kurtulma.
- Kullanıcı fikrini değiştirdiğinde işin iptal edilmesi.
- Kullanıcıların ve grup sohbetlerinin güvenli biçimde ayrılması.
Telegram zaten akışlı yanıtlar, özel sohbetlerde konular ve yapılandırılmış mesajlar dahil yapay zeka ürünlerine uygun arayüzler sunuyor. Bot özellikleri belgeleri de yapay zeka ajanlarını yerleşik bir kullanım alanı olarak tanımlıyor.
Ancak bu arayüz özellikleri, iki hizmet arasındaki uygulama mantığının yerini tutmuyor.
Bu da Agents API’yi, Microsoft’un Agent Framework için kısa süre önce tanıttığı ve Telegram güncellemelerini ajan girdisine çeviren daha doğrudan bir adaptör içeren Telegram kanal paketinden ayırıyor. OpenAI ajan çalışma ortamını sağlıyor; Telegram köprüsü ise geliştiricinin sorumluluğunda kalıyor.
Uzun süren görevler farklı bir kullanıcı deneyimi gerektirir
Bir bota daha güçlü bir arka uç vermek onu otomatik olarak daha kolay kullanılır yapmaz.
Birkaç dakika süren bir görev sıradan bir sohbet yanıtı gibi davranamaz. Kullanıcıların ajanın hâlâ çalışıp çalışmadığını, onay mı beklediğini, bilgi mi istediğini ya da başarısız mı olduğunu bilmesi gerekir.
Telegram ilerleme güncellemelerine olanak tanıyor, ancak her iç olayı göndermek sohbeti hızla boğar. Daha iyi bir tasarım tek bir durum mesajını düzenleyebilir, yalnızca anlamlı aşamaları gösterebilir ve nihai sonucu ayrıca teslim edebilir.
Botun ayrıca bir görevi durdurmanın net bir yolunu sunması gerekir. Bir ajan web’de gezinebiliyor, araç çağırabiliyor ya da dosyaları değiştirebiliyorsa, basit bir /cancel komutu tek bir yanıt üreten bir sohbet botuna göre çok daha önemli hale gelir.
Onaylar da dikkate alınması gereken bir başka konu. Bilgileri inceleyen bir ajan, e-posta gönderen, bir veritabanını değiştiren ya da bir işlem yürüten bir ajandan farklıdır. Dış sonuçları olan işlemler genel bir “çalışıyor” göstergesinin arkasına gizlenmemelidir.
En kullanışlı Telegram ajanları muhtemelen iç işleyişlerini daha az gösterirken kullanıcılara önemli kararlar üzerinde daha fazla kontrol verecek.
Gizlilik ve maliyet dikkat gerektiriyor
Tek seferlik yanıtlardan kalıcı ajanlara geçmek risk profilini de değiştiriyor.
Agents API, çalışmanın turlar arasında sürebilmesi için oturum durumunu saklıyor. Belgelerine göre hizmet şu anda veri yerleşimini yalnızca Amerika Birleşik Devletleri’nde destekliyor ve Zero Data Retention’ı desteklemiyor. Kendi barındırdığınız bir yürütme ortamını kullanmak da Agents API’yi Zero Data Retention için uygun hale getirmiyor.
Bu, özel belgeler, iş görüşmeleri ya da müşteri verileriyle çalışan Telegram botları için önemli. Geliştiriciler OpenAI’a neyin gönderildiğini, kendi uygulamalarının Telegram mesajlarını ne kadar süre sakladığını ve bir kullanıcının ajan oturumunu nasıl silebileceğini açıklamalı.
API kimlik bilgileri de ajanın sandbox’ının dışında kalmalı. OpenAI’ın hızlı başlangıç kılavuzu, uygulamanın API anahtarını ajanın çalıştığı ortama koymamayı açıkça öneriyor.
Maliyetler, tek yanıtlı bir sohbet botuna göre daha az öngörülebilir olabilir. OpenAI, model kullanımının seçilen modelin API fiyatlarıyla faturalandırıldığını, barındırılan araçların ve sandbox konteynerlerinin ise kendi ücretlerinin olduğunu belirtiyor. Alt ajanlar, web aramaları ve kod çalıştırma içeren çok adımlı bir görev basit bir sohbetten daha fazla kaynak tüketebilir.
Bot işletmecilerinin yalnızca mesaj kotalarına güvenmek yerine görev süresi, araç kullanımı ve paralel ajan sayısı için sınırlar koyması gerekecek.
Bunun Telegram yapay zeka araçları için anlamı
OpenAI’ın Agents API’si tek bir istekle bitmiş bir Telegram asistanı oluşturmuyor. Farklı bir sorunu çözüyor: daha uzun çalışabilen, araç kullanabilen ve durum tutabilen bir ajanın arkasındaki çalışma ortamını yönetmek.
Telegram geliştiricileri için bu, zor altyapının bir kısmını ortadan kaldırıyor ama ürün katmanına dokunmuyor. Kimlik doğrulama, sohbet tasarımı, izinler, bildirimler ve güvenli teslimatın hâlâ bunun etrafında kurulması gerekiyor.
Sonuç, bir modeli sohbet penceresinde sunmanın ötesine geçen yeni bir Telegram botu sınıfı olabilir. Bu botlar bir görevi kabul edebilir, araçlar ve dosyalarla çalışabilir, gerektiğinde bilgi isteyebilir ve tamamlanmış bir çıktıyla geri dönebilir.
Bu botların gerçekten işe yarayıp yaramayacağı, kaç ajan özelliğini tanıttıklarından çok bunları ne kadar net kontrol ettiklerine bağlı olacak.
Agents API mekanizmayı sağlıyor. Telegram arayüzü sağlıyor. Geliştiricilerin hâlâ bu ikisini kullanıcıların anlayabileceği ve güvenebileceği bir ürüne dönüştürmesi gerekiyor.
