The chat window¶
The chat window is where you talk to Kanzi AI Assistant. Open it from AI Assistant > Chat Window in the Kanzi Studio menu bar. This page describes the controls in the window and the two ways Kanzi AI Assistant can work — Build mode and Plan mode.
For a first walk-through of sending a message, see Your first chat.
The input area¶
Along the bottom of the window you type your request and control the assistant:
Message box — type your request here. The box grows as you type; press Enter to send.
Send (
➤) — sends your message. While Kanzi AI Assistant is working, a Stop (⏹) button replaces it and halts the current run, preserving any partial response.Mode toggle — switches between Build and Plan mode (see below). The button shows the mode you switch to: Plan while you are in Build, Build while you are in Plan.
Settings (
⚙) — opens the Settings window.Performance Analysis (
📊) — opens the performance analysis view.
Above the message box, suggestion chips offer example requests you can send with a click.
Build and Plan mode¶
Kanzi AI Assistant works in one of two modes, which you switch with the mode toggle in the input area:
Build mode (the default) — Kanzi AI Assistant can both inspect and change your project. It runs your request end to end, calling whatever tools it needs.
Plan mode — Kanzi AI Assistant can only explore and read your project; it cannot change anything. It uses this to investigate a complex request and design a solution before touching the project.
Switching mode cancels any run in progress and posts a note in the chat explaining the switch.
Working with a plan¶
In Plan mode, once Kanzi AI Assistant has finished exploring and has designed a solution, it presents a plan for your approval directly in the chat:
The plan shows a summary and an editable list of steps. You can edit any step’s text before approving; a pencil (
✎) marks the steps that change the project.Click Approve (
✅) to accept the plan. Kanzi AI Assistant captures any edits you made, switches to Build mode automatically, and executes the plan.Click Reject (
❌) to send it back; Kanzi AI Assistant revises the plan and presents it again.
You can also open the full plan in a separate Plan Document window for easier reading.
While a plan runs, the assistant message shows an execution checklist with a status icon for each step (pending, in progress, completed, or failed). If a plan stops before it finishes, a Continue plan button resumes it.
Importing 3D models¶
You can bring 3D models into your project by dragging a file onto the chat window — .glb, .gltf, .fbx, .dae, or .obj. Kanzi AI Assistant imports the model and sets up the scene around it. For the full Blender workflow — lights, materials, camera, and environment — see Importing from Blender.
Conversation history¶
Kanzi AI Assistant keeps your conversations as separate sessions:
The conversation history sidebar (toggled with the
☰button) lists your past sessions. Click a session to switch to it, or the✕on a session to delete it.+ New chat starts a fresh session.
Reviewing what the assistant did¶
With Show detailed communication enabled in Settings, each assistant message includes the tool actions Kanzi AI Assistant took, so you can follow its work step by step.
Hover over a message to Copy it; assistant messages also offer Retry.
Kanzi AI Assistant groups every turn into a single Kanzi Studio undo entry, so
undoreverts a complete turn at once.