Add Kai - AI Assistant section to navigation and main AI page by jordanrburger · Pull Request #855 · keboola/connection-docs

jordanrburger · 2025-12-16T16:22:38Z

Add Comprehensive Kai AI Assistant Documentation

Overview:
Added complete documentation structure for Kai, Keboola's embedded AI assistant, splitting content into focused, user-friendly sections.

Documentation Pages:

/kai/ - Main overview and introduction
- /kai/getting-started/ - Access requirements and first steps
- /kai/use-cases/ - Detailed examples and practical applications
- /kai/best-practices/ - Effective prompting and workflow guidance
- /kai/technical/ - Architecture, security, and deployment details
  Key Features:
User-focused structure: Organized by user journey from introduction to advanced usage
- Practical examples: Real prompts and workflows for common data engineering tasks
- Clear differentiation: Explains relationship between Kai and MCP Server
- Security emphasis: Covers governance, audit trails, and data protection
- Navigation integration: Added hierarchical menu structure under AI Features
- Visual assets: Added welcome and capabilities images for documentation
  Updates:
Moved documentation to /kai/ directory structure
- Added rate limits and hotkey documentation
- Added contextual awareness and enablement instructions
- Integrated Kai section into home page AI features

ai/kai-assistant/technical.md

.playwright-mcp/kai-tool-response.png

davidesner · 2026-01-28T15:38:54Z

@jordanrburger I went through the docs locally:

I think we for sure need to add reference to the privacy policy or include a dedicated page like this https://github.com/keboola/connection-docs/pull/856/changes#diff-b504d79105e6b09adfd1804afe56a570a7f3e3cf82e8e3a14bf895a8ff6dd3af. This is imo very important to say loudly-> no training, data residency, compliance.

It would be nice to add the generic video with use cases to the main Kai page

Then this (prompt:) ):

Mention the available hotkeys -> A to open the (recent) chat window , SHIFT + A to open new chat
Update rate limiting: Every user will have 150 turns (user messages) per month per project for free. It resets every calendar month. If they need more they can reach out to support and we will need to deal with them individually (we have the technical option to set the limit per project). PAYG has lower limit of 15 messages per user per month
- Users will see the rate limit usage in the chat UI
Elaborate more on contextual awareness and follow mode. That the agent has also a context of what the users sees in the UI and user can also follow along as the agent works with configurations. Refer to the implementation to understand more (ui repo path)
Expand tips with Don't type secrets in chat. KAI uses secure forms for credentials
Describe how to enable it. It is no longer private beta but public beta:
- Every user will be able to see the Kai button in every project (if the stack has the appropriate feature, effectively excluding STs). It is also possible to enable it through settings -> features
- Only Organization Admins will be able to enable the feature straight from the chat screen. Others will have to reach out to their org admins or our support if unsure.
remove .playwright folder

The Kai Use Cases & Examples would deserve the video (generated). I am not so sure the prompt examples are too useful. I will for sure not copy paste these prompts and it's quite hard to read. At least I would think about the page structure so it looks nicer.

jordanrburger · 2026-01-28T16:18:40Z

@davidesner - Sadly, I think one issue with the videos in the docs is that I don't think we can auto-play them and I'm not sure how easily they can even be embedded.

I agree with all the rest, though. Updating it now.

…sponse types, clarify action approval requirements, and enhance descriptions of capabilities and integration setup.

…ure, security, deployment, and integration details. Update use case example to reflect changes in error message handling for job failures.

… best practices for new users, and streamline troubleshooting guidance. Revise navigation structure to reflect changes in content organization.

…ontextual awareness, and enablement instructions - Update from Private Beta to Public Beta with enablement details - Add keyboard shortcuts (A for recent chat, Shift+A for new chat) - Update rate limits: 150 turns/month (free), 15/month (PAYG) - Add Contextual Awareness & Follow Mode section with implementation details - Add security tip about using secure forms for credentials - Remove .playwright-mcp folder and add to .gitignore Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

davidesner · 2026-01-29T06:16:29Z

@davidesner - Sadly, I think one issue with the videos in the docs is that I don't think we can auto-play them and I'm not sure how easily they can even be embedded.

I agree with all the rest, though. Updating it now.

I usually convert them to gif, that works. Here's an example https://help.keboola.com/ai/mcp-server/

jordanrburger · 2026-01-29T08:59:50Z

I usually convert them to gif, that works. Here's an example https://help.keboola.com/ai/mcp-server/

Yeah, then we just have a ~15 second limit. I'll try to recreate the capabilities video to be a little shorter.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

jordanrburger · 2026-01-29T11:50:55Z

Okay, the .gif has been added. Now, I'm debating whether or not we should include an FAQ page in addition to what we already have.

ai/kai-assistant/getting-started.md

- Relocate Kai docs from ai/kai-assistant/ to kai/ - Update navigation and index references - Clarify rate limits: contracted plans get 150 messages, PAYG gets 50 - Add note that Kai is free during public beta Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

