Guides

Step-by-step tutorials and best practices to help you get the most out of Kapa.

Best practices for building an in-product agent· 12mLessons from building a 30-tool analytics agent, covering tool design, API adaptation, custom instructions, and observability.Building Agents

Connect your agent to your docs with MCP· 15mBuilding an agent? Wire it to your knowledge base via a Kapa Hosted MCP server so it can answer product questions alongside its native tools. Hands-on tutorial using LangGraph.Building Agents

Proxy Kapa MCP from your MCP· 15mAlready have an MCP server? Add Kapa’s knowledge search to it by proxying a Kapa Hosted MCP server, so your users install one MCP server and get both your native tools and documentation context.MCP

Use in ChatGPT & Claude· 10mConnect your internal Kapa MCP server to ChatGPT or Claude so your team can access company knowledge directly inside their AI assistant.MCP

Tuning knowledge base search for your agent· 10mPractical guidance on tuning retrieval size, context management, and prompting for uncertainty and citations when adding Kapa retrieval to your agent.Building Agents

Writing documentation for AI· 8mBest practices for creating documentation that works effectively for both human readers and AI systems.Improving Kapa

Build an embedded chat experience· 10mCreate a full-page chat interface with streaming responses, source attribution, and user feedback.Chat SDK

Widget integration best practices· 5mLearn proven patterns for integrating the Kapa widget effectively on your documentation site.Website Widget

Style the widget like a customer help chat· 5mConfigure the widget to appear open by default at the bottom of your page, so the assistant is immediately visible on support and documentation sites.Website Widget

Style the widget as a sidebar· 5mConfigure the widget as a persistent full-height sidebar, ideal for documentation sites where the assistant should always be visible.Website Widget

Integrate Kapa into Algolia search bar· 10mAdd Ask AI to your Algolia search interface so users can search your content and ask Kapa questions from the same place.Website Widget

Troubleshooting Kapa's answers· 5mDiagnose and fix issues when Kapa provides incorrect or incomplete answers.Improving Kapa

How to write good custom tags· 5mBest practices for writing custom tag descriptions that maximize classification accuracy.Analytics