Upload from the AI Training tab after you sign in with AIs Social and select a workspace. The file becomes a draft project in that workspace. Open it when trainers should start. One file can hold up to 5,000 comparisons and 20 MB.
CSV, TSV, or an Excel workbook (.xlsx). The first row is the header. The first sheet is the one that is read.
prompt,response_a,response_b Summarize the note.,The note says the gate closes at dusk.,I don't know. Name a primary color.,Red.,Happiness.
These headers mean the same thing:
| Prompt | Response A | Response B |
|---|---|---|
| prompt, instruction, question, input | response_a, answer_a, completion_a, left | response_b, answer_b, completion_b, right |
A sheet whose headers are the model names works too. prompt, gpt-4, claude loads gpt-4 as response A and claude as response B, in that column order.
A file with no header row is read as three columns: prompt, response A, response B.
chosen and rejected are accepted. Chosen is loaded as response A, so a trainer can see which answer was already preferred. response_a and response_b keep that label off the task.
An image comparison uses https links in the sheet. The trainer’s page displays those pictures. Pictures pasted or embedded inside the workbook are not read.
prompt,image_a,image_b Which photo is sharper?,https://cdn.example.com/left.jpg,https://cdn.example.com/right.jpg
These headers mean the same thing: image_a, image_a_url, picture_a, photo_a, left_image, image1 and the matching names for image B. Both links must start with https:// or http://.
When both image links are present, the response text can be left out. A text-only file with prompt, response_a, and response_b stays valid. You can include both the text and the image links in the same row.
prompt,response_a,response_b,image_a,image_b Describe the scene.,A quiet street.,A crowded market.,https://cdn.example.com/a.jpg,https://cdn.example.com/b.jpg
A .json file is a list of comparisons, or one object with a data, rows, examples, items, or comparisons list.
[
{
"prompt": "Summarize the note.",
"response_a": "The note says the gate closes at dusk.",
"response_b": "I don't know."
}
]
A pair can also be responses, completions, answers, or outputs with two strings. The first string is response A. Image links use image_a and image_b, or an images list of two https URLs.
{
"prompt": "Which photo is sharper?",
"image_a": "https://cdn.example.com/left.jpg",
"image_b": "https://cdn.example.com/right.jpg"
}
A .jsonl file has one comparison per line. Image rows use the same image_a and image_b links.
{"prompt":"Summarize the note.","response_a":"The note says the gate closes at dusk.","response_b":"I don't know."}
{"prompt":"Name a primary color.","chosen":"Red.","rejected":"Happiness."}
Older .xls workbooks need to be saved as .xlsx or CSV first. Numbers, Parquet, PDF, and Word files are outside this upload.
Email that file to support@ifusionsoft.com and include the workspace name. We will load it into that workspace.
The button on AI Training sends the signed-in session. The same call is available to a script that already signed in.
POST /api/aissocial/training/batch Content-Type: multipart/form-data X-CSRF-Token: the csrf_token from GET /api/aissocial/me workspace_id the workspace you belong to as owner or admin title optional project name brief optional trainer instructions file the spreadsheet, JSON, or JSONL file
The session cookie is the AIs Social login. A trainer who is only a member cannot upload. The new project stays a draft until an owner or admin opens it.