Adding a Platform Adapter
Adding a Platform Adapter
Finding
Denne side er vigtig, fordi den viser, at nye chat- og messaging-kanaler bør tilføjes som Hermes plugins i stedet for som tunge core-ændringer.
What it is
Siden forklarer, hvordan man bygger en platform-adapter til Hermes gateway, så brugere kan tale med agenten via en ekstern kanal som Telegram, Discord, Teams, LINE eller en specialplatform. Den anbefalede vej er plugin-modellen: en lille plugin-mappe med metadata og en adapter, som registrerer platform, miljøvariabler, cron-delivery, brugerautorisation, beskedgrænser og eventuelle platformsspecifikke værktøjer. Den indbyggede vej kræver ændringer mange steder i Hermes core og er primært for officielle platforme.
Should we use it?
Use later. For Lisa’s Hermes+n8n+LangGraph-mission er det vigtigste lige nu ikke at bygge flere chatkanaler, men at stabilisere Telegram, cron, skills, memory, n8n flows og LangGraph-orkestrering. Siden er dog strategisk vigtig, hvis Hermes senere skal kobles til en platform, som n8n eller LangGraph ikke allerede dækker pænt, eller hvis en offentlig/demo-kanal skal have sin egen Hermes-adapter. Plugin-vejen passer godt til anti-overbuild-princippet, fordi den undgår core forks og holder integrationen isoleret.
Recommendation
Brug denne dokumentation som standardbeslutning for fremtidige nye messaging-kanaler: “plugin first, built-in only if Hermes upstream skal eje platformen.”
Use now
- Når vi dokumenterer, at Hermes gateway kan udvides uden at ændre core-koden.
- Når en fremtidig kundekanal eller intern platform kræver direkte samtale med Hermes, ikke kun webhook-automatisering.
- Når cron-output skal kunne leveres til en ny platform via et klart home-channel target.
- Når en platform har særlige UX-regler, f.eks. beskedlængde, typing-indikatorer, reply-token-vinduer eller langsomme LLM-svar.
- Når vi vil holde n8n til workflow-orkestrering og Hermes gateway til agent-samtaler.
Do not use / wait
- Brug det ikke nu bare for at tilføje flere kanaler; Telegram dækker den aktuelle drift.
- Brug ikke built-in path for lokale eller kundespecifikke integrationer, medmindre målet er upstream Hermes core-support.
- Brug ikke platform-adaptere som erstatning for n8n webhooks, hvis flowet bare er event → transformering → handling.
- Vent, hvis integrationen kræver hemmeligheder, private logs eller ustabil platformadgang, som ikke kan beskrives public-safe.
- Undgå at bygge en adapter, hvis en eksisterende Hermes platform, webhook eller n8n-node løser opgaven enklere.
Public page note
Hermes kan udvides med nye messaging-platforme via plugins, så nye kanaler kan tilføjes isoleret, genbrugeligt og uden at forgrene Hermes core.