cjayyy · 2026-02-05T12:28:54Z

This is deliberate.

AdamVyborny · 2026-02-05T12:31:19Z

Oh, good point. URL should be: https://help.keboola.com/ai/kai-assistant

AdamVyborny

https://help.keboola.com/ai/kai-assistant

jordanrburger · 2026-02-05T12:34:11Z

Oh, good point. URL should be: https://help.keboola.com/ai/kai-assistant

No, Michal pushed back on this.

AdamVyborny · 2026-02-05T12:34:36Z

Oh nevermind, we changed it yesterday 🤦🏻

cjayyy · 2026-02-05T12:40:39Z

Oh, good point. URL should be: https://help.keboola.com/ai/kai-assistant

No, Michal pushed back on this.

wtf. So we'll have AI section but our main AI feature will not be listed there? 😕

AdamVyborny · 2026-02-05T12:48:42Z

Oh, good point. URL should be: help.keboola.com/ai/kai-assistant

No, Michal pushed back on this.

wtf. So we'll have AI section but our main AI feature will not be listed there? 😕

Yep, that's shame

jordanrburger · 2026-02-05T14:49:05Z

Oh, good point. URL should be: https://help.keboola.com/ai/kai-assistant

No, Michal pushed back on this.

wtf. So we'll have AI section but our main AI feature will not be listed there? 😕

Correct. It's a platform feature, not an AI specific feature.

AdamVyborny · 2026-02-05T14:58:24Z

But there still could be link. People could click on AI section as naturaly they are expecting Kai docs there.

jordanrburger self-assigned this Dec 16, 2025

jordanrburger commented Dec 16, 2025

View reviewed changes

jordanrburger closed this Dec 18, 2025

jordanrburger reopened this Jan 8, 2026

jordanrburger force-pushed the kai-documentation branch from 2632d36 to 7bab72d Compare January 8, 2026 14:34

cjayyy reviewed Jan 19, 2026

View reviewed changes

.playwright-mcp/kai-tool-response.png Outdated Show resolved Hide resolved

jordanrburger marked this pull request as ready for review January 28, 2026 16:31

jordanrburger and others added 5 commits January 28, 2026 17:31

Add Kai - AI Assistant section to navigation and main AI page

ec1b74c

Update Kai assistant documentation: remove unsupported regions and re…

c1b2fa1

…sponse types, clarify action approval requirements, and enhance descriptions of capabilities and integration setup.

Remove technical documentation for Kai assistant, including architect…

68a78d2

…ure, security, deployment, and integration details. Update use case example to reflect changes in error message handling for job failures.

Update Kai assistant documentation: remove outdated sections, enhance…

d7653fd

… best practices for new users, and streamline troubleshooting guidance. Revise navigation structure to reflect changes in content organization.

jordanrburger force-pushed the kai-documentation branch from 8d49a0b to feb6194 Compare January 28, 2026 16:31

jordanrburger and others added 2 commits January 29, 2026 12:35

Add Capabilities GIF to Kai use cases page

4c02ef3

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Add Kai - AI Assistant to home page AI section

9cb21b0

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

davidesner reviewed Jan 30, 2026

View reviewed changes

ai/kai-assistant/getting-started.md Outdated Show resolved Hide resolved

jordanrburger and others added 2 commits February 4, 2026 16:47

Add Kai documentation images

29e6bb8

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

AdamVyborny approved these changes Feb 5, 2026

View reviewed changes

AdamVyborny self-requested a review February 5, 2026 12:30

AdamVyborny requested changes Feb 5, 2026

View reviewed changes

AdamVyborny approved these changes Feb 5, 2026

View reviewed changes

Conversation

jordanrburger commented Dec 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Add Comprehensive Kai AI Assistant Documentation

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

davidesner commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jordanrburger commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

davidesner commented Jan 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jordanrburger commented Jan 29, 2026

Uh oh!

jordanrburger commented Jan 29, 2026

Uh oh!

Uh oh!

cjayyy commented Feb 5, 2026 • edited by jordanrburger Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

AdamVyborny commented Feb 5, 2026

Uh oh!

AdamVyborny left a comment

Choose a reason for hiding this comment

Uh oh!

jordanrburger commented Feb 5, 2026

Uh oh!

AdamVyborny commented Feb 5, 2026

Uh oh!

cjayyy commented Feb 5, 2026

Uh oh!

AdamVyborny commented Feb 5, 2026

Uh oh!

jordanrburger commented Feb 5, 2026

Uh oh!

AdamVyborny commented Feb 5, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

jordanrburger commented Dec 16, 2025 •

edited

Loading

davidesner commented Jan 28, 2026 •

edited

Loading

jordanrburger commented Jan 28, 2026 •

edited

Loading

davidesner commented Jan 29, 2026 •

edited

Loading

cjayyy commented Feb 5, 2026 •

edited by jordanrburger

Loading