Chatting and attachments
On this page
- The parts of the BORO panel
- How to ask BORO something
- What you see in an answer
- While BORO is working
- How to let BORO see your screen
- How to attach files
- How to dictate a message
- Several conversations at once
- How to find or delete an earlier conversation
- When to start a new conversation
- Choosing the model
- Messages you may see
- Common questions
- Related
| Where | Top bar → BORO → the BORO panel (any company or project screen). History: the clock button History (История) in the panel header. |
|---|---|
| Who can | Every member of the selected company, on every plan. Each message uses the company's credits. Files you attach from the file manager need at least View on them. |
| Related | BORO — AI assistant, What BORO can do, Approvals and background tasks, Settings, models and credits |
The parts of the BORO panel
| Part | Label (EN / BG) | What it does |
|---|---|---|
| Header | BORO, "AI assistant · {project or company}" | Shows which project or company BORO is working in. While more than one conversation is running, the header shows "{n} running" (работят). |
| + button | New conversation / Нов разговор | Starts an empty conversation. The previous one stays in the history. |
| Clock button | History / История | Opens the list of your conversations, New conversation and Tasks (Задачи, background tasks). |
| Gear button | Settings / Настройки | Opens BORO Settings (Настройки на BORO). See Settings, models and credits. |
| X button | Close / Затвори | Closes the panel. Running conversations keep working. |
| Conversation area | Your messages on the right, BORO's answers on the left, with tool rows, approval cards and question cards. A new conversation shows BORO with three topics (offers by BoQ, budget and overruns, schedule and deadlines) and the hint "Ask about your projects, BoQs, offers or schedule — or give BORO a task." | |
| Message field | Message BORO… / Съобщение до BORO… | Where you type. Enter sends, Shift+Enter starts a new line. |
| + menu in the field | Add / Добави | Attach a file from your computer, Attach a file from the file manager, Skills (Умения), External connections (Външни връзки). |
| Microphone | Dictate (Ctrl+M) / Диктувай (Ctrl+M) | Speech to text into the field. Shown only where dictation is available. |
| Arrow / square button | Send / Изпрати; Stop / Спри | Sends the message; while BORO works it becomes Stop. |
| Model chip | Auto / Авто | The AI model BORO uses. You can change it only if your company may choose models. |
| Credit chip | lightning icon, "{balance} credits" | The company's credit balance. Click it to open the Credits (Кредити) sheet: the balance with Top up credits (Зареди кредити), the split "Included: {included} · Purchased: {topup}", and Credit movements (Движение на кредитите) grouped by day. |
| Ring | "{pct}% of context used" | How full the conversation is. See "When to start a new conversation" below. |
| Eye button | Share current screen with BORO / Споделете текущия екран с BORO | Lets BORO see the screen you are on. On by default. |
- Your message, shown on the right.
- The tool rows: what BORO looked up or did, here "Listing your projects". Click a row to see its result.
- BORO's answer, here with a table.
- The line under the answer: Read aloud and the credits the reply cost, here "−2,2 credits".
- The message field Message BORO… with the Add (+) menu.
- The credit chip with the company's balance.
- The eye button Share current screen with BORO and the context ring.
How to ask BORO something
- Open the screen you want to talk about, for example the BoQ, the offer request or the schedule.
- Click BORO in the top bar. To start on a fresh topic, click New conversation (+) in the panel header.
- Type your request in Message BORO… and press Enter (or click Send). Use Shift+Enter for a new line.
- Watch the answer arrive. While BORO thinks you see "Thinking…" (Мисли…); tool rows appear as BORO works ("Running actions…", Изпълнявам действия…).
- If BORO proposes a change, a card Requires approval appears; if it needs a decision, a card Question from BORO appears. Answer them to let BORO continue. See Approvals and background tasks.
What you see in an answer
- Reasoning. For harder questions BORO thinks first. While it thinks you see "Thinking…"; afterwards View reasoning (Виж разсъждението) opens what it considered.
- Tool rows. Each tool call is a row with an icon and a title, for example "Fetch BOQs", "Resource analysis", "Web search" (Търсене в интернет), "Read web page" (Чета уеб страница) or "Analysing with Python" (Анализирам с Python). Several calls at once show "{n} in parallel". Quiet rows such as "Using skill: {name}" (Използвам умение) or "Loading tools: …" (Зареждам инструменти) show BORO preparing. Click a row to see the arguments and result.
- Text, tables and diagrams. Answers use headings, lists and tables. Flowcharts and other diagrams are drawn with Mermaid; if one cannot be drawn you see "This diagram couldn't be displayed." with Show diagram source (Покажи кода на диаграмата).
- Files. A file BORO creates or edits appears as a card with Open (Отвори) and Download (Изтегли), marked "edited" or "version {n}" when it is a new version. Exports such as an Excel BoQ come as a download link.
- Sources. Answers from the web list their sources (title and link). Answers about how BuildColab works link to the page of this guide.
- The meta line. Under a finished answer: Read aloud (Прочети на глас), the model's name when your company shows it, and the cost, for example "−0.8 credits". The cost is an estimate when marked so ("Estimate — the exact charge is in the credit ledger"); the exact charge is in the credit movements. After a reply a short notice "BORO used {n} credits" can also appear.
- Navigation. BORO can open a screen for you ("open the offer requests of this project"). If you did not ask to be taken somewhere, it asks first.
While BORO is working
- Queue a message. Type and press Enter while BORO is answering: the message is queued ("Queued", На опашка) and sent when BORO finishes. The hint reads "BORO is working — press Enter to queue, or Stop." Click the lightning button Send now (Изпрати сега) to send a queued message at once, or the X to remove it.
- Stop. Click the square Stop (Спри) button. BORO stops and the part of the answer already written is kept.
- Leave and come back. BORO keeps working on the server when you close the panel, switch conversations, reload the page or lose the connection. If the connection drops you see "Connection interrupted — BORO keeps working in the background; the reply will appear here shortly." When you return, "BORO is working…" (BORO работи…) shows until the reply is there.
- Jump to the end. If you scrolled up, Latest (Към последното) takes you back to the newest message.
How to let BORO see your screen
The eye button under the message field controls Share current screen with BORO (Споделете текущия екран с BORO). When it is on (the default; tooltip "BORO sees the current screen — click to turn off"), each message carries a short description of the screen you are on: the page, its title, and the main data loaded on it with their identifiers. BORO uses this when you say "this", "here" or "the open offer", and then reads the full details with its tools. When it is off, BORO knows nothing about your screen and asks you, or looks things up by name. Your choice is remembered in this browser.
How to attach files
Attach files when BORO needs to read or use a document: a supplier price list, a measurement protocol for a payment application, an Excel BoQ to import, a drawing or a photo from the site.
- Click Add (+) in the message field.
- Choose Attach a file from your computer (Прикачи файл от компютър) and pick up to 8 files, or Attach a file from the file manager (Прикачи файл от файловия мениджър), tick the files in the dialog and click Attach (Прикачи). The file manager dialog shows the files of the current project, or of the company when no project is open.
- The files appear as chips above the field; "Processing…" (Обработка…) shows while a file is read. Remove one with its X.
- Type your request and send.
- The Add (+) button in the message field.
- Attach a file from your computer.
- Attach a file from the file manager.
- Skills and External connections lead to those settings.
Other ways: drag files from your computer onto the panel ("Drop files here", Пуснете файловете тук), drag a file row from the file manager list onto the chat, or paste an image with Ctrl+V (Cmd+V on Mac).
| Rule | Value |
|---|---|
| Files per message | Up to 8 ("Maximum 8 files at once") |
| Size per file | Up to 25 MB ("file is too large (max 25 MB)") |
| Accepted from your computer | Images (any image type), PDF, Excel (.xlsx, .xls), Word (.docx), CSV, TXT, Markdown (.md), JSON, LOG, YAML (.yml, .yaml), XML. Other types: "unsupported file type". |
| Images | Reduced to at most 1,536 pixels on the long side before sending. |
| Long documents | The text read from a document is cut after about 120,000 characters and marked "truncated" (съкратено). |
| From the file manager | Sent as a reference, not uploaded again. BuildColab reads the file on the server with your access rights; if you cannot open the file, BORO cannot either. |
For documents such as an Excel BoQ or a PDF, BuildColab keeps the real file for the conversation as well as its text, so BORO can import the actual workbook into a BoQ instead of retyping it. Attached files are not saved to your file manager unless you ask BORO to save them.
How to dictate a message
Where dictation is available, a microphone button appears in the message field.
- Click the microphone, or press Ctrl+M in the message field. The first time, allow microphone access in the browser. "Starting the microphone…" then "Listening…" (Слушам…) appear.
- Speak. Dictation detects Bulgarian, English and German by itself. The text appears in the field.
- Click the microphone again (Stop dictation) to finish, or press Esc (Cancel dictation) to discard. Dictation stops by itself after 5 minutes ("Dictation stopped after 5 minutes.").
- Check the text and send it. If you press Send while dictating, BORO also reads its reply aloud.
In BORO Settings → Voice (Глас) you can turn on Send automatically after dictation and Read replies aloud after dictation. These settings apply to your browser only. Any finished answer can be read aloud with Read aloud; stop it with Stop reading.
| Message | What to do |
|---|---|
| "Microphone access is blocked. Allow it from the lock icon in the address bar (Site settings → Microphone), then try again." | Allow the microphone for BuildColab in the browser and try again. |
| "No microphone was found. Connect one and try again." | Connect a microphone or headset. |
| "The microphone is in use by another app or tab. Close it there and try again." | Close the call or recording app that uses it. |
| "Too many dictations in a short time. Wait a few minutes and try again." | Wait a few minutes. |
| "The recording could not be recognised. Please try again." | Speak again, closer to the microphone. |
Several conversations at once
You can keep up to three conversations working at the same time, for example one pricing a BoQ and another comparing offers. Start the second one with New conversation while the first is still working. In History, a running conversation shows a spinner, and one that waits for your approval or answer shows a dot ("Waiting for you", Чака вас). When a conversation you are not looking at finishes or needs you, a notice appears: "BORO finished: {title}", "BORO is waiting for approval: {title}" or "BORO is waiting for your answer: {title}", with Open. If you try to start a fourth, BORO shows "3 chats are already running. Wait for one to finish or stop one, then send again."
How to find or delete an earlier conversation
- Click History (the clock) in the panel header. The list Conversation history (История на разговорите) shows each conversation's title and date, newest first. The open one has a check mark. "No conversations yet." means you have none.
- Click a conversation to reopen it with all its messages.
- To delete one, point at it, click the bin Delete conversation (Изтрий разговора), then confirm with Delete (Изтрий) at "Delete?". The conversation disappears from your history; you cannot bring it back. Deleting is not offered on a phone.
Conversations are personal: colleagues do not see your BORO conversations. Credits used in a deleted conversation stay charged.
- New conversation starts an empty chat.
- Tasks opens the background tasks.
- The list Conversation history with title and date.
- The bin Delete conversation appears when you point at a row.
When to start a new conversation
Everything in a conversation is sent to the AI model again with each message, so a long conversation costs more and BORO's answers can get less precise. The ring next to the eye button shows "{pct}% of context used" (от контекста е използван); point at it to see the split between System prompt, Tools, Memory, Messages, Response and Free. Start a New conversation for each new topic, and when the ring is getting full. Facts that should carry over belong in Memory.
Choosing the model
The chip under the message field shows the model BORO uses. Auto (Авто) lets BORO pick the model for each task: a fast model for everyday work and a stronger one for heavy analysis. If your company is allowed to choose models, click the chip to pick another model for this conversation; the descriptions say which is faster and which costs more. If you cannot click it, your company uses Auto. See Settings, models and credits.
Messages you may see
| Message | Meaning and what to do |
|---|---|
| "Credits exhausted" / "BORO cannot reply without credits. Top up or upgrade your plan." | The company's balance is zero. Use Top up credits or Upgrade plan. See Credits (BORO, file processing). |
| "The monthly AI credit limit for this company is reached. An administrator can raise it in the AI settings." | Your company set a monthly limit in BORO Settings → Governance and it is used up. |
| "Rate limit reached: at most {n} messages per minute. Please wait a moment." | You sent more messages per minute than your company allows. Wait a minute. |
| "The AI assistant is disabled for this company." | BORO was switched off in BORO Settings → Governance. |
| "BORO can't help with this request. Try rephrasing it or ask about something else." | The AI model refused the request. Rephrase it. |
| "An error occurred in the response." | Something failed while answering. Send the message again. |
| "Failed to load conversation." | The conversation could not be opened. Reload the page and try again. |
| "No model configured yet. Open Settings to add an API key." | No AI model is available for your company. Contact BuildColab support or your administrator. |
| "3 chats are already running. Wait for one to finish or stop one, then send again." | Three conversations are working. Wait or stop one. |
Common questions
Does BORO see everything on my screen?
Only when the eye button Share current screen with BORO is on, and then only a short description of the page and the data it loaded, not a picture. BORO reads full details with its tools, within your permissions.
Can colleagues read my BORO conversations?
No. Conversations are personal. What BORO changes in BuildColab (a new position, a task) is visible to everyone who can see that data, as if you made the change.
I closed the browser while BORO was working. Is the answer lost?
No. BORO keeps working on the server. Open BORO again and pick the conversation in History; the answer appears there. An approval card that is not answered within 5 minutes expires, and BORO continues without that change.
Why does BORO say "file is too large (max 25 MB)"?
Chat attachments are limited to 25 MB per file. Upload large files to the file manager first, then attach them from there with Attach a file from the file manager, or ask BORO to read them by name.
Which file types can I attach?
Images, PDF, Excel (.xlsx, .xls), Word (.docx), CSV, TXT, Markdown, JSON, LOG, YAML and XML from your computer. From the file manager, BORO can read most office documents, PDFs, images and 3D/CAD models that were processed.
Are the files I attach saved in the file manager?
No. They stay with the conversation. Ask BORO to save or import them if you want them in BuildColab.
Why did a reply cost more credits than the previous one?
The cost grows with the conversation length, attachments, data BORO looked up and the model. Start a new conversation for a new topic. See Credits (BORO, file processing).