How huabeitech/agent-desk works
AgentDesk is an AI-first customer-support helpdesk: customer requests become conversations, AI replies use configured agents and knowledge retrieval, and unresolved requests can move to human support and ticket tracking. The product also includes an agent workspace, knowledge-base management, AI workflow editing, and integrations. The graph follows documented product flows and excerpted route/editor wiring; several backend service connections and unsampled subsystem internals are represented only where the README documents them, so those edges cite the README rather than implying source inspection.
Main entry points: agent_loop_engine.go AI Reply Runtime · routes.go Customer API Routes · rag Knowledge RAG · page.tsx Conversation Workspace
Components 21
Support Entry
- Customer Support UI
web/app/(support)/support/page-client.tsx - Customer API Routes
internal/bootstrap/routes.go
Conversation Operations
- Conversation Workspace
web/app/(dashboard)/dashboard/conversation-monitor/page.tsx - Conversation Detail
web/app/(dashboard)/dashboard/conversation-monitor/_components/detail.tsx - Conversation Handlers
internal/handlers/api/conversation_handler.go - Support Handlers
internal/handlers/api/support_handler.go - Ticket Workflows
internal/handlers/dashboard/ticket_handler.go
AI and Knowledge
- AI Reply Runtime
internal/ai/application/runtime/agent_loop_engine.go - Knowledge RAG
internal/ai/rag - Knowledge Management
internal/handlers/dashboard/knowledge_retrieve_handler.go - Retrieval Logs
internal/services/knowledge_retrieve_log_service.go - Model Provider
- Vector Store
internal/ai/rag/vectordb/provider.go
Workflow Design
- Workflow Editor
flowgram-editor/src/editor.tsx - Initial Workflow Data
flowgram-editor/src/initial-data.ts - Workflow Runtime
internal/ai/runtime/workflow/executor.go
Support Platform
- HTTP Server
internal/bootstrap/server.go - Support Data Store
internal/models/models.go
Other components
- Customer
- Support Agent
- Administrator
Connections 22
- Customer → Customer Support UI: starts support
README.md - Customer Support UI → Customer API Routes: requests help
- Customer API Routes → Conversation Handlers: routes requests
internal/bootstrap/routes.go - Customer API Routes → Support Handlers: routes support
internal/bootstrap/routes.go - Conversation Handlers → AI Reply Runtime: triggers reply
README.md - AI Reply Runtime → Knowledge RAG: retrieves evidence
internal/ai/application/runtime/agent_loop_engine.go - Knowledge RAG → Vector Store: searches vectors
- AI Reply Runtime → Model Provider: generates answer
- AI Reply Runtime → Support Handlers: requests handoff
README.md - Support Handlers → Support Agent: hands off
README.md - Support Agent → Conversation Workspace: handles conversation
README.md - Conversation Workspace → Conversation Detail: opens detail
web/app/(dashboard)/dashboard/conversation-monitor/page.tsx - Conversation Workspace → Conversation Handlers: loads conversations
- Support Agent → Ticket Workflows: creates tickets
README.md - Administrator → Knowledge Management: manages knowledge
README.md - Knowledge Management → Knowledge RAG: configures retrieval
- Knowledge RAG → Retrieval Logs: records retrievals
- Administrator → Workflow Editor: designs workflows
README.md - Workflow Editor → Initial Workflow Data: loads defaults
flowgram-editor/src/editor.tsx - Workflow Editor → Workflow Runtime: defines execution
- HTTP Server → Customer API Routes: registers routes
internal/bootstrap/server.go - HTTP Server → Support Data Store: serves product data