Create History

POST

Generate historical factors relevant to a user’s decision-making process.

This endpoint analyzes a given question and user profile to produce a set of historical factors that could influence the user’s decision. These factors provide context for understanding past behaviors and preferences.

Parameters:

req (HistoryRequest): Contains the question, user profile, and relevant attributes

Returns:

HistoryResponse: A dictionary of historical factors and their descriptions

Raises:

HTTPException 404: If there’s an error in generating historical factors

Request

This endpoint expects an object.

why_promptstringRequired

user_profile_attributesmap from strings to lists of strings or lists of integers or lists of doublesRequired

attributeslist of stringsRequired

llm_modelenumOptionalDefaults to gpt4

Enum representing the llm model types used in the experiments.

Response

Successful Response

historymap from strings to strings

POST

1 curl -X POST https://api.subconscious.ai/personas/history \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "why_prompt": "What factors influence your choice in selecting a mobile phone?",
6   "user_profile_attributes": {
7     "age_levels": [
8       25,
9       30
10     ],
11     "education_levels": [
12       "Bachelors Degree"
13     ],
14     "gender_levels": [
15       "Male"
16     ],
17     "income_levels": [
18       50000,
19       75000
20     ]
21   },
22   "attributes": [
23     "price",
24     "operating_system",
25     "battery_life",
26     "camera_quality",
27     "storage_capacity"
28   ],
29   "llm_model": "gpt4"
30 }'

200Successful

1 {
2   "history": {
3     "Brand Loyalty": "The user's tendency to stick with particular mobile phone brands over time",
4     "Feature Preferences": "The specific features the user has prioritized in past mobile phone purchases",
5     "Previous Phone Brands": "The specific mobile phone brands the user has used in the past",
6     "Previous Purchase Channels": "The places or methods through which the user typically buys mobile phones (e.g., online, retail stores)",
7     "Previous Purchase Frequency": "How often the user typically buys new mobile phones",
8     "Price Sensitivity": "The user's historical responsiveness to mobile phone prices and willingness to pay"
9   }
10 }

Built with

1	curl -X POST https://api.subconscious.ai/personas/history \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"why_prompt": "What factors influence your choice in selecting a mobile phone?",
6	"user_profile_attributes": {
7	"age_levels": [
8	25,
9	30
10	],
11	"education_levels": [
12	"Bachelors Degree"
13	],
14	"gender_levels": [
15	"Male"
16	],
17	"income_levels": [
18	50000,
19	75000
20	]
21	},
22	"attributes": [
23	"price",
24	"operating_system",
25	"battery_life",
26	"camera_quality",
27	"storage_capacity"
28	],
29	"llm_model": "gpt4"
30	}'

1	{
2	"history": {
3	"Brand Loyalty": "The user's tendency to stick with particular mobile phone brands over time",
4	"Feature Preferences": "The specific features the user has prioritized in past mobile phone purchases",
5	"Previous Phone Brands": "The specific mobile phone brands the user has used in the past",
6	"Previous Purchase Channels": "The places or methods through which the user typically buys mobile phones (e.g., online, retail stores)",
7	"Previous Purchase Frequency": "How often the user typically buys new mobile phones",
8	"Price Sensitivity": "The user's historical responsiveness to mobile phone prices and willingness to pay"
9	}
10	}