1. Hizmet ayakta mı: Windows'ta Hizmetler ekranı ya da sc query NetsimSystemAgent; Linux'ta systemctl status ….
2. Günlük temiz mi: NetsimSystemAgent.log dosyasının sonunda “Uygulama Başlatıldı” bloğu ve komut satırı görünmeli; ardından şema doğrulama uyarısı, lisans hatası ya da bağlantı hatası olmamalı.
3. HTTP yanıt veriyor mu: tarayıcıdan http://<sunucu>:82/ — yönetim arayüzü açılmalı.
4. Yönetim REST'i: GET /AdminREST/STATUS (Basic auth ile, yönetici bir login; ilk kurulumda SYSDBA / masterkey).
5. Veritabanı: GET /AdminREST/MANAGEDDATABASES yönetilen veritabanlarını listeler.

2.6.1 Yardım ve belge havuzları

Ajan aynı yapıda iki havuz sunar:

• Yardım havuzu — NETSİM uygulama yardımı. Ajan paketindeki help.db'nin kendisidir (conf docs/help, öndeğer ajanın dizinindeki help.db); ajan onu salt okunur açar, içe almak gerekmez. Yeni paketle gelen dosya eskisinin yerine geçince yardım tazelenir. NetsimApp'in uygulama içi yardımı (/ClientREST/Help*) ve MCP'nin help_* araçları buradan okur; yetki denetimi yoktur.
• Belge havuzu — müşteri belgeleri, her müşteri veritabanı için ayrı. Havuz veritabanının kendi deposunda ya da ilişkili ayrı bir veritabanında durur; ilişki SQL ile kurulur (aşağıda). NetsimApp'in belge uçları (/ClientREST/Doc*) oturumun veritabanının havuzunu, MCP'nin doc_* araçları database argümanındaki (yoksa -DATABASE) veritabanının havuzunu okur; NetsimApp'te sonuçlar oturumu açan kullanıcının yetkilerine göre süzülür. Havuz SQLite, PostgreSQL ya da Firebird depolu bir veritabanında olabilir; PostgreSQL'de tablolar katalog dışındaki ivd$docs şemasına, Firebird'de doc$ adlı tablolar olarak veritabanına yazılır. Firebird sunucusuna eklenti kurulmaz: tam metin dizinini ajan, ilk aramada havuzun metninden belleğinde kurar (birkaç saniye) ve içe alma değişince yeniler.

SET CATALOG musteri_1;
ALTER DATABASE musteri_1 SET DOCUMENTS INTERNAL;                    -- kendi deposunda
COMMIT;

SET CATALOG musteri_2;
ALTER DATABASE musteri_2 SET DOCUMENTS DATABASE musteri_2_belge;    -- ilişkili kayıtlı veritabanında
COMMIT;

Belge havuzuna bir koleksiyon, ajan çalışırken yönetici bir login ile içe alınır:

curl -u SYSDBA:<parola> -X POST http://<sunucu>:82/AdminREST/EXECCOMMAND \
  -H "Content-Type: application/json" \
  -d '{"command":"IMPORTDOC","params":{"database":"musteri_1","collection":"<koleksiyon>","path":"<kaynak havuz dosyası>"}}'

Yanıt {"result": true, "collection": …, "topics": …, "chunks": …} olur; yalnız bu koleksiyonun satırları yenilenir. Windows'ta da yolu / ile yazın (C:/Netsim/Belgeler/belgeler.db) ya da ters bölüleri JSON'da ikiler; tek ters bölü geçersiz JSON'dur ve istek 400 alır. Kısıtlı bir koleksiyonun konuları, kaynak havuzdaki izin satırlarında adı geçen kullanıcıya ya da role açılır.

Anlamca arama (vector ve hybrid kipleri) gömme modelini ister. Model ajan paketinde değildir, iki platformda ortak ve sürümsüz ayrı bir pakettir: NetsimSystemAgentModel-e5-int8.zip. Onu ajanın dizinine açın; içindeki models/e5-int8/ klasörü help.db'nin yanına gelir. ONNX Runtime kitaplığı (onnxruntime.dll, Linux'ta libonnxruntime.so) ajan paketindedir. Model yoksa MCP'de bu iki kip açık bir hata iletisi döner, NetsimApp'in uçları ise tam metinle arar; tam metin araması (fts) her durumda çalışır. Model yeni ajan sürümlerinde değişmediği için bir kez açmak yeterlidir.