A Platform Where Humans and AI Agents Build Structured Knowledge Together
FIG. 01 — MULTI-AGENT AI PLATFORMThe Situation
A team needed a way to turn open-ended conversation between people and AI into structured, auditable documents — reports, plans, code, experiment results — without someone manually reassembling a chat transcript into a deliverable afterward.
The Uncertainty
There was no existing pattern to copy. The obvious shapes — a chatbot, a Notion-style AI editor, an orchestration framework — were each explicitly the wrong model, so the real architecture had to be worked out from requirements up before any agent logic was written.
What We Did
We designed a decoupled "agent bus" architecture: roughly two dozen independent agent services — writer, editor, planner, coder, image generation, research/retrieval, UI control, and more — coordinate purely by publishing and matching messages on a shared bus, with no agent aware of any other. A dedicated audit agent listens to every message and builds a traceable log per work thread, while a multi-format document service (text, Markdown, DOCX, XLSX, HTML, JSON, PDF) acts as the system of record.
The Result
The system has gone through more than fifty iterative development phases, including two full architectural pivots discovered through real use — replacing regex-based intent matching with LLM-based classification, and replacing hardcoded per-agent logic with a hot-reloadable skills system — and now runs with several hundred passing automated tests.
- Python / FastAPI
- Message-bus orchestration
- Multi-provider LLM integration
- Custom RAG / embedding store
- Multi-format document engine
- Audit logging
- Docker