Create Questions

POST

Generate questions for an experiment based on historical factors and constraints.

This endpoint creates a set of questions tailored to the given context, user profile, and specific dimensions of interest. The questions are designed to gather insights about the user’s decision-making process, considering both historical behavior and current constraints.

Parameters:

req (QuestionRequest): Contains the main question, user profile, and dimensions to explore

Returns:

QuestionResponse: A structured set of questions categorized by model type (history/constraints) and dimensions, each with sample responses

The response includes:

Two questions for each specified dimension
A set of sample responses for each question

Raises:

HTTPException 404: If there’s an error in generating the questions

Note:

Questions are generated asynchronously for efficiency
The structure is flexible and can accommodate various models and dimensions

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

model_dimensionsmap from strings to lists of stringsRequired

llm_modelenumOptionalDefaults to gpt4

Enum representing the llm model types used in the experiments.

Response

Successful Response

questionstring

sample_responseslist of objects

POST

1 curl -X POST https://api.subconscious.ai/personas/generate_questions \
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     "income_levels": [
15       50000,
16       75000
17     ]
18   },
19   "model_dimensions": {
20     "constraints": [
21       "User Review",
22       "Budget"
23     ],
24     "history": [
25       "Previous Phone Brands",
26       "Price Sensitivity"
27     ]
28   },
29   "llm_model": "gpt4"
30 }'

200Successful

1 {
2   "constraints": {
3     "Budget": [
4       {
5         "question": "How much does your budget limit your choice when selecting a mobile phone?",
6         "sample_responses": [
7           {
8             "response": "It is the primary factor, I only consider phones within my budget"
9           },
10           {
11             "response": "It is a major factor, but I might stretch my budget for a good deal"
12           },
13           {
14             "response": "It is somewhat important, but I consider other factors equally"
15           },
16           {
17             "response": "It is a minor factor, I prioritize features over budget"
18           },
19           {
20             "response": "It does not limit my choice at all, I choose based on features and brand"
21           }
22         ]
23       },
24       {
25         "question": "How often do you find yourself compromising on features due to budget constraints when selecting a mobile phone?",
26         "sample_responses": [
27           {
28             "response": "Always"
29           },
30           {
31             "response": "Frequently"
32           },
33           {
34             "response": "Occasionally"
35           },
36           {
37             "response": "Rarely"
38           },
39           {
40             "response": "Never"
41           }
42         ]
43       }
44     ],
45     "User Review": [
46       {
47         "question": "How often do you rely on user reviews when selecting a mobile phone?",
48         "sample_responses": [
49           {
50             "response": "Always"
51           },
52           {
53             "response": "Often"
54           },
55           {
56             "response": "Sometimes"
57           },
58           {
59             "response": "Rarely"
60           },
61           {
62             "response": "Never"
63           }
64         ]
65       },
66       {
67         "question": "To what extent do negative user reviews influence your decision to avoid purchasing a particular mobile phone?",
68         "sample_responses": [
69           {
70             "response": "Significantly"
71           },
72           {
73             "response": "Moderately"
74           },
75           {
76             "response": "Somewhat"
77           },
78           {
79             "response": "Slightly"
80           },
81           {
82             "response": "Not at all"
83           }
84         ]
85       }
86     ]
87   },
88   "history": {
89     "Previous Phone Brands": [
90       {
91         "question": "How often have you purchased the same brand of mobile phone in the past?",
92         "sample_responses": [
93           {
94             "response": "Always"
95           },
96           {
97             "response": "Mostly"
98           },
99           {
100             "response": "Occasionally"
101           },
102           {
103             "response": "Rarely"
104           },
105           {
106             "response": "Never"
107           }
108         ]
109       },
110       {
111         "question": "How satisfied have you been with the mobile phone brands you have used previously?",
112         "sample_responses": [
113           {
114             "response": "Extremely satisfied"
115           },
116           {
117             "response": "Very satisfied"
118           },
119           {
120             "response": "Moderately satisfied"
121           },
122           {
123             "response": "Slightly satisfied"
124           },
125           {
126             "response": "Not satisfied at all"
127           }
128         ]
129       }
130     ],
131     "Price Sensitivity": [
132       {
133         "question": "How often have you chosen a mobile phone based on its price in the past?",
134         "sample_responses": [
135           {
136             "response": "Always"
137           },
138           {
139             "response": "Most of the time"
140           },
141           {
142             "response": "Sometimes"
143           },
144           {
145             "response": "Rarely"
146           },
147           {
148             "response": "Never"
149           }
150         ]
151       },
152       {
153         "question": "When you last purchased a mobile phone, how significant was the price in your decision?",
154         "sample_responses": [
155           {
156             "response": "Extremely significant"
157           },
158           {
159             "response": "Very significant"
160           },
161           {
162             "response": "Moderately significant"
163           },
164           {
165             "response": "Slightly significant"
166           },
167           {
168             "response": "Not significant at all"
169           }
170         ]
171       }
172     ]
173   }
174 }

