Events
Events are the core data unit in AIGodfather.
What is an Event?
Every time your agent performs an action, it sends an event. Events are logged, classified by AI, evaluated against rules, and stored for audit.
Event Fields
| Field | Type | Description |
|---|---|---|
action | string | What happened (e.g. "payment", "delete") |
event_type | string | Alternative to action (e.g. "info", "error") |
severity | string | low / medium / high / critical |
message | string | Human-readable description |
metadata | object | Any structured data |
resource | string | Target resource |
tags | string[] | Filterable tags |
user_id | string | Associated user |
Event Lifecycle
- Agent sends event via SDK or HTTP
- API validates and authenticates
- AI classifies risk score (0-100)
- Rules Engine evaluates all matching rules
- Event is stored with full context
- Response returned to agent (blocked, approved, recorded)