Aeethera Documentation

On the dashboard, you will find the following information:

• Total Assistants – The total number of AI assistants created by your company.
• Total Sessions – The number of unique user sessions that have interacted with your assistants.
• Total Interactions – The total number of conversations or interactions across all your assistants.
• Average Messages per Session – The average number of messages exchanged during each user session.

These metrics help you monitor your assistants' usage, understand user engagement, and track the overall performance of your company's AI services.

When you click the Refresh button, Aeethera performs a new analysis of your website and provides updated metrics, including:

Website Status

• Current Status – Indicates whether your website is online and accessible.
• SSL Certificate Status – Shows whether your website's SSL certificate is valid or invalid.
• Page Loading Speed – Measures how quickly your website loads for users.

Core Web Vitals

Aeethera provides real-world performance metrics based on Lighthouse and Core Web Vitals, including:

• First Contentful Paint (FCP) – Measures how quickly the first visible content appears on the page.
• Largest Contentful Paint (LCP) – Measures how long it takes for the main content of the page to load.
• Speed Index – Indicates how quickly the contents of a page are visually displayed.
• Total Blocking Time (TBT) – Measures the amount of time the browser's main thread is blocked.
• Layout Shift (CLS) – Measures the visual stability of your page and how much elements unexpectedly move during loading.

Performance Insights

Additional performance information includes:

• Server Response Time
• Time to Interactive (TTI)
• Max Potential First Input Delay (FID)

Optimization Insights

Aeethera also analyzes your website for optimization opportunities, such as:

• Unused JavaScript files
• Unused CSS files
• Image optimization issues
• Font optimization issues

Based on the analysis, recommendations will be provided to help improve your website's performance and user experience.

Analytics History

The Analytics History section stores historical Lighthouse monitoring reports, allowing you to track your website's performance over time and compare previous analyses.

Visit Website

You can visit your website directly by clicking the Visit Website button. This will open the website you added to Aeethera in a new browser tab.

Adding a New Website

If your company manages multiple websites, you can analyze all of them within Aeethera. To add a new website:

• Click the Add Website button.
• Enter a name for the website.
• Enter the website URL or link.
• Save your changes.

Once added, the website will appear in your My Websites dashboard, where you can monitor its performance and analytics alongside your other websites.

Uploading a New File

To upload a new file, click the Upload File button. Aeethera currently supports two types of data sources:

• Document Files – PDF, DOC, XLSX, CSV, and TXT files.
• Google Sheets

Uploading a New File

To upload a document:

• Navigate to the Upload File page.
• Click the File Upload option.
• Enter a name for the file. This will serve as the display name within Aeethera.
• Click Choose File to open the file selection dialog.
• Select the file you want to upload.
• After selecting your file, click Upload File to complete the process.

Uploading a Google Sheet

To upload a Google Sheet:

• Open your Google Sheet.

• Share the sheet with the following service account email: [aeethrav1@aeethera.iam.gserviceaccount.com](mailto:aeethrav1@aeethera.iam.gserviceaccount.com)

• Copy the URL of the Google Sheet.

• In Aeethera, navigate to the Upload File page and Click the Google Sheet option.

• Paste the Google Sheet URL into the provided field.

• After selecting your file, click Upload File to complete the process.

Once the upload is complete, your file will appear on the Uploaded Files page and in the Knowledge Base section with a status of Pending.

Extraction

Extraction is the process of reading and converting your files into a format that Aeethera can understand. When extracting a file, you can configure several options.

Extraction Strategy

The Extraction Strategy determines how Aeethera processes your file. The available options include:

• Raw Text – Extracts only plain text from the document.
• Structured Extraction – Preserves the structure of the document, such as headings, paragraphs, and sections.
• Semantic Parsing

Parsing Mode

The Parsing Mode controls the quality and speed of the extraction process. The available options are:

• Fast – Prioritizes speed over accuracy.
• Balanced – Provides a balance between speed and extraction quality.
• Accurate – Prioritizes extraction quality and document understanding.

The parsing mode you select may also affect the availability of some extraction features.

OCR Support

OCR (Optical Character Recognition) allows Aeethera to detect and extract text from images contained within documents. This feature is especially useful for:

• Scanned PDF documents
• Image-based documents
• Documents where text cannot be selected normally

Without OCR enabled, scanned PDFs may produce little or no extracted text.

Extract Tables

When Extract Tables is enabled, Aeethera preserves the structure of tables during extraction. This allows your assistant to:

• Understand rows and columns correctly
• Retrieve information from tables more accurately
• Answer questions based on tabular data

Save Output

