Language Tasks

​

Functions

​

GetHighlight

GetHighlight(Transcription: str) -> tuple[int, int]

0.0 - 2.5: Hello and welcome
2.5 - 5.2: Today we'll discuss AI
5.2 - 8.4: and its applications

​

Selection Criteria

• Interesting: Contains valuable or engaging content
• Useful: Provides actionable information or insights
• Surprising: Includes unexpected or novel information
• Controversial: Presents thought-provoking viewpoints
• Complete: Contains only full sentences forming complete thoughts
• Duration: Approximately 2 minutes long

​

Features

• Smart Segment Selection: Uses GPT-4o-mini to understand context and content quality
• Complete Sentences: Ensures selected text doesn’t cut sentences mid-way
• Structured Output: Uses function calling for reliable JSON responses
• Validation: Checks for valid time ranges and positive durations
• Error Recovery: Interactive retry option if segment selection fails
• Detailed Logging: Prints selected segment details for verification

from Components.LanguageTasks import GetHighlight

# Build timestamped transcription
transcription_text = """
0.0 - 2.5: Hello and welcome to this video
2.5 - 5.2: Today we'll be discussing AI
5.2 - 8.4: and its applications in video processing
8.4 - 120.0: [Rest of transcription...]
"""

# Get highlight segment
start, end = GetHighlight(transcription_text)

if start is not None and end is not None:
    print(f"Best highlight: {start}s to {end}s ({end-start}s duration)")
    # Output: Best highlight: 5s to 125s (120s duration)
else:
    print("Failed to get highlight")

​

Response Structure

class JSONResponse(BaseModel):
    start: float  # Start time in seconds
    content: str  # The transcribed text from the segment
    end: float    # End time in seconds

​

Validation

# Checks for empty response
if not response:
    return None, None

# Checks for required fields
if not hasattr(response, 'start') or not hasattr(response, 'end'):
    return None, None

# Parse times
Start = int(response.start)
End = int(response.end)

# Check for negative values
if Start < 0 or End < 0:
    print("ERROR: Negative time values")
    return None, None

# Check for valid range
if End <= Start:
    print("ERROR: Invalid time range (end must be > start)")
    return None, None

# Interactive retry for invalid segments
if Start == End:
    Ask = input("Error - Get Highlights again (y/n) -> ").lower()
    if Ask == "y":
        Start, End = GetHighlight(Transcription)
    return Start, End

​

Detailed Logging

print(f"\n{'='*60}")
print(f"SELECTED SEGMENT DETAILS:")
print(f"Time: {Start}s - {End}s ({End-Start}s duration)")
print(f"Content: {response.content}")
print(f"{'='*60}\n")

​

Configuration

​

Environment Variables

OPENAI_API=sk-your-api-key-here

​

Error Handling

try:
    start, end = GetHighlight(transcription)
except Exception as e:
    print(f"ERROR IN GetHighlight FUNCTION:")
    print(f"Exception type: {type(e).__name__}")
    print(f"Exception message: {str(e)}")
    print(f"Transcription length: {len(transcription)} characters")

• Invalid or missing OpenAI API key
• API rate limiting
• Network connectivity issues
• Malformed transcription data
• AI returns invalid time ranges

​

System Prompt

The input contains a timestamped transcription of a video.
Select a 2-minute segment from the transcription that contains something 
interesting, useful, surprising, controversial, or thought-provoking.

The selected text should contain only complete sentences.
Do not cut the sentences in the middle.
The selected text should form a complete thought.

​

Dependencies

• langchain-openai: For ChatOpenAI interface
• pydantic: For structured output validation
• python-dotenv: For environment variable loading
• OpenAI API key with GPT-4o-mini access