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

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

How to Properly Evaluate a RAG-Based AI Agent· 12mRun vendor evaluations that mean something. A methodology inspired by what we do internally, using structured test sets scored by LLM-as-a-judge.Research

Why We Built Our Own PDF Converter Benchmark· 15mWe evaluated leading PDF converters across heading hierarchy, table extraction, figure detection, and text fidelity to find the best fit for our ingestion pipeline.Research