When enabled, Aeethera saves the extraction results in multiple formats, including:

• vectors.json
• text.txt
• extract.json

Extract Images

If Extract Images is enabled, all images found in the document will be extracted and saved separately. You will be able to:

• View the extracted images
• Download the images for later use
• Use the images as part of your document archive

Embedding

Embedding is the process of converting the extracted content into vector representations that allow your assistant to search, understand, and retrieve information intelligently. For most users, all embedding settings are preconfigured with recommended defaults. These settings have been optimized to help Aeethera:

• Understand the meaning of your documents
• Retrieve relevant information quickly
• Improve the accuracy of responses generated by your assistant

In most cases, no additional configuration is required—the default settings are designed to provide the best balance between performance and accuracy.

Google Sheets Synchronization

Aeethera allows you to automatically synchronize your Google Sheets with your assistant, ensuring that your assistant always has access to the latest company data.

Setting Up Synchronization

After uploading a Google Sheet to Aeethera, a Setup Required button will appear next to the uploaded sheet. To enable synchronization:

• Click the Setup Required button.
• Copy the script provided by Aeethera.
• Open your Google Sheet.

• Click Extensions from the menu bar.

• Select Apps Script.

• When the Apps Script editor opens, paste the copied script into the editor.

• Save the script and follow any authorization prompts from Google.

How Synchronization Works

Once the setup is complete, Aeethera automatically monitors the Google Sheet for changes.

• The extraction process is automatically triggered.
• The embedding process is automatically triggered.
• The updated information is added to your assistant's knowledge base.

This automatic synchronization ensures that your assistant is always working with the most recent company data without requiring you to manually upload the sheet again. By keeping your Google Sheets synchronized with Aeethera, your assistants can provide more accurate, up-to-date, and context-aware responses based on the latest information available.

From this page, you can:

• View all assistants belonging to your company.
• Test each assistant to see how it responds to customer questions.
• Create new assistants.
• Manage existing assistants.
• Enable or disable assistants.

Creating an Assistant

To create a new assistant, click the "Create Assistant" button. You will first be taken to the assistant creation page, where you can specify:

• Assistant Name – The unique name of the assistant.
• Temperature – Controls how creative or deterministic the assistant's responses are.
• Description – A brief explanation of the assistant's purpose.
• System Prompt – Instructions that define how the assistant should behave.

After creating the assistant, you will be redirected to the assistant configuration page.

Assistant Configuration

The following settings can be customized:

Bot Name

The Bot Name is the name that will be displayed to your customers on your website.

Tone

Defines the communication style of the assistant, such as:

• Professional
• Friendly
• Casual
• Formal
• Technical

Personality

Determines the assistant's character and behavior when interacting with users. Examples include:

• Helpful and informative
• Friendly and conversational
• Professional and concise
• Creative and engaging

Business Context

Provides information about your company, products, services, and industry. This context helps the assistant give responses that are more relevant to your business.

Description

A short summary describing the assistant's purpose and responsibilities.

System Prompt

The System Prompt contains the instructions that guide the assistant's behavior, response style, restrictions, and overall personality. This is one of the most powerful customization options, as it determines how the assistant behaves in different situations.

Temperature

The Temperature setting controls the randomness and creativity of the assistant's responses. Aeethera uses Groq-powered models, where temperature generally ranges from 0.0 to 2.0.

• *0.0 – 0.3: Very deterministic and factual. Responses are consistent and predictable. Ideal for customer support, FAQs, and business assistants.
• 0.4 – 0.8: Balanced creativity and accuracy. Produces natural and varied responses while remaining reliable. Recommended for most use cases.
• 0.9 – 1.5: More creative and diverse responses. Suitable for brainstorming, content generation, and creative tasks.
• Above 1.5: Highly creative and unpredictable responses. Use with caution, as answers may become less focused or consistent.

For most business assistants, a temperature between **0.2 and 0.7** is recommended.

Knowledge Base

The Knowledge Base section allows you to select which uploaded files, documents, and Google Sheets the assistant can learn from. The assistant will use the selected knowledge sources to answer questions and provide information to users. Once you have configured these settings, click Save to create your assistant.

Managing Existing Assistants

Existing assistants can be managed by clicking the "Manage" button on the Assistants page. From the management page, you can update:

• Tone
• Personality
• Business Context
• Description
• System Prompt
• Temperature
• Knowledge Base

Any changes you make are applied immediately after saving. This flexibility allows you to continuously improve your assistants as your business grows, ensuring they always provide accurate and relevant responses to your customers.

At the top of the page, you will find key metrics such as:

