1.1. Obtaining a Gemini API Key

To use Gemini AI in Odoo, you'll need to obtain an API key from Google:

1. Visit https://aistudio.google.com/apikey
2. Sign in with your Google account
3. Click on "Create API key" button
4. Copy your API key (keep it secure as it provides access to paid services)

1.2. Configuring Gemini in Odoo

After obtaining your API key, configure it in Odoo:

1. Navigate to Gemini AI → Settings
2. Enter your Gemini API key in the "API Key" field
3. Click "Save" to store your configuration

2.1. Creating a New Configuration

Gemini configurations define how the AI behaves for different use cases:

1. Navigate to Gemini AI → Gemini Configurations
2. Click "Create" to add a new configuration
3. Fill in the following fields:
   • Name: A descriptive name (e.g., "Blog Writer", "Email Assistant")
   • Model Name: Select the Gemini model to use (e.g., Gemini 1.5 Pro, Gemini 2.0 Flash)
   • System Instruction: Define the AI's role and behavior
   • Temperature: Controls randomness (0.0-1.0, higher = more creative)
   • Top P: Controls diversity (0.0-1.0)
   • Top K: Limits vocabulary options
   • Max Output Tokens: Maximum response length
   • Stop Sequences: Optional text that stops generation
   • Is Translation: Enable for translation-specific configurations
   • Description: Optional notes about this configuration's purpose

2.2. Safety Settings

Configure content filtering for each configuration:

1. Go to the "Safety Settings" tab
2. Add safety rules for different harm categories: - Hate Speech - Sexually Explicit - Dangerous Content - Harassment
3. Set appropriate thresholds for each category (Select the threshold for blocking content in this category. Higher sensitivity blocks more)

2.3. Usage Areas

The "Usage Areas" tab is crucial for determining where each Gemini configuration appears:

1. Go to the "Usage Areas" tab
2. Select the Odoo models where this configuration should be available
3. For example:
   • Type "Blog" for blog writing assistance
   • Select "Project" for project/task description generation
   • Select "mail message" for email replies

This setting ensures that when users open the Gemini dialog in specific areas of Odoo, the most relevant configurations appear first.

2.4. Testing Your Configuration

Before using a configuration in production:

1. Click the "Test Gemini" button at the top of the configuration form
2. Enter a test prompt
3. Click "Run Test" to see how Gemini responds
4. Adjust configuration parameters if needed

3.1. Content Generation in Editors

Gemini AI is integrated with Odoo's rich text editor:

1. Open any editable content (blog post, project task, etc.)
2. Type the word "/Gemini" then open a gemini prompt dialog
3. Select a Gemini configuration (relevant ones appear first)
4. Enter your prompt describing what content you need
5. Click "Generate" to create content
6. Review the generated content and click "Insert" to add it to your document

3.2. Generating Alternatives for Selected Text

To improve or transform existing content:

1. Select text in the editor
2. Click the "Gemini AI" button
3. The dialog will open in "Alternatives" mode
4. Choose a transformation type or enter custom instructions
5. Review the alternatives and select the one you prefer
6. Click "Insert" to replace the selected text

4.1. Translating Messages

Translate messages in any chatter with one click:

1. Hover over a message in any chatter
2. Click the "Translate with Gemini" button (language icon)
3. The message will be translated to your current user language
   • For example, if your user language is French and the message is in English, it will be translated to French
4. Click the same button again to toggle back to the original message

4.2. AI-Powered Email Replies

Generate contextual replies to messages:

1. Hover over a message in any chatter
2. Click the "Gemini AI Reply" button
3. A dialog will open with the message context
4. Enter any specific instructions for the reply
5. Review the generated reply
6. Click "Insert" to add it to the message composer

5.1. Writing Blog Posts with Gemini

Create engaging blog content quickly:

1. Navigate to Website → Blog
2. Create a new blog post or edit an existing one
3. Click the "Gemini AI" button in the content editor
4. Select a blog-optimized Gemini configuration
5. Enter a prompt like "Write a blog post about [topic] with these key points: [points]"
6. Review and insert the generated content
7. Edit as needed and publish

5.2. Improving Existing Content

Enhance your blog posts:

1. Select a portion of your blog post
2. Click the "Gemini AI" button
3. Choose "Make it more engaging" or enter custom instructions
4. Review the alternatives and select the best one
5. Continue refining your content with Gemini's assistance

Common Issues:

• API Key Invalid: Verify your API key in Gemini AI → Settings
• Rate Limits Exceeded: Free tier has limits (check https://ai.google.dev/gemini-api/docs/rate-limits)
• No Configurations Available: Ensure you've created configurations and assigned them to the correct models

For additional support:

• Email: duongodooapps@gmail.com