AI Assistant

dBSea includes a built-in AI assistant that can answer questions about the software based on the documentation. It is available from the Help menu → dBSea assistant.

Privacy and Data Sharing

The assistant is designed with a privacy-first approach. By default, no project data leaves your computer — only the text of your question is sent.

Default Mode (no project data shared)

When you open the assistant and type a question, only your message text is sent to the AI service. The assistant answers based on the dBSea documentation. It has no knowledge of your project, scenarios, sources, or results.

Project-Aware Mode (opt-in)

If you check “Include current scenario info and tools with my question”, two things happen:

1. A summary of your current scenario is appended to your question. This includes scenario settings, solver configuration, frequency ranges, source positions and levels, and probe positions and levels. This gives the assistant context to answer project-specific questions such as “why is my solve slow?” or “what frequencies am I missing?”.

2. The assistant gains access to tools that can query and modify your project. For example, it may read probe spectra, check frequency settings, or reposition sources and probes. Tools are executed locally on your computer — the assistant requests an action, your desktop app performs it, and only the text result is sent back.

Caution

When project-aware mode is enabled, your scenario data (settings, source/probe positions, levels) is sent to an external AI service. If your project contains sensitive or confidential data, leave the checkbox unchecked and use the assistant for general dBSea questions only.

Summary

	Default mode	Project-aware mode
What is sent	Your question text only	Question + scenario summary
Tools available	None	Yes — can query and modify your project
Project data shared	No	Yes
How to enable	Default	Check the “Include current scenario info and tools” checkbox

The checkbox can be toggled between messages — you can ask a general question without sharing data, then enable project-aware mode for a follow-up that needs project context.

What the Assistant Can Help With

• General dBSea questions — how features work, what settings mean, modelling guidance
• Project-specific advice (project-aware mode) — reviewing your setup, diagnosing issues, suggesting improvements
• Project interaction (project-aware mode) — the assistant can use tools to read project data or make changes such as repositioning sources and probes

Note

The set of available tools is actively being expanded. The assistant will tell you what it can and cannot do when you ask.

Limitations

• The assistant’s knowledge of dBSea is based on the documentation — it may not cover every edge case or very recent changes.
• Responses are AI-generated and should be verified, particularly for quantitative guidance.
• Tool calls are limited to 5 rounds per message to prevent runaway loops.
• Chat history (your messages and the assistant’s responses) is logged for quality improvement purposes.