LangGraph Builder Team

Aktiver Stand: offizielle LangChain / LangGraph / LangSmith Trennung

LangChain bleibt Code-Library fuer Tools und Runnables. LangGraph ist Graph Runtime und optional separater Server. LangSmith bleibt externe Observability/Evaluation. Diese App ist die Operator-Oberflaeche fuer Builds, Memory, History und Deployment.

Builder UIbuilder.<domain> / lokal :8000

Builder APIapi.<domain> / FastAPI

LangGraph Servergraph.<domain> / langgraph.json

LangSmithsmith.langchain.com / extern

Agent Chat

Direkt mit dem Builder Team sprechen. Nachrichten werden gespeichert, in Qdrant indexiert und koennen optional einen Build ausloesen.

Waehle Projekt und Agent, dann schreibe deine Nachricht.

Chat Optionen

Project ID

Agent

LLM nutzen, wenn Key gesetzt ist Nachricht als Build ausfuehren

Status

Bereit.

Quality Gate

Status

Artefakte

Builds

Request planen

Project ID

Deployment Ziel

Quality Threshold

Builder Request

Build Ergebnis

Noch kein Build ausgefuehrt.

Bereit.

Plan

Kein Plan vorhanden.

Artefakte

Agenten bauen und pflegen

Agent Specs liegen in agents/, System Prompts in prompts/. Neue Agenten sollten zuerst als Spec geplant, dann als Node implementiert und danach getestet werden.

Memory & Chat History

Kurzfristiger Runtime-State lebt im `BuilderState`. Production-Checkpoints sollen in Postgres liegen. Projekt- und globale Wissenssuche sind fuer Qdrant vorbereitet.

Chat Project ID

Chat / Plan Notiz

Qdrant Memory Search

Builds und Chat-Nachrichten werden in Qdrant indexiert, wenn Qdrant erreichbar ist. Ohne Qdrant nutzt die App einen lokalen Fallback fuer Tests.

Suchanfrage

Archiv

Builds und Chat-History werden in Postgres persistiert, wenn die DB erreichbar ist. Artefakte bleiben zusaetzlich im Build-Payload versioniert.

docs/reports/

generated_artifacts

project_id namespace

Produkt-Trennung & Routing

Diese Aufteilung folgt der vorgesehenen Produktrolle: LangChain im Code, LangGraph als Runtime/Server, LangSmith extern fuer Observability. Postgres und Qdrant bleiben interne Infrastruktur.

LangChainKeine Subdomain: Python/JS Library im Code

LangGraphgraph.<domain> -> langgraph-server:2024

LangSmithsmith.langchain.com / LANGSMITH_ENDPOINT

Builder Teambuilder.<domain> und api.<domain>

Frameworks & Adapter

Status fuer LangChain, LangGraph, Deep Agents, MCP, Agent Protocol, Open SWE, LangSmith und JS-Starter. Werte kommen aus Backend-Konfiguration und vorhandenen Adapter-Dateien.

Agent Protocol

POST /agent-protocol/threads
POST /agent-protocol/runs
GET /agent-protocol/threads/{thread_id}

MCP & Open SWE

GET /mcp/tools
POST /integrations/open-swe/task
GET /integrations/deep-agents/code

Settings & API Keys

API Keys werden nicht im UI gesetzt oder angezeigt. Lokal kommen sie in `.env`, auf dem VPS in Environment Variables oder einen Secret Manager. Der Server zeigt hier nur, ob ein Key gesetzt ist.

Templates

LLM Adapter Test

OpenAI-kompatibler Adapter. Setze `OPENAI_API_KEY`, optional `LLM_BASE_URL` und `LLM_MODEL` in `.env` oder auf dem VPS.

Prompt

Kein LLM-Test ausgefuehrt.

VPS Ready-to-Start

cp .env.example .env
docker compose up -d --build
curl http://localhost:8000/health

Remote-Deployment ist mit `scripts/deploy_vps.sh` vorbereitet. Benoetigt werden `VPS_HOST`, `VPS_USER` und optional `VPS_PATH`.

Production Checkliste

Starke `POSTGRES_PASSWORD` und passende `POSTGRES_DSN` setzen.

API/UI vor oeffentlichem Betrieb mit Auth schuetzen.

Reverse Proxy mit TLS konfigurieren.

Backups fuer Postgres und Qdrant einrichten.

LangSmith/Logging/Metrics aktivieren, sobald Live-LLM-Nodes laufen.

Build History

Prozesslokale History der letzten Builds. Fuer dauerhaftes Archiv: Postgres/Object Storage anbinden.