Bağlantılar ve geliştirici erişimi
Canlı uç noktalar
- Genel API (HTTPS)
https://ragsource.turuncupro.com- MCP-RAG
https://ragsource.turuncupro.com/mcp/rag- REST arama
https://ragsource.turuncupro.com/v1/search· çift arama (RAG ∥ MCP) varsayılan- Sağlık
https://ragsource.turuncupro.com/health·https://ragsource.turuncupro.com/ready- Embedding / Reranker
- — / —
- Vektör ANN
- qdrant
PM2 bağlama adresleri: API 0.0.0.0:8010, UI 127.0.0.1:3010. Harici istemciler için önerilen adres HTTPS genel API'dir.
AI Hukuk Asistanı — çift arama iş akışı
Tek MCP bağlantısı (https://ragsource.turuncupro.com/mcp/rag). Asistan rag_search çağırır; sunucu RAG korpusu ile resmi MCP kaynaklarını birlikte tarar, yanıtı birleştirir ve eksik belgeleri RAG’e ekler. Bu sunucuda yerel embedding kapalı — örneklerde mode: "lexical" kullanın veya Ayarlar’dan OpenAI embedding yapılandırın.
- 1. Çift aramaRAG (Qdrant + FTS) ve resmi MCP kaynakları paralel sorgulanır.
- 2. Birleştir & yanıtla
results[]passage’ları +externalCandidates[]ile sentez; atıf içinassistant.howToCite. - 3. Bilgi senkronuRAG’de olmayan MCP sonuçları otomatik içe aktarılır (
awaitIngestionvarsayılan true).
Arama modu (RAG füzyonu)
Tüm araçlar /mcp/rag üzerinden. Hibrit = leksikal + semantik (atıf güvenli varsayılan).
Güncellik / çift arama
awaitIngestion: true — yeni MCP belgeleri RAG’e yazılınca korpus aynı çağrıda yeniden sorgulanır.
Kaynak kapsamı
Bir veya birkaç preset (ör. Mevzuat + Yargıtay) ya da tek tek bağlayıcı. Boş / Tümü = tüm etkin kaynaklar. Seçim RAG ve resmi MCP probe için ortaktır.
MCP — rag_search (birincil)
{
"method": "tools/call",
"params": {
"name": "rag_search",
"arguments": {
"question": "Alt kiracı olarak oturan müvekkilimizin, asıl kira sözleşmesi feshedildiğinde tahliye edilip edilemeyeceği",
"k": 8,
"mode": "lexical",
"awaitIngestion": true
}
}
}MCP araçları (RAG + edinim)
| Araç | Tür | Ne zaman |
|---|---|---|
rag_search | Çift arama | Varsayılan — RAG ∥ MCP + bilgi senkronu |
rag_investigate | Ajanik | Çok adımlı hukuki soruşturma + kanıt paketi |
rag_hybrid_search | RAG | Leksikal + semantik birleşik |
rag_semantic_search | RAG | Kavramsal (atıf yolunda hibrite yükseltilir) |
rag_lexical_search | RAG | Madde no, esas/karar no, tam terim |
rag_list_sources | Meta | Kaynak ve ön tanım listesi |
rag_get_document | RAG | Tam karar/mevzuat — docId ile |
ext_search | MCP | Resmi kaynakta doğrudan metadata arama |
ext_fetch_document | MCP→RAG | Tek belge çek ve corpus’a ekle |
ext_search_and_ingest | MCP→RAG | Kaynakta ara + toplu içe aktar |
ext_job_status | MCP | İçe aktarma iş durumu |
REST — AI backend
curl -H "X-API-Key: ulaw_..." \ "https://ragsource.turuncupro.com/v1/search?q=Alt%20kirac%C4%B1%20olarak%20oturan%20m%C3%BCvekkilimizin%2C%20as%C4%B1l%20kira%20s%C3%B6zle%C5%9Fmesi%20feshedildi%C4%9Finde%20tahliye%20edilip%20edilemeyece%C4%9Fi&mode=lexical"
REST — POST
curl -X POST -H "X-API-Key: ulaw_..." -H "Content-Type: application/json" \
"https://ragsource.turuncupro.com/v1/search" \
-d '{
"query": "Alt kiracı olarak oturan müvekkilimizin, asıl kira sözleşmesi feshedildiğinde tahliye edilip edilemeyeceği",
"question": "Alt kiracı olarak oturan müvekkilimizin, asıl kira sözleşmesi feshedildiğinde tahliye edilip edilemeyeceği",
"k": 8,
"mode": "lexical",
"awaitIngestion": true
}'Yanıt yapısı (sentez için)
{
"mode": "lexical",
"externalSync": true,
"freshness": {
"officialSourcesChecked": true,
"ingestionWaited": true,
"corpusRequeried": true
},
"results": [{ "passage": "…", "docId": "…", "reference": { "bibliographic": "…" } }],
"externalCandidates": [{ "title": "…", "inCorpus": false, "url": "…" }],
"acquisition": { "novelHits": 1, "jobs": [{ "sourceId": "…", "jobId": "…" }] },
"citationFaithfulness": { "citable": 3, "total": 3 },
"assistant": {
"howToCite": "Dual search… Combine results[] with externalCandidates[]…",
"suggestedFollowUp": "…"
}
}Kaynak kataloğu
| Kaynak | ID | Katman |
|---|
API istemcileri
Hızlı başlangıç
Bir API anahtarı oluşturun ve hukuk yazılımınızdan aşağıdaki biçimde bağlanın.
curl -H "X-API-Key: ulaw_..." \ "https://ragsource.turuncupro.com/v1/search?q=mülkiyet+hakkı&sourcePreset=ictihat&mode=hybrid"
Varsayılan: RAG ∥ MCP çift arama + yeni belgelerin RAG’e eklenmesi. Yalnızca korpus için syncExternal=false ekleyin. Kaynak listesi: /v1/sources. Artımlı eşitleme: /v1/changes.ndjson?after=....