AIRecommendation

Entity description

An AIRecommendation entity represents an AI-generated suggestion provided to a specific target. The recommendation includes actions, context, display details, and metadata regarding its status.

Properties

Name	Description	Type	Example
uid	A unique identifier for the recommendation	string	`rec-123`
created_at	The timestamp when the recommendation was created, in ISO 8601 format	string	`2025-02-04T12:00:00Z`
updated_at	The timestamp when the recommendation was last updated, in ISO 8601 format	string	`2025-02-04T12:30:00Z`
actions	A list of recommended actions related to this entity	array	See Actions Properties below
display	Contains display-related information for the recommendation	object	See Display Properties below
context	The context in which the recommendation was generated	object	See Context Properties below
target	The target entity for this recommendation, typically representing the user or business involved	object	See Target Properties below
status	Metadata about the status of the recommendation	object	See Status Properties below

Actions Properties

Name	Description	Type	Example
action	Suggested action to take	string	`reply`
reason	Explanation for the recommendation	string	`Clarification needed`
evidence	Supporting evidence for the recommendation	array	`["User asked for price estimate"]`
confidence	Confidence level of the recommendation (0-1)	number	`0.85`

Display Properties

Name	Description	Type	Example
title	Title for the recommendation	string	`We recommend replying to the user's message.`

Context Properties

Name	Description	Type	Example
context_uid	A unique identifier for the context associated	string	`ctx-456`
context_type	The type of context (e.g., 'user_message')	string	`user_message`

Target Properties

Name	Description	Type	Example
target_actor_uid	A unique identifier for the target actor	string	`user-789`
target_actor_type	The type of target actor (e.g., 'customer')	string	`customer`

Status Properties

Name	Description	Type	Example
dismissed	Indicates whether the recommendation has been dismissed	boolean	`false`
dismissed_source_type	Source of dismissal (`user`, `system`)	string	`user`
viewed	Indicates whether the recommendation has been viewed	boolean	`true`

Example

{
  "uid": "rec-123",
  "created_at": "2025-02-04T12:00:00Z",
  "updated_at": "2025-02-04T12:30:00Z",
  "actions": [
    {
      "action": "reply",
      "reason": "Clarification needed",
      "evidence": ["User asked for price estimate"],
      "confidence": 0.85
    }
  ],
  "display": {
    "title": "We recommend replying to the user's message."
  },
  "context": {
    "context_uid": "ctx-456",
    "context_type": "user_message"
  },
  "target": {
    "target_actor_uid": "user-789",
    "target_actor_type": "customer"
  },
  "status":{ 
    "dismissed": false,
    "dismissed_source_type": "user",
    "viewed": true
  }
}