Blueprint AI Work Simulation Exercise

This repository contains a full-stack application scaffold for a work simulation exercise. The goal is to evaluate your ability to work with AI technologies and build a simple question-answering agent.

Project Overview

The project consists of:

• A React frontend (client)
• A NestJS backend (api)
• A PostgreSQL database
• A sample transcript for the AI agent to analyze

Getting Started

1. Clone this repository
2. From the root of the project, start the application:

   docker compose up --build

3. In a new terminal, run the database migrations:

   docker compose run api npm run migration:up

4. Visit localhost:5173 to verify the application is running

The Challenge

Your task is to create a simple AI agent that can answer questions about the contents of a provided transcript. The transcript will be available in the api/data/transcript.txt file.

Requirements

1. Create an endpoint in the API that accepts questions about the transcript
2. Implement a basic agent that can:
   • Read and understand the transcript
   • Answer questions about its contents
   • Provide relevant quotes or references when appropriate
3. Add a simple interface in the frontend to:
   • Display the transcript
   • Allow users to ask questions
   • Show the agent's responses

Evaluation Criteria

Your solution will be evaluated on:

• Code organization and quality
• Implementation of the AI agent
• User interface design and experience
• Error handling and edge cases
• Documentation and comments

Time Expectations

Plan to spend about 4 hours to complete this exercise. Focus on delivering a working solution that demonstrates your understanding of AI concepts and software engineering principles.

Project Structure

• /api - Backend Node.js application
• /client - Frontend React application
• /api/data - Contains the transcript file
• docker-compose.yml - Docker configuration for all services

Available Scripts

In the API directory:

• npm run dev - Start the development server
• npm run migration:up - Run database migrations
• npm run test - Run tests

In the Client directory:

• npm run dev - Start the development server
• npm run build - Build for production
• npm run test - Run tests

Submission

When you're done:

1. Push your changes to your fork of this repository and make it public
2. Send us the link to your repository
3. Include any additional notes or documentation about your implementation

Good luck!