Todo evento es un CloudEvent 1.0: el mismo sobre y, dentro de data, lo propio de cada evento. id es la clave de idempotencia (sale del trabajo, no del azar) y subject es el workspace, así que un consumidor puede descartar duplicados y procesar en orden por workspace. Los nombres siguen ai.qomni.<dominio>.<objeto>.<acción>.v<n>.
Sobre
CloudEvents 1.0 as every qomni event uses it (STYLE.md, events). Each event schema is this envelope plus its type and its data. id is the idempotency key, derived from the work; subject is the workspace slug, so brokers partition by workspace; time is when it happened.
| Campo | Tipo | Detalle |
|---|---|---|
specversion Obligatorio |
string | "1.0" |
id Obligatorio |
string | ≤ 200 |
source Obligatorio |
string | Who publishes it, e.g. /cells/co1/agents |
type Obligatorio |
string | |
time Obligatorio |
string | date-time |
datacontenttype Obligatorio |
string | "application/json" |
subject Obligatorio |
string | The workspace slug. |
livemode Opcional |
boolean | CloudEvents extension: false for test-mode work. |
traceparent Opcional |
string | CloudEvents distributed-tracing extension. |
data Obligatorio |
object |
Objetos compartidos
Objetos que varios eventos llevan dentro de data.
actor
Who or what acted: an agent, a member, an API key (its ID, never the key) or the system.
| Campo | Tipo | Detalle |
|---|---|---|
type Obligatorio |
string | agent, member, api_key, system |
id Obligatorio |
string | |
on_behalf_of Opcional |
string | The member an API key or an approved agent action acts for. |
subject
| Campo | Tipo | Detalle |
|---|---|---|
type Obligatorio |
string | agent, conversation, call, phone_number |
id Obligatorio |
string |