AckdbEntityProfile

Aggregated entity profile - everything known about an entity in a single object. This is the primary response format for AI agent queries (L1 tier).

Properties

entityAckdbEntityrequired
identityLinksarray ofrequired

All identity links for this entity.

traitsarray ofrequired

All computed traits for this entity.

recentEventsarray ofrequired

Recent activity events (default: last 20).

Example

AckdbEntityProfile example
{
  "entity": {
    "entityId": "01HXYZ123456789ABCDEFGH",
    "name": "Acme Corp",
    "createdAt": "1970-01-01T00:00:00.000Z",
    "updatedAt": "1970-01-01T00:00:00.000Z"
  },
  "identityLinks": [
    {
      "entityId": "01HXYZ123456789ABCDEFGH",
      "source": "slack",
      "externalIdType": "slack_channel_id",
      "externalIdValue": "C04ABC",
      "confidence": 1,
      "linkedAt": "1970-01-01T00:00:00.000Z"
    }
  ],
  "traits": [
    {
      "entityId": "01HXYZ123456789ABCDEFGH",
      "traitKey": "slack_message_count",
      "valueString": null,
      "valueNumber": 42,
      "valueBool": null,
      "valueDate": null,
      "source": "slack",
      "workflow": "slack-ingestion",
      "confidence": 1,
      "updatedAt": "1970-01-01T00:00:00.000Z"
    }
  ],
  "recentEvents": [
    {
      "id": "01HXYZ123456789ABCDEFGH",
      "entityId": "01HXYZ123456789ABCDEFGI",
      "source": "slack",
      "eventType": "message",
      "summary": "Customer asked about pricing in #acme-corp",
      "metadata": {},
      "timestamp": "1970-01-01T00:00:00.000Z",
      "createdAt": "1970-01-01T00:00:00.000Z"
    }
  ]
}