Bulk AI Tool — Batch AI Processing Service
Overview
The Bulk AI Tool is an on-premises web application hosted on FAU's High Performance Computing (HPC) cluster that lets you run an AI prompt over every row of a dataset and collect structured output automatically. Instead of copying and pasting data into an AI chat tool one record at a time, you upload a spreadsheet or batch of documents, write a single prompt template, define what fields you want extracted, and the tool processes the entire dataset in parallel — returning clean, structured results you can download as a spreadsheet.
How-To Guide & User Reference
|
Field
|
Details
|
|
Service URL
|
https://bulk.ai.hpc.fau.edu
|
|
Category
|
Research Computing
|
|
Audience
|
FAU Faculty, Staff, and Researchers
|
|
Authentication
|
FAU Microsoft Entra ID (single sign-on)
|
|
Max File Size
|
10 MB per file
|
|
Supported Inputs
|
CSV, TXT, PDF, DOCX, DOC
|
|
Output Formats
|
JSON (per-row structured output), CSV download
|
Overview
The Bulk AI Tool is an on-premises web application hosted on FAU's High Performance Computing (HPC) cluster that lets you run an AI prompt over every row of a dataset and collect structured output automatically. Instead of copying and pasting data into an AI chat tool one record at a time, you upload a spreadsheet or batch of documents, write a single prompt template, define what fields you want extracted, and the tool processes the entire dataset in parallel — returning clean, structured results you can download as a spreadsheet.
All processing runs entirely within FAU's infrastructure using the FAU HPC LiteLLM proxy. No data is sent to external cloud services.
Example Use Cases
What You Can Do
-
Define a structured output schema — name the fields you want and choose their data type (text, number, boolean, or list).
Before You Begin
-
Your input data is in one of the supported formats: CSV, TXT, PDF, DOCX, or DOC.
Note: The Bulk AI Tool uses FAU's Microsoft Entra ID for authentication. You will be redirected to the FAU single sign-on page automatically when you visit the service URL.
Accessing the Service
-
Open a browser and navigate to https://bulk.ai.hpc.fau.edu.
-
You will be redirected to the FAU SSO login page. Sign in with your FAU email address and password.
-
Complete multi-factor authentication (MFA) if prompted.
-
Once authenticated, the Bulk AI Tool home page will load.
Running a Bulk AI Job
Step 1 — Upload Your Data
-
In the Upload section, drag and drop your file into the upload area, or click to browse and select a file.
-
The app will parse your file and display the column headers it detected.
-
Review the headers. For CSV files, these come from the first row. For PDFs and Word documents, the app maps the document text to a set of default column names automatically.
-
Supported formats: CSV, TXT, PDF, DOCX, DOC.
Note: You can also load a sample dataset from the built-in demo data to try the tool before uploading your own files.
Step 2 — Write a Prompt Template
The prompt template tells the AI what to do with each row. Use double curly braces around a column name to insert that row's value into the prompt.
Example — if your CSV has columns named "Student Name" and "Comment":
Analyze the following student course evaluation comment and rate the overall sentiment.
Student: {{Student Name}}
Comment: {{Comment}}
Step 3 — Define an Output Schema
The output schema tells the AI exactly which fields to return for each row and what data type each field should be. This ensures results come back as clean, structured data rather than free-form text.
-
In the Schema section, click Add Field.
-
Enter a field name (letters, numbers, and underscores only — no spaces).
-
Choose a type: Text, Number, Boolean (true/false), or List.
-
Repeat for each field you want in the output.
Example schema for the course evaluation use case above:
|
Field Name
|
Type
|
|
sentiment
|
Text (e.g. positive, neutral, negative)
|
|
confidence
|
Number (e.g. 0.0 – 1.0)
|
|
key_themes
|
List (e.g. ["workload", "clarity"])
|
|
actionable
|
Boolean (true if the comment suggests a specific improvement)
|
Note: Field names must be unique. The schema builder will flag duplicates before you run the job, since duplicate names produce ambiguous output.
Step 4 — (Optional) Use the AI Assistant
If you are unsure how to write a prompt or structure your schema, the built-in AI assistant can help. Click the Assistant panel, describe what you are trying to accomplish in plain language, and the assistant will suggest a prompt template and output schema tailored to your dataset.
Step 5 — Test on a Single Row
-
Before running the full dataset, click Test Row.
-
The app will run your prompt and schema against the first row of your data and return the result immediately.
-
Review the output. If the fields are not what you expected, adjust your prompt or schema and test again.
Note: Always test at least one row before running a large batch. This saves time and avoids running hundreds of rows with a poorly worded prompt.
Step 6 — Run the Full Batch
-
Select the AI model you want to use from the model dropdown. The default model is Gemini 2.5 Flash, which is recommended for most tasks.
-
Click Run Bulk Job.
-
The app processes up to 20 rows at a time in parallel. A progress indicator shows how many rows have been completed.
-
When all rows are finished, the results appear in the Results section.
Important: Large datasets (hundreds or thousands of rows) may take several minutes to complete. Do not close or refresh the browser tab while a job is running, as this will interrupt the batch.
Downloading Results
When a batch job completes, you can download the results in two formats:
Click the Download CSV or Download JSON button in the Results section to save the file to your computer.
Note: If email delivery is enabled for your deployment, you can also choose to receive the results as email attachments when the job completes. Check with your Research Computing contact to confirm whether this feature is available.
Choosing an AI Model
The model dropdown lists the AI models available through the FAU HPC. A status indicator shows whether the proxy is currently reachable.
|
Provider
|
Description
|
|
Cloud
|
Cloud provider frontier models (Gemini, OpenAI, Grok, etc.). Best for most use cases, especially advanced or complex reasoning.
|
|
HPC
|
On-premise open source models running on FAU's HPC hardware. Best for quick, efficient tasks with limited reasoning effort (classification, summarization, etc.).
|
Troubleshooting
|
Symptom
|
Likely Cause
|
Resolution
|
|
Page shows an error or does not load after sign-in.
|
Authentication service may be temporarily unavailable.
|
Wait 1–2 minutes and refresh. If the error persists, contact Research Computing.
|
|
File upload fails or shows an error.
|
File may exceed the 10 MB limit or be in an unsupported format.
|
Check the file size and format. Supported formats are CSV, TXT, PDF, DOCX, and DOC. Split large files into smaller batches.
|
|
Headers are not detected correctly after upload.
|
CSV may have an irregular format, or a PDF/Word file has no clearly structured text.
|
For CSV files, ensure the first row contains column headers with no merged cells or extra blank rows. For PDFs and Word docs, the app maps text to a default column structure automatically — review and adjust the prompt to match.
|
|
Test row returns unexpected or empty output.
|
Prompt template may be unclear, or the schema field names may conflict with the model's output.
|
Simplify the prompt. Remove unnecessary context. Ensure field names are short, descriptive, and unique. Use the AI assistant to help refine the prompt and schema.
|
|
Batch job runs but many rows show as failed.
|
Individual row values may be empty, malformed, or containcontent the model could not parse.
|
Review failed rows in the results. Rows fail individually — the rest of the batch still completes. Clean the input data and re-run just the failed rows by filtering your CSV before re-uploading.
|
|
Proxy status shows unavailable.
|
FAU HPC AI service may be temporarily down.
|
Wait a few minutes and refresh the page. If the issue persists for more than 15 minutes, contact Research Computing.
|
|
Results CSV has columns in an unexpected order or missing fields.
|
Output schema fields may have been reordered or a field name was changed after testing.
|
The CSV column order matches the schema field order at the time the job was run. If fields are missing, check that the schema was saved correctly before running.
|
Data and Privacy
-
All files using local models are processed within FAU's on-premises HPC infrastructure, meaning no data is sent off FAU servers. If cloud is the selected provider, data is sent to the cloud provider but is under FAU's data privacy agreement with those providers.
-
Usage is logged per job (not per row) for service accounting purposes. Logged fields include your FAU email, the model used, the number of rows, and processing duration. Individual row data is not logged.
-
Do not upload documents containing sensitive personal information (FERPA-protected student records, HIPAA-protected health information, or other regulated data) without first confirming the appropriate data handling procedures with the FAU Office of Information Technology.
Tips for Best Results
-
Use short, clear field names. Field names become JSON keys. Avoid spaces and special characters. Good examples: sentiment, confidence_score, is_actionable.
Contact and Support
For issues with this service, submit a ticket through the FAU Help Desk or contact Research Computing directly.