Ga naar hoofdinhoud

LibreChat-architectuur

LibreChat is de standaard GovChat-NL-front-end. De referentie-deployment staat in docker-compose.yml en wordt als geheel gestart. Dit is een referentie-implementatie; iedere organisatie blijft verantwoordelijk voor eigen security-, privacy-, continuïteits- en acceptatiebeoordelingen.

Componenten​

LaagComponentenRol
GebruikersinterfaceLibreChat, LibreChat-proxy, admin panelChatinterface, login/UI-configuratie en overlay-injectie.
Chat- en agentkoppelingn8n-openai-bridgeOpenAI-compatibele /v1-endpoint; routeert chatverzoeken naar n8n en streamt tekst en tool-events terug.
Workflow runtimen8n, JavaScript task runner, n8n-bootstrapDraait agent- en app-workflows; bootstrap importeert workflows uit de repository.
Model gatewayLiteLLM en PostgreSQLModelrouter/provideradapter voor LibreChat en de AI-nodes in n8n.
ApplicatiedataMongoDB, Redis, MeilisearchLibreChat-gesprekken/configuratie, sessie/cache en zoekindex.
WorkflowdataPostgreSQL voor n8n, Qdrantn8n-credentials/executies; Qdrant is intern voor OpenBesluitvorming.
Beheerretention worker, permissions-init, optionele admin-overlayDatabewaring, volume-rechten en optionele beheerfuncties.

Compose-profielen schakelen aanvullende services in, waaronder RAG (rag), beheer (admin) en admin-overlay (admin-overlay). Controleer de actuele Compose-definities voordat je profielen in een productieomgeving activeert.

Standaard request-flow​

LibreChat gebruikt het custom endpoint govchat-orchestrator op http://n8n-openai-bridge:3333/v1. De bridge koppelt het modelalias aan de interne n8n-webhook voor de orchestrator. n8n roept LiteLLM/provider-modellen aan. Wijs de orchestrator niet terug naar de bridge: dat veroorzaakt een recursieve bridge→orchestrator→bridge-aanroep.

Automatische workflow-import​

De eenmalige n8n-bootstrap-service importeert workflow-JSON uit agents/n8n/workflows/ in de lokale n8n-database. De normale installatie vereist dus geen handmatige workflow-import. Controleer na de eerste start de bootstraplogs en valideer de bronbestanden met node tests/agents/validate-workflows.js.

Importeren configureert geen omgevingsafhankelijke credentials, provider/API-sleutels, webhook tokens of externe databronnen. Controleer die instellingen afzonderlijk en activeer data-ingest/synchronisatieworkflows pas nadat hun bronnen en doelen zijn ingericht.

Data- en netwerkgrenzen​

Services communiceren op interne Docker-netwerken. Publiceer alleen de poorten die voor operators of gebruikers nodig zijn; plaats LibreChat achter de organisatieproxy. MongoDB, n8n/PostgreSQL, Redis, LiteLLM/PostgreSQL en Qdrant bevatten of verwerken gegevens. Beperk beheerpoorten en toegangsrechten en test herstel uit back-ups. De retentie-worker en n8n execution/log cleanup zijn configureerbaar; zie het retentiebeleid in de hoofdrepository.

Verder lezen​