Programmatic Integration
Programmatic Integration
Finding
Denne side er vigtig, fordi den viser de tre officielle måder at styre Hermes fra eksterne systemer uden at bygge en parallel agent-runtime.
What it is
Programmatic Integration forklarer, hvordan eksterne programmer kan drive Hermes via ACP, TUI Gateway JSON-RPC eller den OpenAI-kompatible API-server. Alle tre bruger samme `AIAgent`-kerne, men passer til forskellige forbrugere: IDE’er, custom hosts og HTTP/SSE-klienter. Siden dækker også model hot-swapping, sessions, approvals, streaming events og hvorfor Hermes ikke har brug for et separat `--mode rpc`.
Should we use it?
Use now. For Lisa’s Hermes+n8n+LangGraph mission er API-serveren og TUI Gateway særligt relevante, fordi de giver native adgang til Hermes fra webklienter, automation og custom orchestration uden at genopfinde agent-loopet. n8n bør typisk bruge HTTP/API-serveren, mens LangGraph eller et specialbygget control plane kan bruge TUI Gateway, hvis der er brug for sessions, approvals, branching og streaming events. ACP er mest “use later” til udvikler-workspaces, men siden som helhed bør bruges nu som integrationsregel.
Recommendation
Brug Programmatic Integration som standardbeslutningstræ: n8n og simple automations bruger API-serveren; avancerede session-/approval-/event-hosts bruger TUI Gateway; IDE-integration bruger ACP; direkte `AIAgent` import bruges kun ved stærkt kontrolleret Python-integration.
Use now
- Når n8n skal starte Hermes-runs via HTTP, følge status eller streame events.
- Når en OpenAI-kompatibel frontend skal tale med Hermes uden custom protokol.
- Når LangGraph skal kalde Hermes som agent-runtime i stedet for at kopiere Hermes’ tools, memory og fallback.
- Når en custom dashboard/host har brug for session state, approvals, clarify, branching eller interrupt.
- Når modelskift skal ske kontrolleret via `/model`, request `model` eller `X-Hermes-Model`.
Do not use / wait
- Brug ikke ACP som førstevalg til n8n/LangGraph; det er primært til IDE/editor-klienter.
- Byg ikke et custom `--mode rpc`-lag; Hermes har allerede ACP, TUI Gateway og API-server.
- Brug ikke direkte `AIAgent` import i produktion, før subprocess/API-server/TUI Gateway er vurderet først.
- Brug ikke API-serveren til flows, der kræver fuld slash-command/session/approval-kontrol; dér er TUI Gateway bedre.
- Eksponer ikke private sessioner, headers, logs, env-værdier eller interne run-data i offentlig dokumentation.
Public page note
Programmatic Integration viser, at Hermes kan styres fra IDE’er, custom hosts, webfrontends og automation via officielle protokoller oven på samme agent-kerne.