---
app: erp
audience:
  - owner
  - staff
  - admin
ui_only: false
agent_actions: []
agent_examples:
  - how do I connect an AI to the Desk?
  - can I set up the AI assistant without an API key?
  - which AI does the Bakulai assistant use?
  - can the AI save or submit documents for me?
  - can the AI show me where a button is?
  - what data goes to the AI provider?
llm_weight: promote
title: The AI assistant in the Desk
description: Set up the AI assistant in a minute — log in with OpenRouter or
  paste a key from OpenAI, Claude or Gemini — then let it read the page you are
  on, fill forms and do the work, asking before anything changes.
editUrl: true
head: []
template: doc
sidebar:
  order: 1
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

import { Steps, Aside } from "@astrojs/starlight/components";
import WhatYouCanAsk from "@partials/what-you-can-ask.mdx";

**Who this is for:** anyone working in erp.bakulai.com. Connecting the AI is a job for the company's **Tenant Admin**.

The AI panel opens beside the page you are working on (**Cmd/Ctrl+Shift+A**, or the assistant icon in the top bar). Bakulai does not ship an AI model of its own: the panel answers with the AI **your company connects**. No connection, no AI.

## Connect an AI (Tenant Admin)

<Steps>

1. Open the panel. Until an AI is connected it shows **Set up your AI assistant** — press **Start setup**.

2. Choose how to connect:
   - **Log in with OpenRouter** (recommended, one click) — one account for Claude, GPT, Gemini and more, no key to copy. A window opens: log in to OpenRouter (or create a free account) and press **Authorize**.
   - **Use an API key** — if you already have a key from OpenAI (ChatGPT), Anthropic (Claude) or Google (Gemini). Paste it: the panel recognises which provider it belongs to and has a button to that provider's key page. A ChatGPT Plus or Claude Pro subscription does not include API use; the provider bills the key separately.
   - **Sign in with ChatGPT** shows *Coming soon*: OpenAI has to approve Bakulai first. Until then, use OpenRouter or an OpenAI key.
   - **Advanced: connect an OpenAI-compatible server** — for a model you host yourself (https, with tool calling).

