Contextator
ENTR

Başlangıç

Pano Turu

Contextator panosunda rehberli bir tur — oturum açmak, hesap menüsü, üst çubuk, proje listesi ve ayrıntısı, klavye kısayolları, footer ve Users sayfası.

Güncelleme:

http://localhost:3444/ adresindeki pano, her şeyin yönetildiği yerdir. Düz bir web sayfasıdır — hiç build adımı yoktur, ve indekslemenin olurken izleyebilmeniz için yoklama yapar. Önce oturum açmanızı ister, ve sonrasında ne gördüğünüz hesabınıza bağlıdır.


Oturum açmak

/’i açmak, o tarayıcıda zaten bir oturumunuz olmadıkça sizi /login’e gönderir. Operatörün size verdiği hesapla oturum açın; yepyeni bir örnekte henüz bir hesap yoktur ve bunun yerine, sunucu logundaki kodla ilkini oluşturmak için /setup’a gönderilirsiniz. İkisi de Hesaplar ve İzinler’de anlatılır.

Parolanız geçiciyse, pano sizi /change-password’e gönderir ve onu değiştirene kadar başka hiçbir şey çalışmaz.

İçeri girdiğinizde ne gördüğünüz rolünüzü izler: bir root ya da admin hesabı her projeyi ve Users sayfasını görür, bir member hesabı yalnızca eklendiği projeleri görür, ve basamayacağı düğmeler devre dışı gösterilir (örneğin Re-index ve Force re-index), gizlenmez.

Hesap menüsü

Sağ üstte, adınızı ve rolünüzle bir hap göstererek:

