keboola · Iamfle4ka · Jul 8, 2026 · Jul 8, 2026 · Jul 8, 2026 · Jul 8, 2026
diff --git a/src/content/docs/ai/ai-kit/index.md b/src/content/docs/ai/ai-kit/index.md
@@ -1,6 +1,7 @@
 ---
 title: AI Kit
 slug: 'ai/ai-kit'
+description: AI Kit — a marketplace of Keboola-aware plugins for AI coding assistants — the developer, component-developer, and data-app-developer plugins, and how to install them.
 ---
 
 

diff --git a/src/content/docs/ai/index.md b/src/content/docs/ai/index.md
@@ -1,6 +1,7 @@
 ---
 title: AI Features
 slug: 'ai'
+description: Keboola's AI features in one place — the Kai assistant, its Python client, AI Kit for coding assistants, the MCP server, component suggestions, AI rules, generated descriptions, and error explanations.
 ---
 
 

diff --git a/src/content/docs/kai/best-practices.md b/src/content/docs/kai/best-practices.md
@@ -1,6 +1,7 @@
 ---
 title: Kai Best Practices
 slug: 'kai/best-practices'
+description: Get better results from Kai — prompt with business context, plan before building, iterate, work in dev branches, and keep credentials out of chat.
 ---
 
 

diff --git a/src/content/docs/kai/getting-started.md b/src/content/docs/kai/getting-started.md
@@ -1,6 +1,7 @@
 ---
 title: Getting Started with Kai
 slug: 'kai/getting-started'
+description: Turn on Kai, open the chat, run your first prompts, approve its actions, and learn context and follow mode, rate limits, and troubleshooting.
 ---
 
 
@@ -19,12 +20,15 @@ Every user can see the Kai button in their project (on supported stacks). To ena
 
 ## Opening Kai
 
-Click the **KAI** button in your project's top navigation bar, or use keyboard shortcuts:
+Click the **Kai Assistant** button in your project's top navigation bar, or use keyboard shortcuts:
 
 | Shortcut | Action |
 |----------|--------|
 | **A** | Open the chat window (shows recent conversation) |
 | **Ctrl + Shift + A** | Open a new chat |
+<!-- TODO(human-review): confirm keyboard shortcuts (A / Ctrl+Shift+A) — not verifiable via UI inspection. -->
+
+The chat opens as a side panel with an **Ask Kai anything about your project…** input and **Suggested actions for this project**.
 
 ![Kai Chat Panel](/kai/kai-welcome.png)
 
@@ -86,6 +90,7 @@ This makes interactions more natural—you can say "analyze this job" while view
 
 **Kai is free during the public beta period.**
 
+<!-- TODO(human-review): confirm rate-limit numbers (150 turns/month contracted; 50/month PAYG) and reset cadence with the Kai product owner. -->
 Each user receives **150 turns (messages) per month per project** on contracted plans. The limit resets at the beginning of each calendar month.
 
 - **Pay-As-You-Go (PAYG) plans** have a lower limit of **50 messages per user per month**

diff --git a/src/content/docs/kai/index.md b/src/content/docs/kai/index.md
@@ -1,6 +1,7 @@
 ---
 title: Kai - AI Assistant
 slug: 'kai'
+description: Kai is Keboola's embedded, context-aware AI data-engineering assistant — what it does, why it's different, how it compares to the MCP server, and how to turn it on.
 ---
 
 
@@ -39,13 +40,7 @@ Kai is Keboola's embedded AI assistant—a context-aware data engineering co-pil
 
 ## Getting Started
 
-Kai is now in **Public Beta** and available to all users. Look for the **KAI** button in your project's navigation bar.
-
-- **Organization Admins** can enable Kai directly from the chat screen
-- **Other users** can request access from their Organization Admin or [contact Keboola Support](mailto:support@keboola.com)
-- You can also enable Kai via **Settings → Features**
-
-[Get Started with Kai →](/kai/getting-started/)
+Kai is in **Public Beta** and available to all users — look for the **Kai Assistant** button in your project's navigation bar. For how to enable it, open the chat, and run your first prompts, see [Getting started with Kai](/kai/getting-started/).
 
 ## Learn More
 

diff --git a/src/content/docs/kai/python-client.md b/src/content/docs/kai/python-client.md
@@ -1,6 +1,7 @@
 ---
 title: Kai Python Client
 slug: 'kai/python-client'
+description: Use the Kai Python client and CLI to call the Kai API programmatically — install, authenticate with a master token, stream responses, and embed Kai in apps.
 ---
 
 

diff --git a/src/content/docs/kai/security-and-privacy.md b/src/content/docs/kai/security-and-privacy.md
@@ -1,6 +1,7 @@
 ---
 title: Security & Privacy
 slug: 'kai/security-and-privacy'
+description: How Kai protects your data — no training use, fast deletion, encryption, regional processing, BYOLLM, access controls, audit trail, and compliance.
 ---
 
 
@@ -11,6 +12,7 @@ Kai is designed with enterprise security in mind. This page explains how your da
 
 **Never used for AI training** — Keboola does not use Kai inputs to train, retrain, or fine-tune models.
 
+<!-- TODO(human-review): confirm retention numbers (30-second inference deletion, 14-day LangSmith log retention) and the LangSmith EU region claim with the Kai product/security owner. -->
 **Automatically deleted:**
 - Inference prompts and responses: Removed from Google within 30 seconds
 - Observability logs (LangSmith, EU region): Deleted after 14 days.
@@ -58,6 +60,7 @@ Contact [support@keboola.com](mailto:support@keboola.com) to discuss BYOLLM opti
 
 ## Compliance
 
+<!-- TODO(human-review): confirm the certification list (SOC 2 Type II, ISO 27001, GDPR, regional residency) and the Vertex AI HIPAA claim with the security/compliance owner. -->
 Kai leverages Keboola's existing security certifications:
 - SOC 2 Type II
 - ISO 27001

diff --git a/src/content/docs/kai/settings.md b/src/content/docs/kai/settings.md
@@ -9,6 +9,8 @@ description: Configure Kai's tool permissions, system instructions, context file
 Kai's settings let you personalize how Kai behaves in your project. Open the Kai chat panel and click the **Settings** icon (gear) to access them. Settings are **per-user and per-project**, so each team member can configure their own preferences independently.
 
 The settings panel has two tabs: **Tool Permissions** and **System Instructions**. Project-wide customization — project-level instructions, [context files](#context-files), and [skill files](#skill-files) — is managed in **Settings → Kai Agent** in the main Keboola navigation (the tab is labeled **Kai Assistant** in projects not yet upgraded to the new Kai engine).
+<!-- TODO(human-review): confirm the "Settings → Features" path for enabling Kai on a project. -->
+
 
 ## Tool Permissions
 

diff --git a/src/content/docs/kai/use-cases.md b/src/content/docs/kai/use-cases.md
@@ -1,6 +1,7 @@
 ---
 title: Kai Use Cases & Examples
 slug: 'kai/use-cases'
+description: Practical example prompts for Kai — troubleshooting, SQL transformations, integration setup, apps, documentation, data exploration, and multi-step pipelines.
 ---