3. Tick **I agree to send … data to …** after reading what leaves Bakulai (see [What leaves Bakulai](#what-leaves-bakulai)), then press **Continue with OpenRouter** or **Connect**.

4. Bakulai picks a model that works well for most businesses (Claude Sonnet class, marked **Recommended**) — you do not have to choose. The last screen says **Your AI assistant is ready**; press **Start chatting**.

</Steps>

Everyone in the company uses this one connection. Other users see **Your AI assistant isn't set up yet** until a Tenant Admin finishes the setup.

Later, the gear icon in the panel header opens **Settings**: a short list (**AI connection**, **Preferences**, **Saved prompts**, **Connected agents**), each row saying where it stands now, each opening its own page with **Back** to the list. **AI connection** shows what is connected and lets you **Change model** (the suggested models come first: **Recommended**, **Most capable**), open **Advanced** (reasoning, showing the thought process, image attachments), **Check connection**, **Change AI account** or **Disconnect**. Changing the model saves at once, without asking for the confirmation again — the data still goes to the same provider.

<Aside type="note" title="Who pays for the AI">
  Usage is billed by the provider to the key or account you connected — there is no Bakulai AI quota for it. A new OpenRouter account has no credit: the setup shows **Add credit to start** with a link to OpenRouter, then **Check again**. Claude Opus 5.5, Opus 5, Fable 5.1 and Sonnet 5.5 may retry a refused request on another Claude model; that retry is billed to the same key.
</Aside>

## What it can do on the page

- **Read the page you have open** — a form and its values, a list, a report — so "explain this invoice" or "why is this field red?" works without naming the document.
- **Fill in forms**, add or change table rows, and open documents, lists and reports with filters. Filling a form never saves it.
- **Save, submit and cancel** by pressing the Desk's own buttons, with the same confirmations you would see.
- **Show me how** — ask "how do I make a credit note for this invoice?" and the AI shows you on your own screen. It opens the right page and highlights each field or button in turn while it explains the step in the chat. A button inside a menu such as **Create** highlights the menu, and the AI tells you which item to pick. Highlighting never presses anything; the AI only does the step itself when you ask it to.
- **Explain this** — highlight text on a page and press the floating button: the selection is placed in the message box. Nothing is sent until you press Send.
- **Fill from a receipt** — on a new Purchase Invoice or Expense Claim (or their lists), pick a photo or PDF of the bill: Bakulai reads it, the request is written into the message box, and after you press Send the assistant fills a **draft** for you to check. It never saves on its own.
- **Suggestions for this page** — under the page name above the message box, up to three buttons fit what you have open: *Fix this error* after a red error, *Ask about 3 selected* when rows are ticked in a list, *Help me fill this in* on a new form, *Check before submitting* on a draft, *Summarize this report* on a report. A button only writes the question into the message box — change it or press Send. They step aside while you are typing.
- **Ask AI about selected** — tick rows in a list, open **Actions**, and pick *Ask AI about selected*: the panel opens with the selected records in the message box.
- **Ask AI from the search bar** — type a question in the search bar (Ctrl/Cmd+K) and pick *Ask AI: …* under *Search for…*: the panel opens with your question in the message box. Press Enter on its own and the search bar still searches as before.
- Answer from your data: sales, stock, receivables, reports.
- **Dictate** — press the microphone in the message box and speak; your words appear in the message box, in Bahasa Indonesia or English (gear icon → **Preferences**). Press Send yourself. The button only appears in browsers that can turn speech into text (Chrome, Edge, Safari — not Firefox, not the desktop app), and listening stops when you close the panel.

## Approval before changes

- Before the AI creates or changes anything, an **approval card** shows what it is about to do; **Show details** lists the values. Press **Approve** or **Decline**.
- **Submitting, cancelling and deleting always ask**, whatever your settings. Those cards are marked *Can't be undone easily*.
- Several calls of the same kind arrive as one card: **Approve all**, **Decline all**, or **Approve only the first**.
- **Ask before changes** (gear icon → **Preferences**) can be turned off: creating and editing then run without a card, **in this browser only**. Ticking *Don't ask again for changes in this browser* on a card does the same. Submitting, cancelling and deleting still ask.

## Saved prompts

Questions you ask often can be saved and picked again with one click — on the welcome screen of a new chat, or under the **bookmark** button in the message box.

- **For everyone in the company** — prompts a Tenant Admin keeps for all members. Members can use them but not change them.
- **Just for you** — your own prompts in this company. Nobody else sees them.
- Add or edit them under the gear icon → **Saved prompts**, or hover one of your sent messages and press **Save as prompt**.
- Picking a prompt only writes it into the message box. Change it if you like, then press Send.
- `{today}`, `{company}` and `{doc}` in a prompt are filled in when you pick it: today's date, the company's name, and the document you have open (or "this page").

## Marked on the document

Every document the AI creates, changes, submits or cancels gets one line on its timeline, for example *Budi created this via the AI assistant (Anthropic (Claude) · claude-sonnet-5-5)*. The name is your company's AI connection, or the agent's own name for [connected agents](#connected-agents) such as Claude or ChatGPT. The line is written together with the change, so a change that fails leaves no line.

The same goes for what the AI does on the page you have open — saving, submitting, cancelling or a workflow action — and for a form the AI filled that you then saved yourself: *Budi saved this with fields filled in by the AI assistant (…)*.

Not marked: comments and assignments the AI adds (they already show who added them), other form buttons, and a form an agent filled through the [Desk connector](#connected-agents) that you saved yourself.

## What you can ask

<WhatYouCanAsk />

## By plan

| | Gratis | Kasir | Pro | Max |
|---|---|---|---|---|
| AI panel on your own AI connection | ✓ | ✓ | ✓ | ✓ |
| Read data, read and fill forms | ✓ | ✓ | ✓ | ✓ |
| Save, create and change data (with approval) | — | ✓ | ✓ | ✓ |
| Attachments: PDFs and photos (images go to the model as they are if it reads images) | — | — | ✓ | ✓ |
| [Connector for Claude, ChatGPT and other MCP agents](/integrations/) | — | — | ✓ | ✓ |
| [Other MCP servers](#mcp-servers) (Stripe, Zapier, …) for the assistant | — | — | ✓ | ✓ |

On **Gratis** the assistant reads your data and fills a form for you, but cannot save or create anything — you press Save yourself. Ask it to create something and it says so first, then opens the filled form for you to save, one document at a time. A change the plan does not allow shows a **Not included in your plan** card with **See plans**.

## What leaves Bakulai

While a connection is active, these go to the provider your company chose, under **its** terms (through OpenRouter, also to the company that makes the model in use):

- the conversation;
- the results of tools run for your company;
- the Desk page you have open;
- the list of tools;
- the user's name and the company name;
- with [MCP servers](#mcp-servers) connected: what the assistant puts in a call to that service goes to the service, under its terms;
- the **text** Bakulai read from an attached PDF or photo. The file itself stays in your company's files on Bakulai (it counts toward your storage), and removing it from the message box does not delete it.

**Dictation** is separate: your browser's own speech service turns the audio into text (Chrome sends it to Google, Safari to Apple), and only the resulting text joins the conversation. The audio never goes through Bakulai.

The key is sent once from the setup, stored **encrypted** on Bakulai's servers and never shown again — not even to the Tenant Admin. Moving to another provider or server means typing a key again and confirming again.

## Conversation history

Conversations are kept per user and per company. The **Conversations** icon in the panel header lists them: open one to continue, or delete it. **New chat** starts a fresh one.

## Connected agents

Gear icon → **Connected agents** is the one place to manage them: the Claude, ChatGPT or other MCP agents connected to *your* account, a **Disconnect** button for each, and **Connect a new agent** with the server URL and the commands for Claude Code and Gemini CLI. Your avatar → **Connect AI Agent** opens the panel straight on this page, even before an AI is connected. The list and **Disconnect** work on every plan; connecting a new agent needs Pro or Max. See [Disconnect an agent](/integrations/disconnect/). What these agents create or change is [marked on the document](#marked-on-the-document) with their name.

**Connect a new agent** also lists an optional second URL, *Bakulai Desk*, for agents on this computer that should work on the page you have open. The switch **Let them use your Desk** decides whether they may (on by default; every save asks you with **Allow** / **Decline**). See [Let agents use your Desk](/integrations/#let-agents-use-your-desk).

## MCP servers

Gear icon → **MCP servers** lists what the assistant can reach:

- **Built in** — *Bakulai ERP* and *Bakulai Desk*, always installed; they cannot be uninstalled. To use them from Claude or ChatGPT, see [Connected agents](#connected-agents).
- **Connected** — other services a Tenant Admin added. Open one to see its tools and whether each **runs at once**, **asks first** or **always asks**; switch it off, refresh its tools, give it a new token, or uninstall it.

To add one (Tenant Admin, Pro or Max): pick a service from the list — Stripe, Zapier, Linear, Apify, Exa, Tavily, Firecrawl, GitHub, Supabase, Context7, Hugging Face, Cloudflare — paste its token and confirm that your company's data may go there; or choose **Another server (URL)** for any remote MCP server that accepts a token. Services that need a sign-in (OAuth), such as Notion or HubSpot, are not supported yet.

- A change applies to **new conversations**: a conversation keeps the servers it started with.
- What the assistant gets back from a service is treated as data, not as instructions. Anything that changes something there waits for your approval unless the service marked that tool as read-only.
- The token is stored encrypted on Bakulai's servers and never shown again. Switching off and uninstalling work on every plan.

## Import many rows

The panel takes images, not spreadsheets. To bring in a product, price or customer list from Excel or CSV, use [Move in from another app](/erp/migration/overview/): upload the files there and press **Ask the AI Assistant**, and this panel proposes the mapping in a migration conversation, on every plan ([Connect your AI](/erp/migration/connect-ai/)). On Pro and Max a photo or screenshot of a table can be attached in the panel and imported: the rows are validated on the server and nothing is written until you approve.

## Limits & safety

- The assistant acts as **you**: it sees only what your roles allow, only in the active company.
- It never changes your account, your subscription or the AI connection.
- Answers do not load remote images; links to Desk pages open inside the Desk.

## Troubleshooting

- **"Your AI assistant isn't set up yet"** — ask a Tenant Admin to open the panel and press **Start setup**.
- **The OpenRouter login window does not open** — the panel shows a link instead; or allow pop-ups for erp.bakulai.com and try again.
- **"Add credit to start"** or **"does not have enough credit"** — add credit with the AI provider (for OpenRouter: openrouter.ai, Settings → Credits), then **Check again**.
- **"… did not accept this key"** — copy the key again, all of it; a key from one provider does not work at another.
- **"Not included in your plan"** card on a change — your plan lets the AI read and fill forms but not save; press **See plans**, or save the filled form yourself. See [Plans](/erp/plans/plans-free-kasir-pro-max/).
- **The model talks but never acts** — go back to the **Recommended** model under **Change model**; small models get lost among the assistant's tools.
- **"Explain this" does not appear** — the selection is inside an input field; select rendered text instead.

## Related

[Integrations](/integrations/) · [Plans](/erp/plans/plans-free-kasir-pro-max/) · [Move in from another app](/erp/migration/overview/)