> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryhamsa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Jobs

> Step-by-step guide to creating AI Docs jobs from transcripts

## Overview

Creating an AI Docs job involves selecting a completed transcript, choosing content templates, configuring settings, and generating structured written content. The system uses AI to transform transcript content into various formats like articles, social media posts, summaries, and FAQs.

<Info>
  AI Docs generation requires a completed Speech to Text transcript. Ensure your transcript is finished before creating an AI Docs job.
</Info>

## Prerequisites

Before creating an AI Docs job:

* **Active project**: Select your project
* **Credit balance**: Ensure sufficient credits
* **Content goals**: Know what type of content you want to generate

## Step-by-Step Process

### Step 1: Select Audio Input

Choose your audio source for transcription:

**Input Methods:**

* **Upload File**: Upload audio/video file
* **YouTube Link**: Paste YouTube video URL
* **Record Audio**: Record directly in browser

**Audio Requirements:**

* Audio file format: MP3, WAV, WEBM, OGG
* Maximum file size: 32MB
* Minimum duration: 30 seconds
* Maximum duration: 2 hours

**Language Selection:**

* Select language spoken in audio
* Affects transcription accuracy
* Used for content generation
* Default: Arabic

### Step 2: Configure Job Details

Enter information about your content:

**Job Title:**

* Descriptive title for the job
* Used for organization
* Maximum length: 255 characters
* Example: "Product Launch Meeting - January 2024"

**Recording Date:**

* Date when audio was recorded
* Optional but recommended
* Helps with context
* Calendar picker available

**Description:**

* Brief description of content
* Helps AI understand context
* Optional but recommended
* Provides additional context

**Participants:**

* List of participants/speakers
* Add one at a time
* Press Space or Enter to add
* Helps identify speakers

**Audience:**

* Target audience for content
* Options: Public, Documentation, Internal Team
* Affects content style
* Required field

**Tone:**

* Desired writing tone
* Options: Friendly, Professional, Informative, Casual, Formal, Persuasive, Authentic
* Affects content style
* Required field

**Output Language:**

* Language for generated content
* Options: Arabic, English, Both (with primary)
* May differ from audio language
* Required field

**Notes:**

* Additional context or instructions
* Optional field
* Helps guide AI generation
* Additional customization

**AI Docs Text:**

* Describe audience, participants, purpose
* Optional but recommended
* Provides context for generation
* Helps tailor content

### Step 3: Select Content Templates

Choose which content types to generate:

**Available Templates:**

* **Social Media Posts**: Posts for social platforms
* **Web Article (SEO-Friendly)**: SEO-optimized articles
* **Summary & Keywords**: Condensed summaries
* **FAQ**: Frequently asked questions

**Template Selection:**

* Select one or more templates
* Each generates different content
* Can select multiple
* All selected templates are generated

**Template Categories:**

* Social media content
* Marketing content
* Documentation
* Educational content

### Step 4: Generate Content

Create the AI Docs job:

1. **Review Settings**

   * Check all entered information
   * Verify template selection
   * Review job details
   * Ensure everything is correct

2. **Submit Job**

   * Click "Submit" or "Generate" button
   * Job is created
   * Processing begins
   * Status indicator shows progress

3. **Monitor Progress**

   * Watch status indicator
   * Processing typically takes minutes
   * Status updates in real-time
   * Completion notification

4. **Job Completion**
   * Status changes to "Completed"
   * Content is available
   * View generated content
   * Edit and customize as needed

## Input Method Details

### File Upload

**Upload Process:**

1. Click "Upload Audio" option
2. Drag and drop file or click to browse
3. File uploads to server
4. Transcription begins automatically

**File Requirements:**

* Formats: MP3, WAV, M4A, WEBM
* Max size: 32MB
* Min duration: 30 seconds
* Max duration: 2 hours

### YouTube Link

**YouTube Process:**

1. Click "YouTube Link" option
2. Paste YouTube video URL
3. System validates URL
4. Audio extracted and transcribed

