Gateway
Gateway Nedir?
Gateway, Neotask'ın kalbidir, tüm ajan oturumlarını, mesajlaşma kanallarını, araç yürütmesini ve cihaz bağlantılarını yöneten tek, uzun süreli çalışan bir hizmettir. Her şey Gateway üzerinden akar.
İstemcilerden (masaüstü uygulama, mobil uygulamalar, web gösterge paneli) bağlantıları kabul eden ve tüm yapay zeka asistanı yaşam döngüsünü yöneten bir WebSocket sunucusudur.
Mimari
Bileşenler
- WebSocket Sunucusu, İstemci bağlantılarını kabul eder (varsayılan port 18789)
- HTTP Sunucusu, Kontrol Arayüzüne, tuval ana bilgisayarına ve sağlık uç noktalarına hizmet eder
- Kanal Adaptörleri, Mesajlaşma platformlarına bağlantıları korur (WhatsApp, Telegram, Discord vb.)
- Oturum Yöneticisi, Ajan konuşma durumunu kalıcı kılar ve yönetir
- Cron Zamanlayıcısı, Zamanlanmış işleri ve kalp atışı uyanmalarını çalıştırır
- Eklenti Çalışma Zamanı, Eklenti yaşam döngüsünü yükler ve yönetir
- Tarayıcı Hizmeti, Web otomasyonu için Chromium örneklerini kontrol eder
Bağlama Modları
| Mod | Açıklama |
|---|---|
| Geri Döngü | Varsayılan. Yalnızca localhost'tan erişilebilir (127.0.0.1) |
| LAN | Yerel ağınızda erişilebilir. Bonjour/mDNS aracılığıyla otomatik keşfedilebilir |
| Tailnet | MagicDNS ile Tailscale VPN üzerinden erişilebilir |
| Özel | Belirli bir adrese bağlanın |
Kimlik Doğrulama
| Yöntem | Açıklama |
|---|---|
| Token | WebSocket taşıyıcı token'ı (UUID veya özel dize) |
| Şifre | Şifre tabanlı kimlik doğrulama (bcrypt karma) |
| Güvenilir Proxy | Ön kimlik doğrulama başlıklı ters proxy'ler için |
| Yerel Güven | Geri döngü bağlantıları otomatik olarak onaylanır |
Yapılandırma
Gateway, neotask.json (JSON5 formatı) aracılığıyla yapılandırılır. Temel bölümler:
| Bölüm | Kontroller |
|---|---|
agents |
Ajan listesi, varsayılanlar, çalışma alanları |
gateway |
Port, bağlama modu, kimlik doğrulama, yeniden yükleme davranışı |
channels |
Kanal başına yapılandırma ve kimlik bilgileri |
tools |
Araç izinleri, profiller, güvenlik |
plugins |
Eklenti yükleme, etkinleştirme, eklenti başına yapılandırma |
models |
Sağlayıcı kimlik doğrulama, yedekler, sağlayıcı ayarları |
skills |
Beceri dizinleri, beceri başına yapılandırma |
browser |
Tarayıcı profilleri, portlar, başsız mod |
cron |
Zamanlayıcı yapılandırması |
session |
Sıfırlama kuralları, sıkıştırma eşikleri |
messages |
TTS ayarları, medya politikaları |
memory |
Bellek dizinleme yapılandırması |
security |
Sanal alan, yükseltilmiş mod, onaylar |
Sıcak Yeniden Yükleme
Yapılandırma değişiklikleri yeniden başlatma olmadan uygulanabilir:
| Mod | Davranış |
|---|---|
| Karma (varsayılan) | Güvenli değişiklikleri sıcak uygula, diğerleri için yeniden başlat |
| Sıcak | Yalnızca sıcak güvenli değişiklikleri uygula, diğerlerini yoksay |
| Yeniden Başlat | Herhangi bir yeniden yükleme gerektiren değişiklikte yeniden başlat |
| Kapalı | Otomatik yeniden yükleme yok |
Uzaktan Erişim
Tailscale (Önerilen)
Tailscale güvenli, sıfır yapılandırmalı uzaktan erişim sağlar:
- Gateway'i Tailnet'inize bağlayın
- Aynı Tailscale ağındaki herhangi bir cihazdan erişin
- MagicDNS üzerinden otomatik DNS
- Tailscale Serve, gösterge panelini HTTPS ile açığa çıkarabilir
SSH Tüneli
Gateway portunu SSH üzerinden iletin:
- Basit, güvenli, yapılandırma değişikliği gerekmez
- Herhangi bir SSH özellikli makineyle çalışır
- Tam WebSocket protokolünü ve Kontrol Arayüzünü destekler
Güvenlik Kuralları
- Geri döngü + SSH/Tailscale en güvenli kombinasyondur
- Geri döngü dışı bağlama, kimlik doğrulama token yapılandırması gerektirir
- Ekstra güvenlik için TLS parmak izi sabitleme mevcuttur
- Tarayıcı kontrolü varsayılan olarak uzak bağlantılar için devre dışıdır
Sağlık İzleme
Sağlık Uç Noktası
/health HTTP uç noktası şunları döndürür:
- Gateway durumu
- RPC canlılığı
- Kanal başına sağlık (bağlı, kimlik doğrulama durumu, hesap sayısı)
- Tarayıcı hazırlığı
- Etkin ajanlar ve bağlı düğümler
- Çalışma süresi
Yoklamalar
- RPC canlılığı, WebSocket bağlantısı + yankı testi
- Kanal sağlığı, Kanal başına kimlik doğrulama kontrolü + API ping'i
- Tarayıcı hazırlığı, Port kontrolü, süreç kontrolü
- Düğüm bağlantısı, Son kalp atışı zaman damgası
Keşif
Bonjour/mDNS
LAN'a bağlandığında Gateway, kendisini çok noktaya yayın DNS aracılığıyla reklamlar:
- Hizmet türü:
_neotask-gw._tcp - Port, taşıma, TLS durumu ve Tailscale DNS bilgisini içerir
- Eşlik eden uygulamalar Gateway'i otomatik olarak keşfeder
Geniş Alan Keşfi
Yapılandırılabilir zaman aşımlarıyla ağınız genelinde gateway'leri keşfedin. Hem yerel Bonjour hem de Tailscale DNS keşfini destekler.
Çoklu Gateway'ler
Profiller kullanarak aynı makinede birden fazla Gateway örneği çalıştırabilirsiniz:
- Her profilin ayrı yapılandırması, çalışma alanı, oturumları ve durumu vardır
- Her Gateway için farklı portlar
- Yalıtım (kişisel ve iş) veya test için kullanışlıdır
Tanılama
Doktor
Yerleşik tanılama aracı şunları kontrol eder:
- Yapılandırma geçerliliği
- Dosya izinleri
- Kanal bağlantısı
- Model kimlik doğrulama durumu
- Node.js sürüm uyumluluğu
- Yaygın yanlış yapılandırmalar
İzin verildiğinde birçok sorunu otomatik olarak düzeltebilir.
Günlük Kaydı
Gateway günlükleri günlük JSONL dosyalarına yazılır:
- Tamamlama başına token kullanımı takibi
- Kanal olay günlükleri
- Yapılandırılmış bağlamla hata günlüğü
- Yapılandırılabilir günlük seviyeleri