Legacy Evaluations, Reports, and Datasets remain available for existing projects. Use Tables for new workflows.
Convert a legacy view to a Table
When a legacy Dataset or Evaluation page shows a migration banner, click Convert to Table. PromptLayer creates the Table from the legacy object and opens it so you can review sheets, rows, columns, scoring, and run status before moving production workflows.
Use the conversion button first when it appears. Rebuild manually only when you are working from exports, logs, or a legacy workflow without the banner.
Concept mapping
| Legacy concept | Table concept |
|---|
| Dataset group | Table |
| Dataset row | Table row |
| Dataset column | Text column |
| Dataset version | Sheet version |
| Evaluation pipeline | Sheet with computed columns |
| Evaluation step | Computed column |
| Report run | Recalculation operation |
| Report output | Computed cell output |
| Report score card | Sheet score configuration |
| Report history | History, versions, and score history |
Migration checklist
- Convert from the legacy page when the banner is available.
- Review generated sheets, rows, columns, scoring, and run status.
- For manual rebuilds, import rows from CSV or request history.
- Recreate missing evaluation steps as computed columns.
- Map sources, configure scoring, and rerun stale or pending cells.
- Compare outputs, score, history, and analytics before moving automation to the Tables API.
Manual rebuild shortcuts
Use these paths when conversion is not available.
| Legacy workflow | Table workflow |
|---|
| Dataset from CSV or JSON | Create a Table, click Upload, choose From computer, then add computed columns and scoring in the same sheet. |
| Dataset from request history | Create a Table, click Upload, choose From request history, select requests, then click Add to Sheet. |
| Evaluation pipeline | Put inputs in text columns, add one computed column for each evaluation step, map Prompt Template variables to source columns, run the computed columns, and configure scoring. |
| Report run | Run the Table, a computed column, or selected stale work. Inspect cells in place, then use Score, Analytics, and History to review results. |
Automation mapping
| Legacy automation | Tables API |
|---|
| Create Dataset Group | Create Table |
| Upload Dataset file | Create file import |
| Create Dataset from request logs | Create request-log import |
| Add Evaluation step | Create column |
| Run Report | Create operation |
| Poll Report status | Get operation |
| Read Report score | Get sheet score |
| Save checkpoint | Create sheet version |
Recommended order
Migrate one workflow at a time. Review the generated Table before changing automation, confirm outputs and scores match the old workflow, then move automation to the Tables API. Keep the legacy workflow read-only until the Table is trusted.
