Forethought · Schema

Forethought Solve Conversation

A Solve conversation between an end-user and the Forethought Solve agent.

AIArtificial IntelligenceCustomer SupportCustomer ServiceGenerative AISupportGPTConversational AITicket TriageAgentic AIVoice AIHelpdeskMulti-Agent

Properties

Name	Type	Description
conversation_id	string	Unique identifier for the conversation.
user_id	string	Stable identifier for the end user.
channel	string	Origin channel of the conversation.
query	string	The customer's free-form question or statement.
response	string	Solve agent reply text.
is_solved	boolean	True when the conversation has been resolved by Solve.
should_escalate	boolean	True when Solve recommends escalating to a human agent.
workflow_id	string	Identifier of the matched Autoflow / workflow.
intent	string	Predicted customer intent.
context_variables	object	Map of Solve context variable IDs to their values for this conversation.
created_at	string
updated_at	string

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/forethought/main/json-schema/forethought-conversation-schema.json",
  "title": "Forethought Solve Conversation",
  "description": "A Solve conversation between an end-user and the Forethought Solve agent.",
  "type": "object",
  "properties": {
    "conversation_id": {
      "type": "string",
      "description": "Unique identifier for the conversation."
    },
    "user_id": {
      "type": "string",
      "description": "Stable identifier for the end user."
    },
    "channel": {
      "type": "string",
      "enum": ["chat", "email", "voice", "slack", "headless", "mobile"],
      "description": "Origin channel of the conversation."
    },
    "query": {
      "type": "string",
      "description": "The customer's free-form question or statement."
    },
    "response": {
      "type": "string",
      "description": "Solve agent reply text."
    },
    "is_solved": {
      "type": "boolean",
      "description": "True when the conversation has been resolved by Solve."
    },
    "should_escalate": {
      "type": "boolean",
      "description": "True when Solve recommends escalating to a human agent."
    },
    "workflow_id": {
      "type": "string",
      "description": "Identifier of the matched Autoflow / workflow."
    },
    "intent": {
      "type": "string",
      "description": "Predicted customer intent."
    },
    "context_variables": {
      "type": "object",
      "additionalProperties": true,
      "description": "Map of Solve context variable IDs to their values for this conversation."
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": ["conversation_id", "query"]
}