AI CAPABILITIES
Google Gemini Integration
Integrate Google’s Gemini AI to provide advanced capabilities like automatic product data extraction and intelligent inventory assistance through Venibot.
Overview
Gemini integration is optional but highly recommended for enhanced productivity and automation features within the Invenicum ecosystem.
Magic Assistant
Extract product data automatically from URLs (Amazon, eBay, etc.).
Venibot Chatbot
Intelligent inventory assistant for stock queries and reports.
Prerequisites
An active account for AI Studio access.
Permission to generate API keys.
Invenicum account with admin rights.
Step-by-Step Setup
Get Your Gemini API Key
Visit Google AI Studio to generate your credentials.
- • Visit Google AI Studio.
- • Navigate to the API Keys section.
- • Click Create API Key.
- • Copy the key (starts with
AIza…).
Security Warning
Never share your API key publicly or commit it to version control.
Configure Integration in Invenicum
Navigate to Settings → Integrations and find the Google Gemini AI card.
apiKey
string (required)
Your API key from AI Studio. This field is masked.
model
default: “gemini-3-flash-preview”
The Gemini model version to use.
Save and Enable
Once the status shows Connected ✓, proceed to activate features.
General Settings
Go to General Settings and toggle AI Features. This toggle only appears after a successful integration.
Available AI Features
Magic Assistant (URL Extraction)
Automatically extract product information using the /ai/extract endpoint.
- 01. Create or edit an asset and click AI Magic Assistant.
- 02. Paste a product URL (Amazon, eBay, etc.).
- 03. Click Start Magic to auto-fill name, price, and descriptions.
Venibot Chatbot
Communicate with your inventory in natural language.
“What’s in stock?”
“Show me active loans”
“Generate inventory report”
Technical Definition
Integration logic is defined in lib/core/utils/constants.dart:25-42.
IntegrationConfig(
id: ‘gemini’,
name: ‘Google Gemini AI’,
fields: [
ConfigField(id: ‘apiKey’, type: text),
ConfigField(label: ‘Model’, type: text),
],
)
Service implementation: lib/data/services/ai_service.dart:1-53
Troubleshooting
Disconnected Status
Verify your API key in AI Studio. Ensure there are no leading or trailing spaces when pasting the key in Invenicum.
Extraction Fails
Check if the URL is publicly accessible. Some regions or specific site structures may block AI crawlers.
Security Best Practices
Rotate Keys
Periodically rotate keys in Google AI Studio to mitigate risks.
Usage Monitor
Check AI Studio dashboard to detect unauthorized access.
Environment Specific
Use different keys for development and production.
Backend Storage
API keys are stored server-side and never exposed to the client.