🤖 AI API

Endpoint-uri publice pentru training data și retrieval (RAG) ale Bibliotecii de cunoștințe. Proiectate să fie ușor de consumat de agenți AI, crawleri și pipeline-uri de machine learning.

📦 Training Data (Articole)

Exportă articolele în format JSONL (câte un JSON pe linie) — ideal pentru fine-tuning, embedding sau RAG.

GET /api/ai/training/articles training knowledge-base

Toate cele 35 de articole din bibliotecă. Fiecare conține titlu, sumar, conținut integral, categorii, tag-uri, dificultate, timp de citire. Returnează application/jsonl.

🔍 Retrieval (RAG)

Caută full-text și primești documente structurate cu content (gata de trimis la un embedding model) și metadata bogată.

GET /api/ai/retrieve/articles?q= retrieval knowledge-base

Caută full-text doar în articole — folosește PostgreSQL to_tsvector('romanian', ...) cu fallback ILIKE. Returnează documente RAG structurate cu slug, categorii, tag-uri, dificultate.

Parametru	Tip	Descriere
`q`	string	Termenul de căutare

GET /api/ai/search?q= retrieval

Căutare unificată — articole + produse + anunțuri simultan.

Parametru	Tip	Descriere
`q`	string	Termenul de căutare

📄 LLM Discovery

Endpoint-uri standard pentru crawleri AI și LLM-uri (conform llmstxt.org).

GET /llms.txt discovery

Index rezumat al bibliotecii — linkuri principale + API-uri disponibile. Recomandat de llmstxt.org.

GET /llms-full.txt discovery

Index complet al tuturor articolelor — titlu, sumar, dificultate, categorie per articol.

GET /rss.xml discovery

Feed RSS 2.0 cu ultimele 20 de articole. Ideal pentru crawleri și agregatoare.

🧭 Discovery

Endpoint	Descriere
`GET /api/ai/openapi.json`	Specificația OpenAPI 3.1 completă (toate endpoint-urile)
`GET /api/ai/docs`	Această pagină
`GET /robots.txt`	Permite GPTBot, Google-Extended, CCBot + sitemap link
`GET /sitemap.xml`	Sitemap pentru descoperirea conținutului de către motoarele de căutare

📐 Structura Document RAG

{
  "id": "article:verificare-matematica",
  "type": "article",
  "title": "Verificare Matematică a Software-ului",
  "content": "Articol: Verificare Matematică... Rezumat: ... Categorie: ... Dificultate: ...",
  "metadata": {
    "slug": "verificare-matematica",
    "category_path": ["Fundamente matematice", "Verificare formală"],
    "tags": ["seL4", "logica Hoare", "theorem prover", ...],
    "difficulty": "advanced",
    "reading_time_minutes": 16
  },
  "url": "/biblioteca/verificare-matematica"
}

📊 Statistici

Metrică	Valoare
Total articole	35
Nivel	34× advanced, 1× intermediate
Limbă	Română (diacritice)
Total timp citire	~11 ore

AI API — Documentație
Pentru întrebări, contactează echipa de developeri.