• Total Interactions – The total number of messages exchanged between customers and your assistants.
• Total Sessions – The total number of customer conversations or chat sessions.
• Average Messages per Session – The average number of messages exchanged during each conversation.
• Top Assistant – The assistant with the highest number of interactions within your company.

Customer Intent Analysis

Aeethera automatically analyzes customer conversations and categorizes them into different intents.

A pie chart is displayed to show the distribution of customer intents, helping you understand:

• What customers ask about most frequently.
• The types of support or information they seek.
• Trends in customer interests and needs.

This insight allows you to make informed business decisions and improve your products or services based on actual customer interactions.

Exporting Analytics

From the Analytics page, you can:

• View detailed analytics and performance metrics.
• Generate AI-powered business reports.
• Download analytics data as a CSV file for further analysis or record keeping.

Exporting analytics makes it easy to archive data, share insights with your team, or perform advanced analysis using spreadsheet applications.

Recent Conversations

Below the analytics dashboard, you will find a list of the most recent conversations between your customers and your assistants.

This section allows you to:

• Review customer questions.
• Monitor assistant responses.
• Understand how your assistants are performing in real-world interactions.
• Identify opportunities for improvement.

Monitoring recent conversations helps ensure your assistants provide accurate, helpful, and consistent responses while highlighting areas where additional knowledge or prompt improvements may be needed.

Generate Report

The Generate Report feature uses Aeethera's AI capabilities to analyze customer conversations and create detailed business reports.

Using information gathered from chats between your customers and assistants, Aeethera generates comprehensive reports that include:

• Customer behavior analysis.
• Common customer requests and inquiries.
• Trending topics and interests.
• Customer pain points and challenges.
• Suggestions for improving customer satisfaction.
• Recommendations for enhancing your products, services, or business processes.

These reports provide valuable insights into how your customers interact with your business and help you make data-driven decisions.

View Reports

The View Reports page is where all previously generated reports are stored.

From this page, you can:

• View detailed reports generated by Aeetherra.
• Review past customer behavior analyses and recommendations.
• Download reports for offline viewing or sharing with your team.
• Keep a historical record of your company's customer interactions and AI insights.

Reports are organized by date and can be accessed at any time, allowing you to track changes in customer behavior and measure the impact of improvements made to your products, services, or assistants over time.

If you wish to keep a copy of a report, simply click the "Download" button next to the report, and it will be downloaded to your device.

By understanding your customers' behaviors, preferences, and needs, you can continuously improve your company and deliver better experiences through your AI assistants.

An escalation occurs when:

• The assistant is unable to handle a customer's request.
• The customer requests to speak with a human agent.

Ticket Notifications

When a ticket is created, Aeethera automatically sends an email to the customer.

This email includes:

• A unique ticket number for reference.
• Confirmation that their request has been received.
• Details for tracking their issue.

These notifications reassure customers that their request has been successfully received and provide them with a reference number for future communication.

Managing Tickets

From the Tickets page, you can:

• View all escalated customer tickets.
• Open and review each ticket in detail.
• Respond to customers directly from Aeethera.
• Reply via the customer's provided email address or phone number.
• Update the status of each ticket (e.g., Open, In Progress, Resolved).
• Delete tickets if necessary.

Ticket management provides your support team with a centralized workspace for handling customer issues from creation through resolution.

Ticket Communication

You can communicate with customers directly within Aeethera or use their contact details to continue the conversation outside the platform.

This flexibility allows your support team to choose the most appropriate communication method while maintaining excellent customer service.

Ticket Control

Each ticket can be fully managed by your team, allowing you to:

• Track ongoing issues.
• Ensure timely responses.
• Maintain organized customer support records.
• Close or remove tickets when they are no longer needed.

Proper ticket management ensures that every customer issue receives attention and that your support workflow remains organized and efficient.

From this page, you can view all your existing assistants and configure their widget appearance and behavior.

Opening Widget Studio

To begin customizing your assistant widget, click the "Open Widget Studio" button.

This opens the Widget Studio configuration panel where you can customize both the appearance and behavior of your assistant widget before publishing it to your website.

Widget Customization Options

Inside the Widget Studio, you can configure the following settings:

Header Color

Set the color of the widget header to match your brand identity and website theme.

Choosing a color that aligns with your branding helps create a consistent and professional appearance across your website.

Bot Name

Define the name of your bot as it will appear to users on your website.

This name is displayed within the chat widget and helps customers identify which assistant they are interacting with.

First Message

Set the initial message that appears in the chat box when a visitor opens the widget.

This is the first interaction users will see from your assistant and is an excellent opportunity to welcome visitors and encourage engagement.