**URL Requirements:**

* Valid YouTube URL format
* Public or accessible video
* Video with audio track
* Not a live stream (completed only)

### Record Audio

**Recording Process:**

1. Click "Record Audio" option
2. Grant microphone permission
3. Click record button
4. Record audio directly

**Recording Requirements:**

* Microphone access permission
* Minimum 30 seconds
* Maximum 2 hours
* Browser compatibility

## Job Details Configuration

### Required Fields

**Job Title:**

* Must not be empty
* Descriptive name
* Used for organization
* Visible in jobs list

**Audience:**

* Must select one option
* Affects content style
* Important for generation
* Cannot be skipped

**Tone:**

* Must select one option
* Affects writing style
* Important for generation
* Required selection

**Output Language:**

* Must select language
* Content generation language
* May differ from audio
* Required field

### Optional Fields

**Recording Date:**

* Optional but recommended
* Provides context
* Helps with dating content
* Calendar picker

**Description:**

* Optional context
* Helps AI understand
* Additional information
* Free text field

**Participants:**

* Optional list
* Identifies speakers
* Helps with context
* Multiple participants

**Notes:**

* Optional instructions
* Additional guidance
* Custom instructions
* Free text field

**AI Docs Text:**

* Optional description
* Audience and purpose
* Tailors content
* Detailed context

## Template Selection

### Social Media Posts

**Content Type:**

* Posts optimized for social platforms
* Platform-specific formatting
* Engagement-focused
* Shareable content

**Use Cases:**

* Social media campaigns
* Platform posts
* Engagement content
* Marketing posts

### Web Article (SEO-Friendly)

**Content Type:**

* SEO-optimized articles
* Web-ready format
* Search engine friendly
* Professional articles

**Use Cases:**

* Blog posts
* Website articles
* SEO content
* Web publishing

### Summary & Keywords

**Content Type:**

* Condensed summaries
* Key points extraction
* Keyword identification
* Quick overview

**Use Cases:**

* Executive summaries
* Quick reviews
* Key points
* Overviews

### FAQ

**Content Type:**

* Frequently asked questions
* Question-answer format
* Organized structure
* Comprehensive coverage

**Use Cases:**

* Support documentation
* Help articles
* Customer FAQs
* Knowledge base

## Best Practices

### Audio Preparation

**Quality:**

* Clear audio recording
* Minimal background noise
* Adequate volume
* Good microphone quality

**Content:**

* Well-structured conversation
* Clear speaking
* Organized discussion
* Relevant content

### Job Details

**Completeness:**

* Fill all required fields
* Provide optional context
* Accurate information
* Clear descriptions

**Accuracy:**

* Correct dates
* Accurate participants
* Realistic descriptions
* Honest information

### Template Selection

**Relevance:**

* Choose relevant templates
* Match content goals
* Consider use cases
* Select appropriate types

**Quantity:**

* Don't select unnecessary templates
* Focus on needed types
* Generate what you'll use
* Avoid over-generation

## Troubleshooting

### Transcript Not Available

**Issue:** Cannot select transcript

**Solutions:**

* Ensure transcript is completed
* Check transcript status
* Wait for completion
* Verify transcript exists

### Job Creation Fails

**Issue:** Cannot create job

**Solutions:**

* Check required fields
* Verify audio/transcript
* Check credit balance
* Review error messages

### Processing Errors

**Issue:** Job fails to process

**Solutions:**

* Check transcript quality
* Verify settings
* Review error details
* Try again with corrections

## Next Steps

After creating an AI Docs job:

1. **[Managing Content](./managing-content)** - Organize and manage your content
2. **[Overview](./overview)** - Learn about AI Docs features

## Related Documentation

<CardGroup cols={2}>
  <Card title="Managing Content" href="./managing-content">
    Organize and manage your content
  </Card>

  <Card title="Overview" href="./overview">
    Learn about AI Docs features
  </Card>
</CardGroup>