Öğe Ne yapar
Change password Mevcut parolanızı, sonra yeniyi iki kez ister. Kaydetmek diğer oturumlarınızı çıkarır
API tokens Admin API için kendi token’larınız (#/~tokens)
Users Hesap listesi — yalnızca root ve admin. Bkz. Users sayfası
Audit log Kimin ne yaptığının örnek geneli kaydı (#/~audit) — yalnızca root ve admin. Bkz. Admin API
Sign out Bu oturumu yalnızca bu tarayıcıda değil, sunucuda sonlandırır

Üst çubuk

Durum hapları, başka bir şeye bakmadan önce sunucunun sağlıklı olup olmadığını söyler:

Hap Anlamı
Database up / down Veritabanına ulaşılabiliyor — gömülü PostgreSQL ya da DATABASE_URL’in adlandırdığı harici olan
Model ready / loading Gömme modeli yüklendi. İlk başlatmada, model indirilirken loading der — hazır olana kadar indeksleme ve arama çalışmaz
local · Xenova/multilingual-e5-small · 384d Şu anda kullanılan gömme sağlayıcısı, modeli ve vektör boyutları
n open sessions Şu anda bağlı MCP istemcileri
v1.0.0 Çalışan sürüm

Proje listesi (sol)

Canlı durumuyla birlikte her proje: idle, indexing, queued ya da error. Her satır, kaynak sayısını, doküman ve parça sayılarını ve en son ne zaman indekslendiğini gösterir. Bir proje indekslenirken, satır geçerli aşamayla, biten dosyalarla ve gömülen parçalarla bir ilerleme çubuğu büyütür. Kuyrukta bekleyen bir proje, hangi projeyi beklediğini söyler.

  • Filter projects — listeyi daraltmak için yazın.
  • New project (ya da n’ye basın) — oluşturma diyaloğunu açar.

Proje ayrıntısı (sağ)

Proje adı, durumu, ve kopyalama düğmeli MCP URL — bu, agent’ınızın yapılandırmasına yapıştırdığınız dizedir. Yanında, projenin kaynaklarının adları.

Üç eylem:

Düğme Ne yapar
Re-index Artımlı bir çalışmayı kuyruğa alır: her kaynağı senkronize et, yalnızca değişeni yeniden göm
Force re-index Projenin her parçasını düşürür ve sıfırdan yeniden kurar
Delete Projeyi, dokümanlarını, parçalarını ve dosyalarını kaldırır. Onaylamak için iki kez tıklayın (ikinci tık Confirm delete yazar). Yalnızca root ve admin hesapları için çizilir, ve proje indekslenirken reddedilir

Bir çalışma sürerken, bir bilgi kutusu aşamayı, ilerleme çubuğunu, kaç dosyanın değişmediğini ve kaç parçanın gömüldüğünü gösterir. Son çalışma başarısız olduysa, kırmızı bir bilgi kutusu hatayı olduğu gibi gösterir.

İstatistikler

Dokümanlar (ve kaç kaynak boyunca), parçalar, en son ne zaman indekslendiği (o çalışmanın neyi değiştirdiğiyle birlikte), ve gömme modeli. Proje, sunucunun şu anda çalıştırdığından farklı bir modelle indekslendiyse, burada bir uyarı görünür ve siz yeniden indeksleyene kadar arama reddedilir. Uyarı, içinde bir Re-index now düğmesi olan ve başlığı Indexed with a different embedding model olan bir bilgi kutusudur, çünkü hiçbir şey projeyi kendiliğinden yeniden indekslemez. İkinci bir bilgi kutusu, Chunks are larger than the model reads, CHUNK_MAX_TOKENS modelin temsil ettiğinin üzerindeyse görünür ve yeniden indekslemeden önce ayarlanacak değeri adlandırır. Parçalar kutucuğu embedded, HNSW cosine index yazar.

Arama

İstatistiklerin altında, projeye bir agent’ın soracağı şekilde soran bir arama kutusu. İsteğe bağlı source, path prefix ve version filtreleri search_docs argümanlarını yansıtır, ve sınır 5, 10 ya da 20 isabettir. Her isabet dosyasını, başlığını, soluk renkli komşu metniyle alıntıyı, cosine skorunu ve D ile L sıralarını gösterir — vektör yarısının (D) ve anahtar sözcük yarısının (L) ona verdiği konum. En iyi skor relevance floor’un altındaysa, Below the relevance floor başlıklı bir bilgi kutusu search_docs’un “no good match” yanıtlayacağını söyler, ve floor’un doğru olup olmadığına siz karar verebilesiniz diye alıntılar yine de gösterilir.

Agent’ların ne sorduğu

Sorgular paneli agent’ların neyi aradığını geri okur, böylece dokümantasyonun neyi yanıtsız bıraktığını görebilirsiniz. Pencereyi (24 saatten 90 güne) ve kimin aramalarının sayılacağını seçin — agent’lar (MCP), bu pano, ya da ikisi. Dört sekme: Questions (bir sorunun ne sıklıkla sorulduğuna ve en iyi skorunun ne kadar düşük kaldığına göre sıralı, sormanın kaç token ve güne yayıldığıyla birlikte), Never returned (hiçbir aramanın döndürmediği dokümanlar, indeksliyken kaç arama çalıştığıyla birlikte), Most returned ve Volume (UTC günü başına aramalar). Hiçbir şey “yanıtsız” diye etiketlenmez: dokümante etmediğiniz bir şey hakkındaki bir soru, dokümante ettiğiniz bir soru kadar iyi skor alabilir, bu yüzden sayı ve skor gösterilir ve yargı sizindir. Export questions onları değerlendirme harness’inin biçiminde JSONL olarak indirir.

Questions tablosunun altında Reported by agents, agent’ların report_gap ile gönderdiklerini listeler: bir agent’ın aradığı, bulduklarını okuduğu ve dokümantasyonun cevaplamadığını söylediği sorular; soruya göre gruplanır ve agent’ların kendi sözleriyle, düz metin olarak gösterilir. Üstlerindeki sorularla birlikte sıralanmazlar. Bkz. MCP Araçları.

Her rakam bir gömme modelini, bir indeks neslini ve bir relevance floor’u tanımlar; bunlar tablonun üstündeki seçicide adlandırılır. Floor, o aramalar karara bağlandıktan sonra değiştirildiyse panel bunu işaretler: rakamlar eski floor’a göre karara bağlanmıştı, bu yüzden projenin bundan sonra reddettiği şey onların gösterdiği şey değildir, ve mevcut floor altında karara bağlanan aramalar sizin seçmeniz için ayrı tutulur. Panelin altı mevcut relevance floor’u ve nereden geldiğini gösterir — sunucunun SEARCH_SCORE_FLOOR’u ya da bu projenin kendi değeri. Bir manager, 0,01’lik adımlarla on değerlik bir listeden başka bir değer seçebilir (en düşüğü 0,75, en yükseği 0,84), Off (0), ya da bu projenin kendi değerini bırakmak için Server default; birini seçmek onu uygulamaz, önce fiyatlandırır — penceredeki reddedilen aramalardan kaçını yanıtlayacaktı ve yanıtlanan aramalardan kaçını reddedecekti, üst sınırlar olarak — ve yalnızca Set the floor to… onu kaydeder. Manager’lar ayrıca Stop recording ya da Clear the log yapabilir; saklama süresinden eski satırlar otomatik olarak silinir.

Eval runs

Projenin golden question’larının (her biri bir soru ve ona cevap vermesi beklenen dosya) altında, Eval runs paneli sunucunun bunlara verdiği kendi cevapları tutar. İndeks değiştikten sonra — bir yeniden kurma, chunk yazan, dosya kaldıran ya da doküman değişikliği kaydeden artımlı bir çalışma — ya da küme düzenlendikten sonra sunucu her golden question’ı canlı indekse sorar ve çalışmayı kaydeder. Panel, recall@5 ve MRR geçmişini bir grafik olarak çizer, çalışmaları her birinin neyi kaybettiği ya da atladığıyla listeler ve en yeni iyi çalışma, daha önce ilk beşte olan bir soruyu kaybettiğinde bunu sorulara adını vererek uyarır (ayrıca bir soru, beklediği dosya artık indekste olmadığı için ilk kez atlandığında). Sunucunun kendi başlattığı bir çalışma, açık bir sayfada yenileme gerekmeden saniyeler içinde görünür. Bir manager Run now’a basabilir. Panel sunucunun kaydettiği rakamları çizer ve kendisi hiçbir şeyi puanlamaz. Aynı çalışmalar API üzerinden okunur: bkz. Admin API.

Belge kaynakları

Kaynak başına bir satır: bağlama adı, nereden geldiği, içerik türü, doküman sayısı, en son ne zaman senkronize olduğu, ve kendi durumu. Her satır şunu taşır:

Eylem Kimin için var Ne yapar
Test git, Notion, Confluence, Documentation site, S3 bucket, Google Drive, GitHub issues Hiçbir şeyi indekslemeden bağlantıyı denetler
Sync tümü Bir indeksleme çalışmasını kuyruğa alır (her kaynak bir çalışmanın başında senkronize olur)
Edit / Files tümü Kaynak diyaloğunu açar; yüklemeler için saklanan dosyaları listeler ve yönetir
Delete tümü Kaynağı, dokümanlarını ve dosyalarını kaldırır. Onaylamak için iki kez tıklayın

Bir viewer, eylem düğmelerinin yerine View görür.

Add source, tür başına bir sekmeyle bir diyalog açar — Local directory, Git repository, Upload files, Obsidian vault, Notion, Confluence, Documentation site, S3 bucket, Google Drive, GitHub issues. Bkz. Belge Kaynakları.

Secret’lar ve kişisel veriler

Bir editor ve üstü için proje sayfasındaki bir bölüm, PII taramasının bulduklarını belge yoluna göre listeler: kural, konum ve maskelenmiş bir önizleme, kurala göre daraltılabilir. Hiçbir zaman bir değer göstermez ve taramanın kapalı olduğunu (PII_SCAN=0), bulguların gruplanmadığını (SECRET_KEY yok), belgelerin belge başına tavana ulaştığını ve belgelerin indekslenirken kesildiğini ayrı ayrı söyler. Tarama yalnızca raporlar; hiçbir şey maskelenmez ya da atlanmaz. Bir viewer bölümü görmez. Bkz. Yapılandırma.

Üyeler

Her projeye ulaşan ve bu yüzden listelenmeyen root ve admin hesaplarının ötesinde, bu projeye kim ulaşır. Her satır, proje rolünü tutan bir açılır menüyle birlikte bir member hesabıdır — viewer okur, editor kaynakları değiştirir, dosya yükler ve yeniden indeksler — ve bir Remove düğmesi. Add member, henüz projede olmayan aktif member hesaplarını sunar; hiç yoksa sizi Users sayfasına yönlendirir. Yalnızca root ve admin bunun herhangi bir şeyini değiştirebilir; başka herkes listeyi salt okunur görür. Panelin altındaki not projenin MCP moduna göre değişir: endpoint herkese açıkken üyeliğin panoyu yönettiğini, MCP endpoint’ini değil, söyler; bir token zorunlu olduğunda endpoint’in yalnızca projenin token’larından birini tutan bir istemciye yanıt verdiğini söyler; hesap zorunlu modunda ise yalnızca burada listelenen hesapların ve yöneticilerin MCP endpoint’ine ulaşabildiğini söyler. Bkz. Hesaplar ve İzinler.

MCP erişimi

Bir hap, bu projenin endpoint’inin üç moddan hangisinde olduğunu söyler — open, URL’ye ulaşabilen herkes tarafından okunabilir; token required, yeni oluşturulan bir proje için varsayılan; ya da account required, yalnızca projenin bir üyesi olan bir hesabın, OAuth 2.1 üzerinden ve her istekte yeniden denetlenerek yanıtlandığı mod. Panel aralarında geçiş yapar; New token bir tane üretir ve secret’ını bir kez gösterir, ve Revoke istemcisini oturum ortasında keser. Üretirken token’ı bağlayacağınız kaynakları seçebilirsiniz; kapsamı olan bir token bir rozet gösterir — kaynaklarının hiçbiri kalmadıysa kırmızı — ve open projelerde, kapsamın bir sınır olmadığını söyleyen bir not görünür. Her satır bir token’ın adını, önde gelen karakterlerini, ve en son ne zaman kullanıldığını gösterir. Basmanıza izin verilmeyen düğmeler çizilmez: modu çevirmek proje üzerinde manager haklarını gerektirir, üretmek ve iptal etmek bir editor’ünkini. Bkz. Projeler.

Bir agent bağlamak

Bu projenin gerçek URL’siyle doldurulmuş, Claude Code, Cursor, Claude Desktop ve eski SSE istemcileri için kopyala-yapıştır parçacıkları — ve proje bir token gerektirdiğinde Authorization başlığı zaten yerinde. Bkz. Yapay Zekâ İstemcilerini Bağlamak.

Agent’a açılan araçlar

Her projenin yayımladığı beş aracın bir hatırlatıcısı: search_docs, list_topics, read_document, whats_new ve report_gap; sonuncusu projenin sorgu logu açıkken bulunur. Bkz. MCP Araçları.

İndeksleme çalışmaları

En yeniden en eskiye son çalışma geçmişi: ne zaman, artımlı mı zorlanmış mı, ne değişti (12 unchanged · 3 updated · 1 removed), ve ne kadar sürdü. Başarısız çalışmalar hatalarını gösterir. Bu, canlı ilerleme görünümünün aksine, yeniden başlatmaları atlatır.


Klavye ve küçük kolaylıklar

  • n, New project’i açar (hiçbir diyalog açık değilken).
  • Esc bir diyaloğu kapatır.
  • Seçili proje URL hash’indedir (#/my-project), bu yüzden ona bir yer imi koyabilir ya da bir bağlantı paylaşabilirsiniz.
  • Yıkıcı düğmeler ikinci bir tıklama gerektirir, ve onayın süresi birkaç saniye sonra dolar.
  • Kopyalama düğmeleri, tarayıcı düz-HTTP bir LAN adresinde panoyu engelliyorsa manuel bir seçime düşer.

Panonun her sayfası aynı iki parçalı footer ile biter. Solda, çalışan sürümle birlikte telif hakkı satırı: Copyright © 2026 Contextator v1.0.0 is a Tunedness production. Sağda, sıradan URL’ler olarak açılan ve hesap gerektirmeyen beş sayfa:

Sayfa Ne olduğu
/about Contextator’ın ne olduğu, nasıl çalıştığı, ve kimin yaptığı
/privacy Kurulumunuzun ne sakladığı, ve yazılımın yapabileceği giden çağrılar
/cookies Var olan tek çerez — sizi oturumda tutan oturum — ve ne olmadığı
/terms Garanti reddi ve bir örnek çalıştırmanın sizi nelerden sorumlu tuttuğu
/license Kısaca AGPL, /license.txt’teki tam metin, ve üçüncü taraf bileşenler

Bilerek herkese açıktırlar: yalnızca operatörün okuyabildiği bir yasal bildirim, bir bildirim değildir. Hiçbir proje verisi açığa çıkarmazlar ve ne veritabanına ne de API’ye ulaşırlar.

Users sayfası

Hesap menüsü → Users (#/~users), yalnızca root ve admin hesapları için. Hesap başına bir satır: kullanıcı adı ve görünen adı, rolü, active, disabled olup olmadığı ya da password change pending durumu, kaç projeye ulaştığı, ve en son ne zaman oturum açtığı.

Düğme Ne yapar
New user Oluşturma diyaloğunu açar
Edit Görünen ad, e-posta, rol, ve active anahtarı
Reset password Bir kez gösterilen yeni bir geçici parola verir, ve o hesabı her yerde oturumdan çıkarır
Disable / Enable Devre dışı bir hesap oturum açamaz ve açık oturumları hemen sona erer
Delete Hesabı, oturumlarını ve üyeliklerini kaldırır. Onaylamak için iki kez tıklayın
SSO group mappings OIDC_GROUPS_CLAIM kullanılıyorsa kimlik sağlayıcı gruplarını projelere ve bir role eşler. Bkz. Tek Oturum Açma

New user, bir kullanıcı adı (küçük harf, kalıcı), opsiyonel bir görünen ad ve e-posta, bir rol — yalnızca bir root hesabına sunulan root ile birlikte member ya da admin — ve bir parola ister. Parolayı boş bırakın, ya da Generate’e basın, ve sunucu bir tane üretsin. Her iki durumda da bir kez, kopyalama düğmeli bir diyalogda gösterilir, ve Must change password at first sign-in varsayılan olarak işaretlidir.

Birinin oturumlarını sonlandırmak için ayrı bir düğme yoktur: Reset password, Disable ve Delete’in her biri, oldukları şeyin bir parçası olarak bunu yapar.

Basmanıza izin verilmeyen bir düğme grileşir ve üzerine geldiğinizde nedenini söyler — son aktif root hesabı, kendi satırınız, ya da siz bir admin iken bir root hesabı. Kuralların tamamı Hesaplar ve İzinler’dedir.

Gezinmek için ok tuşları, açmak için Enter.