Knowledge Base
Create a help center with articles that customers can browse and search.
The GudDesk knowledge base lets you publish help articles that customers can browse and search. If you connect your own agent, it can search the same articles through the MCP server.
Creating Articles
- Navigate to Dashboard > Knowledge Base
- Click New Article
- Write your article in the text editor. Each line break starts a new paragraph on the help center
- Assign it to a collection (category)
- Set the status to Published when ready
Article Structure
Good help articles follow a consistent structure:
- Title: Clear, searchable (e.g., "How to Reset Your Password")
- Excerpt: A short summary of the article
- Body: Step-by-step instructions
- Collection: The category this article belongs to
Collections
Collections organize your articles into browsable categories:
- Getting Started: Onboarding guides for new users
- Account & Billing: Password resets, plan changes, invoices
- Features: How to use specific product features
- Troubleshooting: Common issues and fixes
Create collections on the Knowledge Base page.
Public Help Center
Your knowledge base is automatically available as a public help center at:
https://your-domain.com/help/your-workspace-slug
Each workspace has its own help center. There is no shared page at /help itself, so link to your workspace's address.
Customers can browse collections, search articles, and find answers without contacting support.
Your Own Agent
GudDesk does not ship a built-in agent yet. If you connect your own agent, it can list articles through the REST API and search published articles with the MCP server's search_articles tool, then use them in its BOT replies.
The widget does not suggest articles yet. Article suggestions are planned (see the roadmap).
Search
Help center search matches the words you type against article titles and bodies. It is a plain text match, so results are not ranked by relevance.
Analytics
Track how your knowledge base performs:
- Article views: Which articles are most popular
- Helpful votes: Which articles readers marked helpful or not helpful