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 undo reverts a complete turn at once.