Widget Position

Choose where the widget button appears on your website.

Common positions include:

• Bottom right corner.
• Bottom left corner.
• Other supported layout positions depending on your website configuration.

Auto Open Setting

Control whether the chat widget automatically opens when a visitor enters your website.

• Enabled – The message box opens automatically when the page loads.
• Disabled – Visitors must click the widget button before the chat window opens.

This setting allows you to decide whether you want the assistant to proactively engage visitors or wait until they choose to start a conversation.

From this page, you can:

• View all existing team members.
• Create new members.
• Manage member roles and permissions.
• Delete or remove members from the company.

Creating a New Member

To add a new team member, simply click the "Create Member" button.

The new user will automatically be added to your company and assigned a role based on your organization's requirements.

Member Roles

Every user in your company belongs to one of the following roles:

• Viewer – Can only view assigned dashboards and data. This role does not have permission to edit or modify company information.
• Staff – Can access and interact with assigned features based on the permissions granted by the administrator.
• Manager – Has elevated privileges and can manage specific parts of the system depending on the permissions configured by the company administrator.

Managing Members

As an administrator, you can click on any team member to manage their account.

From the member management page, you can:

• Set or update their permissions.
• Control what they can view or access on their personal dashboard.
• Monitor their activity (based on available analytics permissions).

These permissions allow you to control exactly how each member interacts with Aeethera while ensuring sensitive information remains accessible only to authorized personnel.

Deleting Members

Members can be removed from your company in two ways:

• By the Administrator.
• By users who have been granted permission to manage members.

When a member is deleted, their access to the company dashboard is immediately revoked, preventing them from accessing company data or resources.

Allowed Domains

The Allowed Domains section defines the list of websites that are permitted to use your assistant widget.

For your widget to function correctly:

• The website domain must be added to the Allowed Domains list.
• If a domain is not added, the widget may still appear on the page, but visitors will not be able to interact with your assistant.

This security measure prevents unauthorized websites from embedding and using your AI assistant.

Assistant Public ID

Every assistant created within Aeethera is automatically assigned a unique Public ID.

This Public ID is used to:

• Identify the specific assistant being accessed.
• Verify the company associated with the assistant.
• Secure communication between your website and Aeethera.

Aeethera uses the Public ID to ensure every request is authenticated and correctly routed to the appropriate assistant.

Widget Integration Script

To display the Aeethera assistant on your website, add the following script to any page where you want the widget to appear:

<script src="https://widget.aeethera.com/widget.js"
                    data-assistant="public_id"></script>
            

How It Works

• Replace public_id with your assistant's actual Public ID.
• Once the script is added, the widget automatically loads on your website.
• The assistant will only function on domains listed in your Allowed Domains section.

No additional JavaScript configuration is required. Simply include the script and your assistant will automatically initialize whenever a visitor loads your website.

What the Logs Track

The Logs page automatically records important activities performed throughout your Aeethera company account.

Recorded activities include:

• User login and logout events.
• Timestamps showing when users access the system.
• Pages visited within the Aeethera platform.
• System actions performed by users, including future tracking features as they become available.

These records provide administrators with a clear overview of how the platform is being used across the organization and help maintain accurate historical records.

Activity Monitoring

By reviewing activity logs, administrators can:

• Track who accessed the system and when.
• Monitor user navigation and platform usage.
• Identify unusual or suspicious activity.
• Maintain accountability across all team members.

Continuous monitoring enables administrators to quickly detect irregular behavior, improve operational oversight, and ensure company policies are being followed.

Enabling or Disabling Logs

The activity logging system can be enabled or disabled by the company administrator at any time.

To manage activity logging:

1. Navigate to the Settings page.
2. Locate the option labeled "Enable Activity Logs".
3. Toggle the checkbox to enable or disable logging.

When logging is disabled, Aeethera immediately stops recording new activity logs for your company. Existing logs remain available unless they are manually removed according to your organization's data retention policy.

Keeping your account information up to date helps maintain account security while ensuring you always have access to your Aeethera workspace.

Updating Your Username

To change your username:

1. Go to the Settings page.
2. Locate the Username field.
3. Edit your username.
4. Click Save to apply the changes.

Once saved, your updated username will immediately become your new login username and will be reflected throughout your Aeethera account.

Changing Your Password

To update your password, follow these steps:

1. Go to the Settings page.
2. Enter your current (old) password.
3. Enter your new password.
4. Confirm the new password and click Save.

For security reasons, Aeethera requires your current password before allowing you to create a new one. This helps prevent unauthorized users from changing your account credentials.