Reports & Notifications
TerraGuard generates AI-powered structured reports and delivers multi-channel notifications to keep response teams informed about disaster events.
Overview
TerraGuard provides two complementary systems for communicating event information to response teams: AI-generated reports that provide comprehensive situational analysis, and automated notifications that deliver timely alerts through email and Telegram.
Report Generation
AI Agent Architecture
Reports are generated by an AI agent that uses the ReAct (Reasoning + Acting) pattern. The agent has access to five MCP (Model Context Protocol) tool servers, allowing it to actively research and compile information rather than relying on a static prompt.
The five MCP tools available to the agent:
| MCP Server | Purpose |
|---|---|
| Database Search | Query event records, measurements, timeline, affected countries |
| Vector Search | Semantic search over the knowledge base for relevant content |
| Document Retrieval | Fetch specific documents, SITREPs, and advisories |
| GeoPop | Population exposure data, reverse geocoding, admin regions |
| Web Links | Generate links to external resources and source documents |
ReAct Pattern
The agent follows an iterative loop:
- Reason — Analyze what information is needed for the current report section
- Act — Call one or more MCP tools to retrieve that information
- Observe — Process the returned data and decide if more information is needed
- Repeat — Continue until the section has sufficient content
- Synthesize — Compile findings into structured prose
This approach produces higher-quality reports than single-pass generation because the agent can iteratively gather and cross-reference information.
Report Structure
Generated reports follow a standardized 10-section structure:
| Section | Content |
|---|---|
| 1. Executive Summary | High-level overview of the event and key impacts |
| 2. Event Details | Type, location, measurements, source data |
| 3. Timeline | Chronological progression of the event |
| 4. Impact Assessment | Casualties, displacement, infrastructure damage |
| 5. Population Exposure | Affected population by country and region |
| 6. Response Actions | Government and humanitarian response activities |
| 7. Situation Analysis | Current conditions and operational environment |
| 8. Access & Constraints | Logistics, access limitations, security concerns |
| 9. Outlook & Forecast | Expected development and anticipated needs |
| 10. Sources & References | Links to all referenced documents and articles |
Screenshot: Report generation interface showing a "Generate Report" button, progress indicator with current agent step, and the resulting report with expandable sections
Editing Reports
Generated reports are loaded into a rich text editor (TipTap) where you can:
- Edit any section's content manually
- Reorder sections
- Add custom sections or notes
- Format text with headings, lists, bold, italics, and links
- Insert tables and images
Screenshot: Rich text editor showing a generated report being edited, with the formatting toolbar visible and a section being modified
Exporting Reports
Completed reports can be:
- Downloaded as PDF
- Shared via a permanent link
- Sent directly via the notification system
- Attached to email notifications
Notification System
How Notifications Work
The notification engine evaluates organization-specific matrices to determine which teams should be alerted about which events. This ensures that the right people receive the right information based on their organization's mandate and operational focus.
Notification Triggers
Notifications are sent in several scenarios:
| Trigger | Description |
|---|---|
| New Event | A disaster event is first detected above the organization's threshold |
| Alert Level Change | An event is upgraded (e.g., GREEN to ORANGE, ORANGE to RED) |
| Downgrade Notice | An event's alert level is reduced |
| Scheduled Follow-up | Automatic updates at +2h, +12h, and +24h after event onset |
| Manual Trigger | A team member manually sends a notification to their team |
Scheduled Notifications
For significant events, the system automatically schedules follow-up notifications:
- +2 hours — Initial enrichment summary with early news coverage
- +12 hours — Comprehensive update with full knowledge base content
- +24 hours — Situation evolution report with response status
These intervals are configurable per organization. Each scheduled notification includes the latest available information at send time.
Email Notifications
Email notifications use a templated format that includes:
- Event title, type, and alert level with color coding
- Location map thumbnail
- Key measurements (magnitude, wind speed, etc.)
- Affected population summary
- Latest AI summary excerpt
- Links to the full event detail page and report
Screenshot: Sample email notification showing the TerraGuard header, event details card with map, measurements summary, and action buttons linking to the platform
The email template system supports:
- HTML-formatted messages with responsive layout
- Organization branding and customization
- Inline map images
- Direct links to the platform
Telegram Integration
Teams can connect a Telegram channel or group to receive event notifications. Telegram messages include:
- Event title and alert level emoji indicators
- Location and key measurements
- Brief AI summary
- Direct link to the event detail page
Configure Telegram integration in the team settings by providing a Telegram bot token and chat ID.
Screenshot: Notification settings page showing email configuration, Telegram bot connection, and notification preference toggles for different alert levels
Notification Preferences
Each team can configure:
- Alert level threshold — Minimum alert level to receive notifications (RED only, RED + ORANGE, or all)
- Event types — Which disaster types to be notified about
- Channels — Enable/disable email and Telegram independently
- Quiet hours — Suppress non-critical notifications during specified hours
- Digest mode — Batch low-priority notifications into periodic digests
Next Steps
- Team Management — Configure organizations, teams, and matrices
- Event Detail — View the information that feeds into reports
- AI Agents (Architecture) — Technical details of the report generation agent
Knowledge Base & AI Summaries
How TerraGuard discovers, crawls, validates, and indexes external knowledge for each disaster event, enabling AI summaries and RAG-powered question answering.
Team & Organization Management
Configure multi-tenant organizations, teams, roles, notification matrices, and country-level deployment settings in TerraGuard.