AgentDesk
AgentDesk is an open-source AI customer support system that combines live chat, knowledge retrieval, ticket workflows, and human handoff.
What AgentDesk is
AgentDesk is an open-source AI customer support system that combines live chat, knowledge retrieval, ticket workflows, and human handoff. It is released under the Apache License 2.0 and can be deployed as a web service. Customers can start through an embeddable web widget or standalone chat page, and the system also supports Open API or WebSocket interfaces, WeChat Official Account flows, and WeCom customer service callbacks. AI can handle common requests, pass conversations and their context to human agents, and move cases into ticket follow-up. Its retrieval-augmented knowledge base supports FAQs and documents, with logs for tracing the sources behind answers. AI agents can use configurable Skills and MCP tools to connect to external systems and perform business actions. The system works through OpenAI-compatible model interfaces, with documented examples spanning hosted providers and local Ollama or LocalAI endpoints. Deployment options include Docker Compose with MySQL and Qdrant or a single-container trial setup using SQLite and LanceDB. The documentation recommends security precautions before production use, including HTTPS, changing the bootstrap administrator password, and keeping secrets server-side.
Good
- Supports web, WeChat, and WeCom channels.
- AI handoff carries conversation context to agents.
- Knowledge retrieval includes logs for tracing answers.
- Open source under Apache License 2.0.
Watch out
- Standard Docker Compose setup requires Docker and Docker Compose.
- Only one enabled model configuration per model type.
- Azure OpenAI may require a compatible proxy or adapter.
- Security changes are recommended before team or public use.
Who it suits
AgentDesk suits support teams that want AI-assisted customer service with human escalation and tracked ticket follow-up. Its deployment and integration options also address administrators, support managers, and developers.
Verdict
AgentDesk brings AI responses, knowledge retrieval, channel support, and human follow-up into one open-source support system. Teams should review its deployment requirements, model configuration limits, and recommended security steps before putting it into use.
The facts
Each one read from AgentDesk's own pages, with the date it was checked.
What it does
- Agent tools
- AI Agents can use configurable Skills and MCP tools to connect with external systems.checked 10 Oct 2026
- Authentication
- Dashboard login supports password, OIDC, and WeCom sessions, with configurable session lifetime and password lockout settings.checked 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.checked 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.checked 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.checked 10 Oct 2026
- Knowledge base
- Its knowledge base uses RAG to retrieve support information for AI answers.checked 10 Oct 2026
- License
- The project is released under the Apache License 2.0.checked 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.checked 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.checked 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.checked 9 Oct 2026
- Product
- AgentDesk is an open-source AI customer support system that combines live chat, knowledge retrieval, ticket workflows, and human handoff.checked 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.checked 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.checked 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.checked 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.checked 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.checked 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.checked 9 Oct 2026
- WeChat Official Account links can direct users to AgentDesk web support as guests or identify them with a user token.checked 10 Oct 2026
