🧠 Rule1 Knowledge Hub — API Documentation

Witaj w systemie Rule1 Knowledge Hub. Platforma ta łączy zaawansowane możliwości RAG (Retrieval-Augmented Generation) z protokołem MCP (Model Context Protocol).

🚀 Główne Endpointy

💬 Czat i Agent AI

• POST /chat/ask - Zadaj pytanie agentowi. Agent automatycznie dobierze narzędzia i przeszuka bazę wiedzy.
• POST /chat/stream - To samo co wyżej, ale z odpowiedzią strumieniową (Server-Sent Events).

📄 Zarządzanie Dokumentami

• GET /documents/ - Lista wszystkich zaindeksowanych dokumentów.
• POST /documents/upload - Wgraj plik (PDF, DOCX, MD, TXT). Proces indeksowania odbywa się asynchronicznie w tle.
• GET /documents/status/{filename} - Sprawdź status przetwarzania pliku.
• DELETE /documents/{filename} - Usuń dokument z bazy wiedzy i indeksu wektorowego.

🔌 Integracja MCP (Model Context Protocol)

System udostępnia Bazę Wiedzy jako serwer MCP, co pozwala innym agentom (np. w IDE lub zewnętrznych systemach) korzystać z Twoich danych. * GET /mcp/sse - Endpoint połączenia SSE dla MCP. * POST /mcp/messages - Obsługa wiadomości protokołu MCP.

🛠️ Przykładowe użycie (cURL)

Zadanie pytania:

curl -X POST "https://kb.dev.rule1.eu/chat/ask" \
     -H "Content-Type: application/json" \
     -d '{"query": "Jakie są główne założenia projektu?"}'

Wgranie dokumentu:

curl -X POST "https://kb.dev.rule1.eu/documents/upload" \
     -F "file=@moj_dokument.pdf"

System automatycznie korzysta z modeli OpenAI (GPT-4o-mini) do analizy Twoich danych.