Skip to content
SPECIFICTION
Get listed

AgentDesk

agent-desk.huabei.pro

WebAPISelf-hosted
Visit agent-desk.huabei.pro
Spec score 7.5 #19 of 40 in AI Customer Service Software

What it is

AgentDesk is a free, open-source customer support system for web, self-hosted, and API use. It combines AI-assisted replies, knowledge retrieval, ticket workflows, routing automation, workflow actions, and human escalation. Customers can arrive through an embeddable web widget, a standalone chat page, Open IM API or WebSocket connections, WeChat Official Account flows, or WeCom Customer Service callbacks. Its hybrid AI model can handle common requests, pass conversation context to a human, and move cases into ticket follow-up. The RAG knowledge base supports FAQs and documents and records retrieval logs for answer tracing. Configurable Skills and MCP tools let AI agents connect with external systems and perform business actions. Deployment documentation covers Docker Compose with MySQL and Qdrant, plus a single-container SQLite and LanceDB trial. Dashboard login supports passwords, OIDC, and WeCom. The Apache License 2.0 governs the project. Documentation recommends changing the initial administrator password, using HTTPS, protecting secrets, and restricting CORS before production use.

Spec sheet

Product
AgentDesk is an open-source AI customer support system that combines live chat, knowledge retrieval, ticket workflows, and human handoff.Read 10 Oct 2026 · agent-desk.huabei.pro
Intended users
The architecture describes the dashboard as intended for operators, administrators, and support managers, and the public architecture guide also addresses integrators and developers.Read 10 Oct 2026 · agent-desk.huabei.pro
Deployment
The Docker Compose stack includes the application server, MySQL, and Qdrant; a single-container SQLite and LanceDB setup is also documented.Read 10 Oct 2026 · agent-desk.huabei.pro
Security
The documentation recommends changing the bootstrap administrator password, using HTTPS, keeping secrets server-side, and restricting CORS origins before production use.Read 9 Oct 2026 · agent-desk.huabei.pro
License
The project is released under the Apache License 2.0.Read 10 Oct 2026 · agent-desk.huabei.pro
Agent tools
AI Agents can use configurable Skills and MCP tools to connect with external systems.Read 10 Oct 2026 · agent-desk.huabei.pro
Authentication
Dashboard login supports password, OIDC, and WeCom sessions, with configurable session lifetime and password lockout settings.Read 10 Oct 2026 · agent-desk.huabei.pro
Channels
Customer entry points include an embeddable web widget, open API or WebSocket interfaces, and third-party channels such as WeCom customer service callbacks.Read 10 Oct 2026 · agent-desk.huabei.pro
Knowledge base
Its knowledge base uses RAG to retrieve support information for AI answers.Read 10 Oct 2026 · agent-desk.huabei.pro
Model integrations
AgentDesk uses OpenAI-compatible interfaces for chat, embedding, and optional rerank models; administrators configure the endpoint, API key, and model name.Read 10 Oct 2026 · agent-desk.huabei.pro
Model providers
The system uses OpenAI-compatible model interfaces and documents examples for OpenAI, DeepSeek, Qwen or DashScope, OpenRouter, and local Ollama or LocalAI endpoints.Read 9 Oct 2026 · agent-desk.huabei.pro
Operational limits
Only one enabled model configuration is used for each model type, and direct Azure OpenAI use may require a compatible proxy or backend adapter.Read 9 Oct 2026 · agent-desk.huabei.pro
Security guidance
The documentation recommends HTTPS, changing the bootstrap administrator password, keeping secrets out of frontend code, and assigning least-privilege roles.Read 10 Oct 2026 · agent-desk.huabei.pro
Setup requirements
The standard Docker Compose setup requires Docker and Docker Compose, and the quick start says to change the default admin password before team or public use.Read 10 Oct 2026 · agent-desk.huabei.pro
Support and setup
The maker provides a Docker Compose quick-start guide and links to the source repository; the site also offers a demo appointment via WeChat.Read 9 Oct 2026 · agent-desk.huabei.pro
Support workflow
AI can handle first replies and common requests, with conversations transferred to human agents with context intact and follow-up tracked as tickets.Read 10 Oct 2026 · agent-desk.huabei.pro
Target users
The project is aimed at support teams that need AI-assisted customer service, human escalation, and tracked follow-up in one system.Read 9 Oct 2026 · agent-desk.huabei.pro
WeChat
WeChat Official Account links can direct users to AgentDesk web support as guests or identify them with a user token.Read 10 Oct 2026 · agent-desk.huabei.pro

Strong points and limits

Strong points

  • Free and open source
  • Supports ticketing and routing workflows
  • Provides human handoff with context
  • Offers web, WeChat, WeCom, and API channels
  • Knowledge base includes retrieval logs

Limits

  • Only one enabled model configuration per type
  • Direct Azure OpenAI may require an adapter
  • Production setup requires security hardening
  • Docker Compose setup requires Docker

Who it suits

AgentDesk suits support teams needing AI-assisted service with human handoff and tracked tickets. It also fits operators, administrators, support managers, integrators, and developers working across web, WeChat, WeCom, or API channels.

Verdict

AgentDesk brings multichannel intake, AI assistance, ticketing, and escalation into one open-source system. Its deployment choices and security prerequisites are explicit, but model configuration and Azure compatibility have stated limits.

Where Specifiction places it

Alternatives to AgentDeskAll alternatives →