Built with

1	curl -X POST https://api.subconscious.ai/personas/generate_questions \
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	"income_levels": [
15	50000,
16	75000
17	]
18	},
19	"model_dimensions": {
20	"constraints": [
21	"User Review",
22	"Budget"
23	],
24	"history": [
25	"Previous Phone Brands",
26	"Price Sensitivity"
27	]
28	},
29	"llm_model": "gpt4"
30	}'

1	{
2	"constraints": {
3	"Budget": [
4	{
5	"question": "How much does your budget limit your choice when selecting a mobile phone?",
6	"sample_responses": [
7	{
8	"response": "It is the primary factor, I only consider phones within my budget"
9	},
10	{
11	"response": "It is a major factor, but I might stretch my budget for a good deal"
12	},
13	{
14	"response": "It is somewhat important, but I consider other factors equally"
15	},
16	{
17	"response": "It is a minor factor, I prioritize features over budget"
18	},
19	{
20	"response": "It does not limit my choice at all, I choose based on features and brand"
21	}
22	]
23	},
24	{
25	"question": "How often do you find yourself compromising on features due to budget constraints when selecting a mobile phone?",
26	"sample_responses": [
27	{
28	"response": "Always"
29	},
30	{
31	"response": "Frequently"
32	},
33	{
34	"response": "Occasionally"
35	},
36	{
37	"response": "Rarely"
38	},
39	{
40	"response": "Never"
41	}
42	]
43	}
44	],
45	"User Review": [
46	{
47	"question": "How often do you rely on user reviews when selecting a mobile phone?",
48	"sample_responses": [
49	{
50	"response": "Always"
51	},
52	{
53	"response": "Often"
54	},
55	{
56	"response": "Sometimes"
57	},
58	{
59	"response": "Rarely"
60	},
61	{
62	"response": "Never"
63	}
64	]
65	},
66	{
67	"question": "To what extent do negative user reviews influence your decision to avoid purchasing a particular mobile phone?",
68	"sample_responses": [
69	{
70	"response": "Significantly"
71	},
72	{
73	"response": "Moderately"
74	},
75	{
76	"response": "Somewhat"
77	},
78	{
79	"response": "Slightly"
80	},
81	{
82	"response": "Not at all"
83	}
84	]
85	}
86	]
87	},
88	"history": {
89	"Previous Phone Brands": [
90	{
91	"question": "How often have you purchased the same brand of mobile phone in the past?",
92	"sample_responses": [
93	{
94	"response": "Always"
95	},
96	{
97	"response": "Mostly"
98	},
99	{
100	"response": "Occasionally"
101	},
102	{
103	"response": "Rarely"
104	},
105	{
106	"response": "Never"
107	}
108	]
109	},
110	{
111	"question": "How satisfied have you been with the mobile phone brands you have used previously?",
112	"sample_responses": [
113	{
114	"response": "Extremely satisfied"
115	},
116	{
117	"response": "Very satisfied"
118	},
119	{
120	"response": "Moderately satisfied"
121	},
122	{
123	"response": "Slightly satisfied"
124	},
125	{
126	"response": "Not satisfied at all"
127	}
128	]
129	}
130	],
131	"Price Sensitivity": [
132	{
133	"question": "How often have you chosen a mobile phone based on its price in the past?",
134	"sample_responses": [
135	{
136	"response": "Always"
137	},
138	{
139	"response": "Most of the time"
140	},
141	{
142	"response": "Sometimes"
143	},
144	{
145	"response": "Rarely"
146	},
147	{
148	"response": "Never"
149	}
150	]
151	},
152	{
153	"question": "When you last purchased a mobile phone, how significant was the price in your decision?",
154	"sample_responses": [
155	{
156	"response": "Extremely significant"
157	},
158	{
159	"response": "Very significant"
160	},
161	{
162	"response": "Moderately significant"
163	},
164	{
165	"response": "Slightly significant"
166	},
167	{
168	"response": "Not significant at all"
169	}
170	]
171	}
172	]
173	}
174	}