AI-asistan

AI-asistan, yönetim panelinin sağ alt köşesinde bulunan bir widget'tır. Kapatıldığında yuvarlak bir buton-sferadır; üzerine tıkladığınızda asistan paneli açılır. Asistan çalışırken, sfera pulsatör gibi yanıp söner — bu, panel kapalı olsa bile, ajanın hala bir görevi yerine getirdiğini gösterir.

Panelde iki sekme bulunmaktadır (Türkçe arayüzde — "Dokümantasyon" ve "MCP ajanı"):

Sekme	Ne yapar
dokümantasyon	OneEntry dokümantasyonu ile ilgili soruları yanıtlar — projede hiçbir şeyi değiştirmez
MCP ajanı	sıradan kelimelerle tanımlanan görevi yerine getirir: gerekli Admin API işlemini bulur, proje verilerini oluşturur ve değiştirir

Sekmelerin ayrı geçmişleri vardır: dokümantasyonla ilgili sorular ajanın konuşmasına dahil edilmez ve tam tersi.

Ajanın başlatılması maliyetlidir

Her ajanın başlatılması, panelde seçilen AI hesabının kaynaklarını tüketir: ajan, bir görev için birden fazla kez modele başvurur — işlemi arar, parametrelerini çözümler, çağırır, sonucu kontrol eder. Her başlatma için harcama, yanıtın altında gösterilir, toplam bakiye ise Ayarlar → AI Ajanları sekmesindedir.

Asistan Paneli

Panelin başlığında, sekmelerin sağında üç buton bulunmaktadır:

• genişlet / daralt — paneli daha geniş yapar veya normal boyutuna döner;
• geçmişi temizle — açık sekmedeki konuşmayı temizler. Buton, konuşmada hiçbir şey yoksa veya asistan hala yanıt veriyorsa pasif durumdadır;
• kapat — paneli tekrar sferaya daraltır. Panel, dışında herhangi bir yere tıklanarak da kapanır.

MCP Ajanı Sekmesi

Ajan, kendi kelimeleriyle tanımlanan görevi yerine getirir — örneğin "teslimat sayfası oluştur" veya "bu tablodan ürünler yarat". Admin API ile bir dizi araç aracılığıyla çalışır: gerekli işlemi arar, parametrelerini çözümler, çağırır, dosyaları yükler. Araçlar arasında OneEntry dokümantasyonu üzerinde arama da vardır — ajan, modülün nasıl çalıştığını anlaması gerektiğinde dokümantasyonu kendisi okur.

Ajanın yetkileri, sizin yetkilerinizdir

Ajan, mevcut yöneticinin adına ve yetkileriyle hareket eder: sizin erişiminiz olmayan şeyler, ajana da erişilemez. Ajanın veri silmesi yasaktır ve korunan işlemleri yalnızca sizin onayınızdan sonra gerçekleştirir (aşağıya bakın).

Ajan ve Model Seçimi

Sekmenin üst kısmında Ajan ve Model alanlarında, görevi yerine getirecek AI hesabı ve model seçilir. Hesaplar Ayarlar → AI Ajanları kısmından alınır. Listede yalnızca araçları çağırabilen modeller bulunmaktadır: bunun olmaması durumunda ajan API ile çalışamaz.

Eğer projede hiç AI hesabı yoksa, seçim yerine panel, AI ajanın ayarlanmadığı ve ayarlarda oluşturulması gerektiği konusunda bir uyarı gösterir. Ayarlar → AI Ajanları sekmesinde bir hesap oluşturun.

Görevi Başlatma

1. Görevi talep alanında tanımlayın.
2. Gerekirse, dosyayı ataç butonuyla ekleyin — örneğin, ürünlerin bulunduğu bir tablo. Talebe bir dosya eklenir. Sunucu, kabul edilen dosya türlerini ve maksimum boyutu belirler; çok büyük bir dosya panel tarafından kabul edilmez ve parçalar halinde bölünmesi önerilir. Resim eklenebilir, ancak seçilen modelin görüntüleri okuyabilmesi gerekir — aksi takdirde başka bir model seçin veya belge ekleyin.
3. Başlatma butonuna tıklayın (Türkçe arayüzde — "Başlat"). Ajan çalışırken, butonun yerinde iptal butonu ("İptal") görünür — bu, işlemi durdurur.

Görev devam ederken, ajanın hangi işlemi aradığı, hangisini çağırdığı, hangi dosyayı yüklediği gibi adımlar akışta görünür. Detaylı adım, tıklanarak açılabilir. Ajan tamamladığında, adımların altında yanıtı görünür ve yanıtın altında başlatma maliyeti: token sayısı ve dolar cinsinden maliyet görünür.

Ajan, konuşmadaki birkaç son tamamlanmış değişimi dikkate alır, bu nedenle bir sonraki görev, önceki görevin devamı olarak formüle edilebilir.

Korunan İşlemlerin Onaylanması

Korunan bir işlemden önce, ajan durur ve onay talebi ile bir kart gösterir. Kartta — yöntem ve talep adresi, gönderilecek veriler ve şu anda bu adreste bulunan bilgiler yer alır. Karar, talebe göre alınır, modelin özetine göre değil:

• onay butonu (Türkçe arayüzde — "Onayla") — ajan işlemi gerçekleştirir;
• reddetme butonu ("Reddet") — işlem gerçekleştirilmez.

Eğer yanıt sunucuya ulaşmazsa, kart bunu bildirir ve butonlar tekrar erişilebilir hale gelir.

Bilinmesi Gerekenler

• Panelin kapatılması görevi iptal etmez. Ajan çalışmaya devam eder, adımlar ve yanıt, panel tekrar açıldığında görünecektir. Ancak panel kapatıldıktan veya sekme değiştirildikten sonra, başlatılmış bir görevi panelden durdurmak mümkün değildir ve gönderilmemiş talep metni ile ekli dosya kaybolur.
• Geçmiş yalnızca sayfanın belleğinde saklanır. Sayfa yeniden yüklendiğinde, ajanın konuşması kaybolur. Tarayıcı sekmesi kapatıldığında veya ajan çalışırken yeniden yüklendiğinde görev kesilir.
• Eğer AI hesabının limiti dolmuşsa veya seçilen model uygun değilse, görev başlatılamaz — panel nedeni gösterir.