Viindoo AI - Natural Language Search
Users no longer have to click through multiple filter drop-downs to find
records. They just describe what they are looking for in plain language
("revenue by sales rep in March", "unpaid invoices over 10 million",
"contacts in Hanoi") and Viindoo AI translates the phrase into a safe Odoo
search filter, respecting the user's own permissions.
What it does
Adds an "Ask in plain language" button to every searchbar in the backend.
When the user clicks it (or opens the popup via Ctrl+K), they type a
sentence. Under the hood:
- The question is sent to the configured AI model along with a few-shot
prompt example.
- The AI returns a structured Odoo domain (the same filter language used
internally by Odoo search views).
- A validator re-checks every leaf of the domain against the user's
permissions: can they read this model? this field? does the operator
make sense?
- If the domain is safe, it is applied to the current list view. If
anything fails, the search falls back to a standard full-text match so
the user still sees results.
Key Features
- No prompt engineering needed - users type sentences the way they
think. No need to learn boolean syntax or field names.
- Safe by construction - the validator walks the generated domain and
rejects anything that would bypass record rules or field-level
permissions. A user cannot accidentally (or deliberately) craft a filter
that leaks data they are not allowed to see.
- Graceful fallback - when the AI is unsure or returns an invalid
domain, the module silently falls back to Odoo's built-in full-text
search, showing a friendly note to the user.
- Tunable without code - the few-shot examples that steer the AI's
output are stored in a viin.ai.topic record named nl_search.
Admins edit the examples directly in the UI to improve accuracy for
industry-specific vocabulary (e.g. Vietnamese legal terms, regional
customer names).
Supported Editions
- Community Edition
- Enterprise Edition
Requires viin_ai_agent. Auto-installed when the assistant layer is
present.
This software and associated files (the "Software") may only be
used
(executed, modified, executed after modifications) if you have
purchased a
valid license from the authors, typically via Odoo Apps,
or if you
have
received a written agreement from the authors of the
Software (see the
COPYRIGHT file).
You may develop Odoo modules that use the Software as a library
(typically
by depending on it, importing it and using its
resources), but
without
copying any source code or material from the
Software. You may distribute
those modules under the license of your
choice, provided that this
license
is compatible with the terms of
the Odoo Proprietary License (For
example:
LGPL, MIT, or proprietary
licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell
copies of the
Software or modified copies of the Software.
The above copyright notice and this permission notice must be
included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT
SHALL THE
AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING
FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE
SOFTWARE.