Skip to main content

Overview

Agents (also called Interview Templates) are AI-powered interviewers that conduct conversations with candidates. Each agent can be customized with specific questions, voice characteristics, and evaluation criteria.

Resource Structure

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Technical Screening Agent",
  "description": "Evaluates technical skills for software engineering roles",
  "voice": "professional",
  "interviewType": "technical",
  "questions": [
    "Tell me about your experience with React and modern frontend development",
    "Explain how you would design a scalable microservices architecture",
    "Describe a challenging technical problem you solved recently"
  ],
  "evaluationCriteria": [
    "Technical depth and accuracy",
    "Problem-solving approach",
    "Communication clarity",
    "Real-world experience examples"
  ],
  "maxDuration": 1800,
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

Creating Agents

const agent = await fetch('https://api.instaview.sk/agents', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.INSTAVIEW_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Technical Screening Agent',
    voice: 'professional',
    interviewType: 'technical',
    questions: [
      'Tell me about your React experience',
      'Explain microservices architecture',
      'Describe a technical challenge you overcame'
    ]
  })
});

Voice Options

VoiceDescriptionBest For
professionalClear, neutral, business-appropriateMost interviews
friendlyWarm, approachable toneCulture fit, junior roles
formalSerious, executive-level toneSenior positions

Interview Types

Technical skills assessment
  • Coding questions
  • System design
  • Technology expertise

Best Practices

Clear Questions

Write specific, open-ended questions

Appropriate Duration

15-30 minutes for most interviews

Test First

Test agents before using in production

Iterate

Refine based on interview quality

Next Steps