> ## Documentation Index
> Fetch the complete documentation index at: https://opinionai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Behavior Settings

> Configure how your AI agent behaves and responds to users

# Agent Behavior Configuration

The Behavior tab allows you to customize how your AI agent interacts with users, including conversation prompts, initial messages, and suggested responses.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/opinionai/Users/ahmedz/Documents/GitHub/chatbot/aivah-guide/share/Share%20/Screenshot%202025-08-09%20at%201.20.45%20PM.png" alt="Agent Behavior Configuration Interface" />

## Agent Prompt Configuration

### System Instructions

* **Agent Prompt**: Define the core instructions that guide your agent's behavior
* Use the prompt template system or write custom instructions
* Example: "Use the following pieces of context to answer the question at the end."

### Knowledge Integration

* Agents can access and utilize knowledge bases during conversations
* Configure how the agent should reference and apply knowledge
* Set up context-aware responses based on available information

## Initial Conversation Setup

### Welcome Messages

* **Initial Agent Messages**: Set the first message users see when starting a conversation
* Default example: "👋 Hi, how can I help you?"
* Customize to match your agent's personality and purpose

### Suggested Prompts

Configure suggested questions that appear to guide users:

* "Give me a summary of this knowledge base"
* "Can you provide an overview of the main topics covered here?"
* "What categories or sections does this knowledge base cover?"

## Message Flow Options

### Interactive Elements

* **Show initial messages as tooltip**: Display welcome messages in a non-intrusive way
* **Remove 'Powered by Aivah'**: Clean up the interface for branded experiences
* **Hide microphone**: Disable voice input if not needed

### User Experience Settings

* Configure message display preferences
* Set up conversation flow patterns
* Customize interaction styles based on your use case

## Agent Identity

### Naming and Branding

* **Agent Name**: Set a custom name for your agent (e.g., "Product Presenter")
* **Companion Name**: Define the companion identity
* **Avatar Selection**: Choose from available avatars or upload custom ones

<img src="https://mintlify.s3.us-west-1.amazonaws.com/opinionai/Users/ahmedz/Documents/GitHub/chatbot/aivah-guide/share/Share%20/Screenshot%202025-08-09%20at%201.20.45%20PM.png" alt="Companion Selection Interface" />

### Voice and Personality

* **Companion Voice**: Select Gemini voices (Sportsman, Customer support, Sarah, etc.) or OpenAI Realtime voices (Alloy, Echo, Shimmer, Ash, Ballad, Coral, Sage, Verse, Cedar, Marin) based on the active model
* **LLM Model**: Choose the underlying model family (OpenAI GPT 4.1/5 series, Gemini 2.5 series, OpenAI Realtime, or Groq-hosted models)
* Configure personality traits through prompt engineering

## Best Practices

1. **Clear Instructions**: Write specific, actionable prompts
2. **User-Friendly Welcome**: Create welcoming initial messages
3. **Helpful Suggestions**: Provide relevant suggested prompts
4. **Consistent Identity**: Maintain consistent naming and voice
5. **Purpose-Driven**: Align behavior with intended use case

The behavior configuration directly impacts user experience and agent effectiveness.
