- Home
- AI Customer Service Agents
- AgentDesk
AgentDesk
What it is
AgentDesk is a free, open-source customer support system for web, API, and self-hosted use. It combines live chat, knowledge retrieval, ticket workflows, routing automation, workflow actions, and human handoff. AI can answer common requests, pass a conversation with context to a person, and move the case into ticket follow-up. Its retrieval-augmented knowledge base supports FAQs and documents, with logs for tracing answers. Agents can use configurable Skills and MCP tools to connect with external systems and perform business actions. Customers can reach teams through an embeddable web widget, standalone chat page, Open API or WebSocket interfaces, WeChat Official Account, and WeCom Customer Service. The system uses OpenAI-compatible interfaces, including documented connections for OpenAI, DeepSeek, Qwen, OpenRouter, Ollama, and LocalAI. Deployment documentation covers Docker Compose with MySQL and Qdrant, plus a single-container SQLite and LanceDB trial. Dashboard authentication supports password, OIDC, and WeCom login. The project is released under Apache License 2.0.
For and against
For
- Free and open source
- Supports human handoff with context
- Knowledge base includes retrieval logs
- Web, WeChat, WeCom, API, and WebSocket channels
- Ticketing and routing workflows
Against
- Only one enabled model configuration per type
- Standard setup requires Docker and Docker Compose
- Azure OpenAI may need a compatible proxy
- Production setup requires security configuration
The verdict
AgentDesk brings AI responses, channel connections, ticketing, and human escalation into one support system. Its self-hosted deployment and configuration requirements matter for teams planning production use.
Who it suits
AgentDesk suits support teams needing AI-assisted conversations, human escalation, ticket follow-up, and multiple web or WeChat channels. Operators, administrators, support managers, integrators, and developers are addressed in its architecture.
On the record
- Agent tools
- AI Agents can use configurable Skills and MCP tools to connect with external systems.agent-desk.huabei.pro · read 10 Oct 2026
- Authentication
- Dashboard login supports password, OIDC, and WeCom sessions, with configurable session lifetime and password lockout settings.agent-desk.huabei.pro · read 10 Oct 2026
- Channels
- Customer entry points include an embeddable web widget, open API or WebSocket interfaces, and third-party channels such as WeCom customer service callbacks.agent-desk.huabei.pro · read 10 Oct 2026
- Deployment
- The Docker Compose stack includes the application server, MySQL, and Qdrant; a single-container SQLite and LanceDB setup is also documented.agent-desk.huabei.pro · read 10 Oct 2026
- 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.agent-desk.huabei.pro · read 10 Oct 2026
- Knowledge base
- Its knowledge base uses RAG to retrieve support information for AI answers.agent-desk.huabei.pro · read 10 Oct 2026
- License
- The project is released under the Apache License 2.0.agent-desk.huabei.pro · read 10 Oct 2026
- Model integrations
- AgentDesk uses OpenAI-compatible interfaces for chat, embedding, and optional rerank models; administrators configure the endpoint, API key, and model name.agent-desk.huabei.pro · read 10 Oct 2026
- 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.agent-desk.huabei.pro · read 9 Oct 2026
- 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.agent-desk.huabei.pro · read 9 Oct 2026
- Product
- AgentDesk is an open-source AI customer support system that combines live chat, knowledge retrieval, ticket workflows, and human handoff.agent-desk.huabei.pro · read 10 Oct 2026
- Security
- The documentation recommends changing the bootstrap administrator password, using HTTPS, keeping secrets server-side, and restricting CORS origins before production use.agent-desk.huabei.pro · read 9 Oct 2026
- Security guidance
- The documentation recommends HTTPS, changing the bootstrap administrator password, keeping secrets out of frontend code, and assigning least-privilege roles.agent-desk.huabei.pro · read 10 Oct 2026
- 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.agent-desk.huabei.pro · read 10 Oct 2026
- 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.agent-desk.huabei.pro · read 9 Oct 2026
- 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.agent-desk.huabei.pro · read 10 Oct 2026
- Target users
- The project is aimed at support teams that need AI-assisted customer service, human escalation, and tracked follow-up in one system.agent-desk.huabei.pro · read 9 Oct 2026
- WeChat Official Account links can direct users to AgentDesk web support as guests or identify them with a user token.agent-desk.huabei.pro · read 10 Oct 2026
