Skip to content

DCP-2218 feat: add AITB demo and orchestration tools#261

Open
ajmalkhan-eng wants to merge 3 commits intoDCP-2215-prolific-cli-error-handling-refactorfrom
DCP-2218-prolific-cli-aitb-demo-and-orchestration
Open

DCP-2218 feat: add AITB demo and orchestration tools#261
ajmalkhan-eng wants to merge 3 commits intoDCP-2215-prolific-cli-error-handling-refactorfrom
DCP-2218-prolific-cli-aitb-demo-and-orchestration

Conversation

@ajmalkhan-eng
Copy link
Contributor

Summary

This PR adds demo scripts, example files, and orchestration tools for AI Task Builder (AITB), providing a complete end-to-end demonstration of the AITB workflow.

Dependencies

⚠️ Dependency Chain:

Merge order: #259#258#260#261

Changes

Orchestration Demo Script

  • Enhanced aitb-orchestration.go with interactive UI
  • Add step-by-step workflow demonstration
  • Implement progress indicators and status updates
  • Use new UI helper functions for colorful output

Demo Files and Examples

  • Add ASCII art banner for branding
  • Add pairwise-evaluation-instructions.json - Complete example for LLM response evaluation
  • Add pairwise-evaluation.csv and pairwise-evaluation-xmas.csv - Sample datasets
  • Banner file (banner.txt) for terminal display

Example File Fixes

  • Remove invalid answer_limit property from free_text instruction types
  • Remove total_available_places from AITB study examples (auto-calculated by API)

Features Demonstrated

The orchestration script demonstrates the complete AITB workflow:

  1. Dataset Management - Create and upload CSV datasets
  2. Batch Creation - Set up AITB batches with configuration
  3. Instructions - Define evaluation tasks and questions
  4. Study Integration - Link batches to Prolific studies
  5. Response Monitoring - Track participant submissions in real-time

Usage

# Run the interactive demo
go run docs/scripts/aitb-orchestration.go

Testing

The demo script uses the enhanced UI functions and AITB commands to provide a complete, working example of the AITB integration.

Add comprehensive demo script showcasing the full AITB workflow:
- Interactive CLI demonstrating dataset → batch → study flow
- Colorful output using new UI functions
- CSV dataset preview with row counting
- Status polling with spinner animations
- Real-time response tailing functionality
- Parameter extraction from CSV for dynamic study creation
- Retry logic and error handling
- Summary tables and formatted output
Add example files for pairwise evaluation demos:
- pairwise-evaluation.csv: Standard pairwise comparison dataset
- pairwise-evaluation-xmas.csv: Christmas-themed pairwise evaluation data
- pairwise-evaluation-instructions.json: Instructions for pairwise tasks

Add ASCII art banners:
- banner.txt: Prolific ASCII art banner for root directory
- docs/scripts/banner.txt: Banner for orchestration script
- Remove invalid answer_limit property from free_text instructions
- Remove total_available_places from AITB study example as it's auto-calculated
@ajmalkhan-eng ajmalkhan-eng requested a review from a team as a code owner December 7, 2025 23:09
@prolific-snyk
Copy link

prolific-snyk commented Dec 7, 2025

Snyk checks have passed. No issues have been found so far.

Status Scanner Critical High Medium Low Total (0)
Open Source Security 0 0 0 0 0 issues
Licenses 0 0 0 0 0 issues
Code Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

@ajmalkhan-eng ajmalkhan-eng changed the title feat: add AITB demo and orchestration tools DCP-2218 feat: add AITB demo and orchestration tools Dec 7, 2025
Base automatically changed from DCP-2217-prolific-cli-aitb-core-features to DCP-2215-prolific-cli-error-handling-refactor December 11, 2025 02:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants