Skip to main content

​
Project Overview

Clever AI is an AI-powered ticketing intelligence platform that enhances customer experience for Clever Servizi Energetici S.p.A. by automating the creation and management of maintenance requests through conversational agents.
Powered by OpenAI GPT-4.1-mini and Google Cloud Speech-to-Text / Text-to-Speech, Clever AI converses with users in English or Italian, captures all required customer information, and logs tickets automatically.

​
Key Challenges

  • Manual ticket creation processes
  • Incomplete or inaccurate customer data capture
  • Lack of real-time insights into ticket status and resolution

​
Our Solution

Clever AI introduces a conversational agent that:
  1. Listens to customers via microphone using Google Cloud Speech-to-Text.
  2. Extracts mandatory information (name, phone, address, issue) using Natural Language Understanding.
  3. Prompts for any missing required detail before proceeding.
  4. Accepts optional details such as role/job, priority, and request type.
  5. Logs the ticket and hands off to human operators when necessary.
  6. Supports English and Italian seamlessly.

​
Quick Start

1

Open Clever AI Conversation Agent

Launch the agent interface in a Chromium-based browser (Chrome recommended).
2

Start the Conversation

Press and hold the microphone button, speak your request, then release the button when finished.
3

Provide Required Details

The agent will prompt you for any missing mandatory information.
4

Review Ticket

Once all details are gathered, the agent will create a ticket and confirm the reference number.

​
Core Components

Conversational Ticket Logging

Natural language interface that captures required customer details and logs tickets automatically.

Analytics Dashboard

Real-time visualisation of ticket volumes, statuses, and response times.

Ticket & Conversation History

Browse historical tickets and conversation transcripts for auditing and follow-up.

​
Getting Started with Clever AI Conversation Agent

This guide will help you understand the Clever AI Conversation Agent and how to get started with using its voice-powered ticketing intelligence features.

​
Overview

Clever AI is an advanced conversational ticketing agent designed specifically for Clever Servizi Energetici S.p.A. that transforms customer service through voice-powered interactions. Using cutting-edge AI technology, it automates ticket creation and management while maintaining natural, multilingual conversations. Clever AI Conversation Agent Light

​
System Requirements

​
Application Requirements

  • Web Browser: Latest version of Chrome
  • Microphone Access: Required for voice interaction
  • Internet Connection: Required for accessing the application
Clever AI is optimized for voice interactions and works best with a reliable internet connection and quality microphone for accurate speech recognition.

​
Voice Interaction Features

Google Cloud Speech-to-Text : Industry-leading accuracy with support for Italian and English languages
  • Multi-Lingual Support
  • Best for balanced accuracy and cost-effectiveness
GPT-4.1-mini - Advanced conversational AI with contextual understanding
  • Extracts customer information intelligently
  • Handles complex maintenance requests
  • Maintains conversation context
Google Cloud Text-to-Speech - Natural voice responses in Italian and English
  • Clear, professional voice synthesis
  • Confirmation of captured information
  • Guided prompts for missing details

​
How to Use Clever AI

Follow these steps to create your first maintenance ticket using voice commands:
1

Access the Conversation Agent

Open Clever AI in your Chrome browser and ensure microphone permissions are granted.
2

Start Speaking

Press and hold the microphone button, then describe your maintenance issue in Italian or English.
3

Provide Required Information

The agent will ask for any missing mandatory details like your name, phone number, and address.
4

Add Optional Details

Optionally provide your role, issue priority, or specific request type for better categorization.
5

Confirm and Submit

Review the captured information and confirm to create your maintenance ticket.

​
Core Components

Clever AI offers a comprehensive set of features designed to revolutionize maintenance ticket management through intelligent conversation:

Voice-Powered Ticket Creation

Create maintenance tickets through natural voice conversations in Italian or English.

✓Automatic information extraction
✓Intelligent prompting for missing details
✓Real-time validation and confirmation

Smart Information Capture

Intelligent extraction of customer details and maintenance requirements.

📋Mandatory: Name, phone, address, issue
⚡Optional: Role, priority, request type
🔍Validation: Format and completeness checks

Ticket Management System

Comprehensive ticket lifecycle management with automated workflows.

✓Automatic ticket ID generation
✓Status tracking and updates
✓ Extensible Integration with other existing systems

Analytics & Insights

Real-time analytics and reporting for ticket performance and trends.

📊Ticket volume and resolution metrics
📈Response time analysis
📋Customer Ticket History

​
Tech Stack

TypeScript

Core language for type-safe frontend development

  • Strong typing for better code quality
  • Improved maintainability

FastAPI

High-performance Python web framework

  • Automatic API documentation
  • Type hints and validation

SQLite

Lightweight database for tickets and logs

  • Zero configuration required
  • ACID compliance

OpenAI GPT-4.1-mini

Advanced language model for conversation

  • Natural language understanding
  • Context-aware responses
  • Multi-language support

Google Cloud AI

Speech-to-text and text-to-speech services

  • Natural voice synthesis

🐳 Docker

Containerization for consistent deployment across environments

☁️ Cloud Run

Serverless container platform for scalable API serving

⚙️ CI/CD

GitHub Actions & WatchTower for automated deployment

​
Agent Details

🚀 Session Management

  • start_conversation_tool
  • complete_conversation_tool
  • finalize_conversation_tool

📋 Information Extraction

  • extract_customer_info_tool
  • prompt_for_issue_tool

🔧 Issue Resolution

  • troubleshoot_issue_tool
  • skip_troubleshooting_tool

✅ Confirmation Handling

  • handle_confirmation_rejection_tool

🏠 Query Routing

  • handle_non_housing_inquiry_tool

​
Need Help?

If you encounter any issues or have questions about Clever AI, our team is here to help.

📧 Contact Support📚 API Reference