PRDCT-482: AI section rework (kai/ai) — unified method + live-verify

[Iamfle4ka]

AI section (kai/ai) under the unified section-at-a-time method

Reworks the AI section page-by-page (one section = one PR), following the combined revamp playbook: structure → form → cross-site dedup → live-verify against the running Keboola platform.

What changed (per page)

• ai/index, kai/index — added search/meta descriptions; deduped Kai's "Getting Started" enable steps into a single pointer to /kai/getting-started/.
• kai/getting-started — description; noted the live-verified side panel (Ask Kai input + Suggested actions).
• kai/settings, kai/security-and-privacy, kai/best-practices, kai/python-client, kai/use-cases, ai/ai-kit — added descriptions.
• telemetry-data — fixed a broken inbound link /ai/kai-assistant/ → /kai/.

Live-verified in-product (project 6015)

• ✅ Assistant control in the top nav — labeled "Kai Assistant" (Beta), not "KAI". Corrected the label in getting-started and kai/index.
• ✅ Chat side panel: Ask Kai anything about your project… input, Suggested actions for this project, thumbs up/down feedback, settings gear, conversation switcher.

Flagged for owner review (TODO(human-review) — not confirmable by UI inspection)

• Keyboard shortcuts (A / Ctrl+Shift+A)
• Rate limits (150 turns/mo contracted; 50/mo PAYG) + reset cadence
• Settings gear → two-tab layout, project-settings path, 4,000-char instruction limit
• Retention numbers (30s inference / 14d LangSmith), LangSmith EU region, certification list + Vertex AI HIPAA claim

Verification

• npm run build clean.
• node scripts/audit-phase2.mjs: MISSING IMAGES 0; broken internal links down to 2 (both pre-existing/unrelated: /404, /workspace/table-export).

Draft — do not merge. Owner sign-off needed on the flagged facts.

🤖 Generated with Claude Code

[linear-code]

PRDCT-359

PRDCT-482

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
connection-docs	Ready	Preview	Aug 11, 2026 9:47am

[Iamfle4ka]

Rebased onto main — CONFLICTING → MERGEABLE.

Conflict was telemetry-data.md, on the window.TELEMETRY_DIAGRAM blob. Resolved by taking main's side wholesale, after checking what each side actually changed:

• main (b5702fc4) dropped 11 deprecated tables (50 → 39) and corrected the data model — that is the authoritative version.
• This branch's only change to the file was one table, kbc_mcp_event, where the broken /ai/kai-assistant/ link became /kai/. main already contains that exact fix — the two objects are byte-identical, so nothing of ours was lost.

Verified no /ai/kai-assistant/ reference survives anywhere in the tree. npm run build clean (306 pages), audit-phase2: 0 missing images, no new findings from /ai/ or /kai/.

Note: two edits under src/content/docs/kai/ are sitting uncommitted in my worktree; I left them out of the rebase since they are content changes I did not author.

[Iamfle4ka]

Closing as superseded — the pages this draft reworks have all been rewritten on main since it was cut (2026-08-11):

• kai/getting-started.md, kai/best-practices.md, kai/settings.md — @davidesner's docs(kai): document context files, skill files, and API/CLI management #1085, docs(kai): document chat controls and refresh Getting Started #1106 (chat controls + Getting Started refresh)
• kai/index.md — the Kai GA wave (docs(kai): Kai pricing page — bill per reply, disclose cost basis #1105 pricing and siblings)
• ai/index.md, ai/ai-kit/index.md — Repoint kbagent plugin install to the AI Kit marketplace #1095 (marketplace repoint) owns the AI Kit page; the Semantic Layer addition is PRDCT-502: add Semantic Layer documentation #1103
• The narrower fixes this draft contained were re-cut as standalone PRs where still valid: PRDCT-663: drop the Public Beta wording from the Kai section #1097 (beta wording — pending the GA date), PRDCT-664: fix Kai chat shortcuts and the supported-stacks claim #1098 (shortcuts, re-scoped on top of docs(kai): document chat controls and refresh Getting Started #1106)

Rebasing a 9-commit draft across three rewrites of the same five files isn't worth it (per the repo rule: drafts older than a month get closed rather than carried). Branch PRDCT-359-ai-section is kept for cherry-picking. If the PRDCT-482 unified rework is still wanted, it should be re-cut off current main.

🤖 Generated with Claude Code