Bemba AI - Intelligent Assistant
Bemba AI is an intelligent conversational assistant integrated into the PCH-SIG application. It allows users to explore data through natural language queries and file grievances via guided voice conversation.
Overview
┌─────────────────────────────────────────────────────────────────────────────┐
│ BEMBA AI │
├─────────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ "How many households in the Oio region?" │ │
│ │ [Mic] [Send] │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │ 🤖 Bemba: │ │
│ │ There are **2,450 households** in the Oio region, spread across │ │
│ │ 12 sectors. Farim sector has the most households (523). │ │
│ │ [🔊] │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
│ Suggestions: [Statistics] [Households] [Payments] [File grievance] │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Main Features
| Feature | Description |
|---|---|
| Natural language queries | Ask questions in French, Portuguese, English or Creole |
| Speech synthesis | Listen to responses read aloud |
| Speech recognition | Speak instead of typing |
| Grievance filing | File a grievance through guided conversation |
| Map integration | Results can be displayed on the map |
Supported Languages
| Language | Code | Example question |
|---|---|---|
| French | FR | "Combien de beneficiaires actifs ?" |
| Portuguese | PT | "Quantos agregados na regiao de Oio?" |
| Creole (Kriol) | CR | "Kantu agregadu na Oio?" |
| English | EN | "How many households in Bafata?" |
Accessing Bemba AI
- Open the GIS Map
- Click on the Bemba mascot in the bottom right
- The assistant opens in a floating panel
Interface Controls
| Icon | Action |
|---|---|
| 🎤 | Activate speech recognition |
| 🔊 | Enable/disable voice reading |
| 🗑️ | Clear conversation history |
| ➖ | Minimize assistant |
| ✕ | Close assistant |
Types of Questions
General Statistics
"How many households in total?"
"What is the number of active beneficiaries?"
"Payment statistics for last month"
Geographic Questions
"How many households in the Oio region?"
"What are the sectors in Bafata?"
"List of localities in Farim sector"
Payment Questions
"Total payment amount for cycle C015?"
"How many pending payments?"
"Telecel payment success rate"
Grievance Questions
"How many open grievances?"
"Grievances past SLA deadline"
"Grievance statistics by type"
Quick Suggestions
Suggestion buttons are available for common queries:
| Button | Action |
|---|---|
| Statistics | Shows global statistics |
| Households | Information about households |
| Payments | Payment statistics |
| File grievance | Starts grievance filing mode |
Response Formatting
Bemba AI formats responses with:
- Bold text for important numbers
- Italic text for clarifications
- Bullet lists for enumerations
- Tables for structured data
Technical Architecture
Privacy
- Conversations are stored locally in the browser
- Only the last 50 messages are kept
- No conversation data is sent to third parties
- SQL queries are executed in read-only mode
Best Practices
:::tip Usage Tips
- Be specific: "households in Oio" rather than "households"
- Use suggestions: They cover common queries
- Enable voice: Useful for users unfamiliar with keyboards
- Verify results: AI may sometimes misinterpret :::
Limitations
- Read-only queries (no data modification)
- Requires internet connection for AI queries
- Speech recognition depends on browser (Chrome recommended)
- Creole (Kriol) uses a Portuguese voice (approximation)