Ajanların Veritabanını Sorgulasın,
Sen Aksini Söyleyene Kadar Salt Okunur
AgentsRoom, MySQL, PostgreSQL, SQL Server, MongoDB, SQLite ve Google BigQuery bağlantılarını yönetir ve yapay zeka kodlama ajanlarına onlara karşı sorgu çalıştırmanın bir yolunu verir. Varsayılan olarak salt okunur, aynı anda tek bir ifade ve parola erişimin dışında.
Gerçek satırları okuyabilen bir ajan verilerin hakkında tahmin yürütmeyi bırakır. Onlara yazamayan bir ajan ise satır satır denetlemen gereken bir risk olmaktan çıkar.
AgentsRoom'un özel bir alt ağdaki veritabanına nasıl ulaştığı ve bir yapay zeka ajanının salt okunur sorgusunu nasıl yanıtladığı.
Verilerini göremeyen bir yapay zeka kodlama ajanı, hayal ettiği şemaya göre kod yazar. Bir sütun uydurur, yedi değeri olan bir enum'un üç değeri olduğunu varsayar ve bir hatayı bir satırla değil bir teoriyle açıklar. Ona bir veritabanı bağlantısı vermek bunu düzeltir, aynı zamanda yardımcı bir ajanı bir olaya dönüştürmenin de en hızlı yoludur. AgentsRoom tam da bu gerilimin üzerine kuruludur.
Bağlantılarını uygulamaya, herhangi bir veritabanı istemcisinde yapacağın gibi kaydedersin: motor, host, port, kullanıcı, veritabanı ve sunucu bekliyorsa TLS. Veritabanına açık internetten ulaşılamıyorsa bağlantı, AgentsRoom'da zaten kaydettiğin SSH ve SSM bağlantıları kullanılarak bir SSH tüneli ya da bir AWS SSM port yönlendirme oturumu üzerinden yönlendirilir. Özel bir alt ağda duran bir veritabanı, böylece dünyaya açmadan sorgulayabileceğin bir şeye dönüşür.
Her bağlantı salt okunur başlar. Bir SELECT çalışır. Veriyi değiştirecek bir ifade ise, o belirli bağlantıyı yazılabilir yapıp işlemi onaylayana kadar çalışmaz. Çağrı başına yalnızca tek bir ifade kabul edilir, böylece bir noktalı virgülün arkasında fazladan hiçbir şey saklanamaz, sonuç kümeleri de sınırlandırılır, böylece geniş bir sorgu bir ajanı ya da bir pencereyi boğamaz. Bir bağlantı üretim olarak da işaretlenebilir, bu da onayı kazayla vermeyi zorlaştırır.
Okumak işin tamamı değil. Bir makinede kaydedilen bağlantı diğer makinelerinde de görünür, yani bir veritabanını her bilgisayarda bir kez değil, yalnızca bir kez kurarsın. Bir veritabanı da bir dosyaya aktarılabilir, bir dosyadan geri yüklenebilir ya da aynı tüneller üzerinden doğrudan başka bir sunucuya kopyalanabilir : eskiden bunlar için uygulamadan çıkman gerekiyordu.
Direksiyonda Bir Ajan Olduğunu Varsayan Bir Veritabanı İstemcisi
MySQL, PostgreSQL, SQL Server, MongoDB, SQLite ve Google BigQuery, sunucu motorları özel ağlarda erişilebilir, koruma önlemleri varsayılan olarak açık.
MySQL, PostgreSQL, SQL Server ve MongoDB Bağlantıları
Her veritabanı için bir bağlantı kaydet : host, port, kullanıcı, açılacak veritabanı ve sunucu istiyorsa TLS. Yerel veritabanın, test ortamındaki ve üretim replikası aynı listede yaşar, yeniden yazılmak yerine seçilmeye hazır.
Özel Bir Veritabanına Ulaş
Özel bir alt ağdaki veritabanı özel bir durum değildir. Bağlantıyı bir SSH tüneli ya da bir AWS SSM port yönlendirme oturumu üzerinden yönlendir, AgentsRoom da uygulamada zaten kaydettiğin SSH ve SSM bağlantılarını yeniden kullanarak onu senin için açsın. Bir Google Cloud SQL örneğine bağlantı adıyla, Cloud SQL Auth Proxy üzerinden, kendi gcloud oturumunla ve hiçbir şey saklanmadan ulaşılır.
Varsayılan Olarak Salt Okunur
Yeni bir bağlantı okuyabilir, başka bir şey yapamaz. Sorgular satır döndürür, veriyi değiştirecek ifadeler reddedilir. Güvenli modu açmayı kimsenin hatırlaması gerekmez, çünkü güvenli mod her bağlantının başladığı yerdir.
Bir Yazma İşleminden Önce İki Kilit
Yazmak bir değil, iki bilinçli eylem ister. Bağlantının yazılabilir yapılması ve işlemin kendisinin açıkça onaylanması gerekir. Dikkatsiz tek bir tık, WHERE koşulu olmayan bir UPDATE'e zincirlenemez.
Çağrı Başına Tek İfade
Her çağrı tam olarak bir ifade taşır. Noktalı virgülün arkasına dizilen her şey çalıştırılmak yerine reddedilir, böylece okuma gibi görünen bir okuma yanında ikinci bir ifadeyi kaçıramaz. Üstüne sonuç kümeleri de sınırlandırılır.
Üretim İşaretlenir
Bir bağlantıyı üretim olarak işaretle, onay da zorlaşsın. Önemli olan veritabanı, hem uzun bir günün sonunda sana hem de bir görev listesini ilerleten bir ajana, yerel kopyayla birebir aynı görünmeyi bırakır.
Bağlantıların, Her Makinede
Ofisteki makinede kaydedilen bir bağlantı dizüstünde de duruyor : ad, host, port, kullanıcı, varsayılan veritabanı ve üzerinden geçtiği tünel. Geride kalan tek şey parola, onu yazdığın makinede şifreli duruyor, böylece her makine parolayı bir kez soruyor.
Dışa Aktar, İçe Aktar, Kopyala
Bir veritabanını .sql dosyasına dök, böyle bir dosyayı bir veritabanına geri yükle ya da bir veritabanını doğrudan bir başkasının üzerine kopyala. Hedef, üzerine yazılmadan önce yedeklenir ve onu tümüyle değiştirmek ayrı ve ayrıca onaylanan bir karardır.
Ajanlar Veritabanını Sorgular, Parolayı Asla Ellerinde Tutmaz
Veritabanı kimlik bilgilerin AgentsRoom tarafından saklanır, dağıtılmaz. Bir ajan, adıyla bildiği bir bağlantıya karşı sorgu çalıştırmayı ister, uygulama bağlantıyı açar, ifadeyi çalıştırır ve satırları döndürür. Parola ne ajanın aldığı şeyin, ne yazdığı sorgunun, ne de tuttuğu konuşmanın parçasıdır.
Salt okunur kuralı bunun ikinci yarısıdır ve bir ajanın konuşarak sıyrılabileceği bir şey değildir. Bir ajanın sorgu çalıştırdığı araç, iki koşul birlikte sağlanmadıkça okuma dışında her şeyi reddeder: bağlantı yazılabilir olmalı ve o bağlantı için "Ajanların yazmasına izin ver" seçeneğini açmış olmalısın. Seçenek varsayılan olarak kapalıdır ve denetim ajanın sürecinde değil, masaüstü uygulamasında yapılır. Konsoldaki kendi yazma işlemlerin hâlâ açık bir onay ister ve bağlantı üretim olarak işaretlendiğinde bu onayı vermek bilinçli olarak zorlaşır. Bir bağlantı ajan yazmalarına açıldığında bu yazmalar o onay olmadan çalışır, bu yüzden seçeneği ajana emanet edebileceğin bir veritabanı için ayır. Diğer her yerde, kötü bir sorgunun en kötü sonucu kaybedilmiş bir tablo değil, yanlış bir cevap olarak kalır.
Tek ifade kuralı klasik açığı kapatır. Tek bir ifade taşıyan bir çağrı, bir noktalı virgül ve ikinci bir ifadeyle genişletilemez, böylece incelemede zararsız okunan bir sorgu çalışma anında başka bir şey yapamaz. SQL Server bu noktalı virgülü gerektirmez, bu yüzden orada bir okuma, içinde hiçbir yazma ya da işlem anahtar sözcüğü geçmeyen bir SELECT veya WITH ifadesidir ve her zaman geri alınan bir işlemin içinde çalışır. Sınırlandırılmış sonuç kümeleriyle birleşince bir hata, bir veri dışa aktarımına dönüşmek yerine hata olarak kalır.
Altı motor, ve eksik olanların adını da veriyoruz
MySQL ve MariaDB, PostgreSQL, SQL Server (Azure SQL ve Amazon RDS for SQL Server dahil), MongoDB, SQLite ve Google BigQuery. Her birinin bir çeviri katmanı yerine kendi sürücüsü var, çünkü gerçekten birbirlerinden farklılar: bir PostgreSQL veya SQL Server oturumu tek bir veritabanına bağlıdır, MongoDB SQL değil bir sorgu alır, T-SQL iki ifade arasında noktalı virgül gerektirmez, her dışa aktarma o motorla birlikte gelen araçları çalıştırır, SQLite ise yalnızca bilgisayarındaki bir dosyadır; ana bilgisayarı, kullanıcısı veya parolası yoktur; bir BigQuery bağlantısı da bir Google Cloud projesi ve varsayılan bir veri kümesinden oluşur, kendi Google oturumunla (gcloud auth application-default login) açılır ve hiçbir anahtar saklanmaz. Dört sunucu motoruna doğrudan ya da açık internete açık değillerse bir SSH tüneli veya bir AWS SSM port yönlendirme oturumu üzerinden ulaşılır.
Oracle, Redis ve diğerleri desteklenmiyor. SQL Server'a bir SQL oturum açma bilgisiyle bağlanırsın (Windows, Active Directory ve Entra ID kimlik doğrulaması sunulmuyor) ve dışa aktarma, içe aktarma ya da kopyalama yoktur. BigQuery'de Google her sorguyu okuduğu bayt miktarına göre faturalandırır, bu yüzden her bağlantının sorgu başına bir faturalama tavanı vardır (varsayılan 1 GiB, ayarlanabilir): bu tavanı aşan bir sorgu ücretlendirilmek yerine reddedilir. Bir tabloyu açmak ücretsizdir ve salt okunurdur, ajanların aynı db_list, db_schema ve db_query araçlarını aynı koruma önlemleriyle kullanır ve her sorgunun okuduğu bayt miktarını görür; orada da dışa aktarma, içe aktarma ya da kopyalama yoktur. Bunu indirmeden sonra değil, önce bilmeyi hak ediyorsun. Sıradaki motoru insanların ne istediği belirler, dolayısıyla sizinki eksikse hangisi olduğunu halka açık backlog'ta söyle, sayılsın.
Veritabanı motorunu talep etBir veritabanını yalnızca okuma, taşı
Bir veritabanını bir dosyaya aktar. Bir dosyayı bir veritabanına yükle. Ya da bir veritabanını doğrudan bir başkasının üzerine kopyala, zaten kaydettiğin SSH tüneli veya AWS SSM oturumu üzerinden de. Her motor kendi resmi araçlarını çalıştırır ve diske akış hâlinde yazar, böylece birkaç gigabaytlık bir veritabanı bir çökme değil, bir ilerleme çubuğu olur.
Bu araçlar AgentsRoom ile değil, veritabanının kendisiyle birlikte gelir: mysqldump ve mysql, pg_dump ve psql, mongodump ve mongorestore. SQL Server'da bütün bir veritabanını akış hâlinde aktaran bir eşdeğer yok, bu yüzden onun bağlantılarında dışa aktarma, içe aktarma ya da kopyalama yoktur. Araçlar eksik olduğunda uygulama tam olarak hangilerinin eksik olduğunu söyler ve onları içeren klasörü göstermene izin verir, bir veritabanı istemcisinin yapması gerektiği gibi: Dock'tan ya da Başlat menüsünden açılan bir uygulama yalnızca asgari bir PATH görür ve aksi hâlde, araçların kurulu olduğu bir makinede onları eksik sayardı.
Yanlış bir tıkın bir güne mal olduğu yer kopyalamadır, bu yüzden ideal senaryonun değil, tam da bunun etrafında kuruldu.
- Salt okunur bir bağlantı, hiçbir şey açılmadan, içe aktarmayı en baştan reddeder.
- Tek bir ifade bile uygulanmadan önce hedef, senin seçtiğin bir dosyaya yedeklenir.
- Onay, bağlantının ve veritabanının adını anar; bağlantı üretim olarak işaretliyse sesini yükseltir.
- Hedef veritabanını silip yeniden oluşturmak ayrı bir seçenektir ve üretim bağlantılarında veritabanının adını elle yazman gerekir.
Özel Bir Veritabanından Bir Cevaba
Bağlantıyı kaydet, yönlendir, sonra sen sorgula ya da bir ajan sorgulasın.
Bağlantıyı kaydet
Veritabanını ekle : host, port, kullanıcı, veritabanı adı ve sunucu bekliyorsa TLS. Sonradan tanıyacağın bir ad ver ve öyleyse üretim olarak işaretle.
Özelse yönlendir
Veritabanına doğrudan ulaşılamıyorsa bağlantıyı, AgentsRoom'da zaten kayıtlı bağlantılardan kurulan bir SSH tüneline ya da bir AWS SSM port yönlendirme oturumuna yönlendir. Özel bir alt ağdaki veritabanı, herkese açılmadan erişilebilir hale gelir. Google Cloud'da bunun yerine Cloud SQL örneğini seç: AgentsRoom, Cloud SQL Auth Proxy'yi senin için başlatır.
Sen sorgula ya da bir ajan sorgulasın
İfadeni uygulamadan çalıştır ya da bir ajan MCP üzerinden çalıştırsın. Sen değiştirene kadar salt okunur, çağrı başına tek ifade, sınırlandırılmış sonuç kümeleri ve her yazma işlemiyle verilerinin arasında duran açık bir onay.
Bir Ajanın Gerçek Satırlara İhtiyaç Duyduğu Anlar
Üretim verisini okumanın çözüme giden en kısa yol olduğu anlar.
Gerçek veriye karşı hata ayıklama
Hata yalnızca birkaç hesapta görünüyor. Ajanın o satırları okumasına izin ver, verinin neye benzeyebileceğine dair üç teori önermek yerine mantığı bozan değeri bulsun.
Herkese açık olmayan bir veritabanı
Veritabanı, herkese açık bir uç noktası olmayan özel bir alt ağda yaşıyor. Bağlantıyı, kayıtlı bağlantıların üzerine kurulan bir SSH tüneli ya da bir AWS SSM oturumu üzerinden yönlendir ve internete bir port açmadan sorgula.
Ajan tahmin etmesin, baksın
Bir ajan, bir migrasyon ya da bir sorgu yazmadan önce gerçekte neyin saklandığına bakabilir. Okur, raporlar ve o bağlantıyı ajan yazmalarına açmadıysan, bunu yaparken hiçbir şeyi değiştirmenin bir yolu yoktur.
Üretim, yazma riski olmadan
Üretimi okumak çoğu zaman gereklidir, bir görevin ortasında ona yazmak neredeyse hiç gerekmez. Bağlantıyı üretim olarak işaretle, salt okunur bırak, araştırmakla kırmak arasındaki fark da birinin dikkatli olmasına bağlı olmaktan çıksın.
Test ortamını gerçek verilerle tazele
Hata yalnızca gerçek satırlarda tekrarlanıyor. Veritabanını, zaten kaydettiğin tünel üzerinden test ortamı sunucuna kopyala; orada bulunanlar önce bir dosyaya yedeklenir.
Dizüstünü aç, her şey yerinde
Bağlantıların hesabını izler: aynı host'lar, aynı tüneller, aynı salt okunur ve üretim işaretleri. Senkronize parolalar açıkken parolalar da uçtan uca şifreli olarak seni izler, böylece hiçbir şey yeniden yazılmaz; kapalıyken her makine parolayı bir kez sorar.
Ajanlarım veritabanını nasıl sorguluyor?
AgentsRoom MCP üzerinden, dört araçla. db_list kayıtlı bağlantılarını ve üst verilerini döndürür, db_schema tek satır SQL olmadan şemaları, tabloları ve sütunları dolaşır, db_query tek bir ifade çalıştırıp satırları döndürür ve db_connection_new henüz kaydetmediğin bir veritabanını önerir. Bağlantıyı AgentsRoom açar, önünde varsa SSH tüneli ya da AWS SSM oturumu dahil. Ajana geri giden şey bir sonuç kümesidir, asla bir kimlik bilgisi değil.
Ajanlar yalnızca, aynı zamanda yazılabilir olan bir bağlantıda "Ajanların yazmasına izin ver" seçeneğini açtığında yazabilir. Bilinçli olarak açılması gereken bu seçenek varsayılan olarak kapalıdır ve hesabının tamamında bağlantıyla birlikte eşitlenir. Açıldıktan sonra yazma işlemleri hemen çalışır, bu yüzden onu yalnızca o veritabanı konusunda ajana güveniyorsan kullan. Masaüstü uygulaması bu izni kendi ana sürecinde denetler ve db_query hâlâ çağrı başına yalnızca tek bir ifade kabul eder.
Bir veritabanını kaydetmek de tamamen ajanın işi olabilir. db_connection_new gözden geçirilen yolu korur: veritabanına üzerinden ulaşılması gereken host, kullanıcı ve SSH ya da AWS SSM bağlantısıyla oluşturma formunu önceden doldurulmuş olarak açar; onu gözden geçiren, parolayı yazan ve kaydeden sensin ve sen kaydedene kadar hiçbir şey saklanmaz. Sen "Ajanlar bağlantıları yönetebilir" seçeneğini (Ayarlar, varsayılan olarak açık) kapatmadıkça db_connection_save bağlantıyı doğrudan yazar ve parola yine de hiçbir zaman konuşmadan geçmez: ajanın yalnızca adını söylediği bir kasa gizli bilgisinden kopyalanır. Ajan, verilerin üzerine akıl yürütmek için ihtiyacı olanı alır ve bu erişimin genelde bir olaya dönüşme yollarının hiçbiri ona açık değildir.
Bir ajanın çalıştırdığı her sorgu da görünür. db_query ve db_schema çağrıları, SQL'i ve dönen ilk satırlarla birlikte sağ paneldeki Etkinlik sekmesine düşer, her veritabanı için ayrı bir günlükte; ajanın avatarı Veritabanları düğmesinde ve "Ajan çalışıyor" rozetiyle Veritabanları listende görünür. Bunu telefonundan da, mobil uygulamadaki ajan kartında izleyebilirsin. Bu günlük yalnızca bilgisayarın ile telefonun arasında, uçtan uca şifrelenmiş ve gizli bilgiler maskelenmiş olarak taşınır: hiçbir sonuç kümesi bir sunucuda saklanmaz.
AgentsRoom MCP'yi keşfetdb_query ve db_schema çağrılarını listeleyen aynı Etkinlik sekmesi, burada kayıtlı bir SSH sunucusunda çekildi : bir ajan üç komut çalıştırıyor, her biri çıktısı, çıkış kodu ve süresiyle birlikte geliyor, ardından o bağlantının günlüğü tam olarak açılıyor. Bu günlük bilgisayarında kalıyor.
Sıkça Sorulan Sorular
Bize başka bir şey sorHangi veritabanları destekleniyor?
Bir yapay zeka ajanı veritabanıma yazabilir mi?
Özel bir alt ağdaki veritabanına nasıl ulaşırım?
Ajanlarım veritabanı parolasını görüyor mu?
Bir ajan aynı anda birkaç ifade çalıştırabilir mi?
Bir bağlantıyı üretim olarak işaretlemek neyi değiştirir?
Çok sayıda satır döndüren bir sorguda ne olur?
Bir ajan veritabanı bağlantısı ekleyebilir mi?
Bir ajan şemamı nasıl öğrenir?
Veritabanı bağlantılarım makinelerim arasında senkronize oluyor mu?
Bir veritabanını dışa aktarıp başka bir yere içe aktarabilir miyim?
Bağlantılarımı tutan hesap nasıl korunuyor?
Ekran görüntüleri
Uygulamanın gerçek ekran görüntüleri; bu özellik geliştikçe eklenir.
AgentsRoom, bir bağlantının bu bilgisayarda şifresiz olduğunu, nereden geldiğini tahmin etmeden size bildirir. 
Kendi Google girişinizle Google BigQuery'ye bağlanın 
Bir BigQuery sorgusunun bağlantı başına ne kadar fatura edebileceğini sınırlayın 
Doğrudan TLS bağlantıları sunucu sertifikasını doğrular, kendi imzalı sunucular için isteğe bağlı
Bunları da beğenebilirsin
AWS SSM üzerinden RDS
Herkese açık uç noktası olmayan bir Amazon RDS örneğine kendi makinenden, aws ssm start-session ve AWS-StartPortForwardingSessionToRemoteHost belgesi üzerinden ulaş. Bakımını üstleneceğin bir bastion yok, VPN yok, gelen SSH kuralı yok. AgentsRoom oturumu bir loopback portunda açar ve veritabanı istemcisini onun üzerinden bağlar. MySQL, PostgreSQL, SQL Server ve MongoDB, yani RDS MySQL, RDS PostgreSQL, RDS for SQL Server, Aurora ve DocumentDB.
Cloud SQL Auth Proxy
MySQL veya PostgreSQL için bir Cloud SQL örneğine kendi makinenden, özel IP dahil, bastion VM olmadan ulaş. AgentsRoom, Cloud SQL Auth Proxy'yi gcloud Application Default Credentials bilgilerinle bir loopback portunda başlatır, IAM veritabanı kimlik doğrulamasını destekler ve yapay zeka ajanlarının onu salt okunur sorgulamasına izin verir.
SSH Bağlantıları
SSH bağlantılarını kaydet, SSH üzerinden yerleşik bir terminal aç ve Claude Code, Codex veya Antigravity CLI'yi doğrudan uzak sunucunda ya da VPS'inde çalıştır. SSH anahtarı veya parola ile kimlik doğrulama, proje bazlı bağlantı profilleri, ayrı bir SSH istemcisine gerek yok.
Gizli Bilgi Yöneticisi
API anahtarlarını, token'larını ve parolalarını işletim sistemi anahtar zincirinde sakla, dev komutlarında ve ajan ortamlarında onlara {{secret:NAME}} ile referans ver, AgentsRoom da başlatma anında değeri çözümlesin. Ajanlar adları görür, değerleri asla, ve hiçbir şey bir sunucuya senkronize edilmez.
Dev Terminalleri
Proje bazlı terminal yöneticisi ve süreç başlatıcı. Backend, frontend ve worker'ları yerel olarak ya da uzak bir sunucuda tek tıkla başlat.
AgentsRoom MCP
Ajanlarının AgentsRoom'un kendisini yönlendirmesini sağlayan MCP sunucusu : projeler, terminaller, backlog ve bağlantılar, beraberinde gelen koruma önlemleriyle.
Ajanlarına Veriyi Ver, Anahtarları Değil
AgentsRoom'u indir, MySQL, PostgreSQL, SQL Server, MongoDB, SQLite ve Google BigQuery bağlantılarını kaydet, sunucu olanlara bir SSH tüneli ya da bir AWS SSM oturumu üzerinden ulaş ve ajanların onları sorgulasın, bir bağlantıyı onların yazmalarına açmadığın sürece salt okunur.
Yardımcı uygulama: hareket halindeyken ajanlarını izle
Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.
Hataları ve istekleri doğrudan genel backloguna gönder.
Bir sohbet gibi okuduğun ajanlar
Her ajanın bir rolü, bir yüzü ve mesajlaşma uygulaması gibi okuduğun bir konuşması var.
