ラウンドとは、ロールの中の1つのステップです。
ロールが旅全体だとすれば、ラウンドは候補者が通り抜ける1枚の扉です。
ラウンドは1つ（手早いスクリーニング）でも、連続した複数（スクリーニング →
技術 → 最終）でも構いません。各ラウンドはそれぞれ独自の面接を実施します。
ラウンドのつながり方
Role: "Senior Backend Engineer"
Round 1: Phone Screen → Round 2: Technical → Round 3: Final
pass? advance pass? advance pass? recommend
各フィールドをわかりやすく
ステップの短いラベル。例: "technical"。
候補者に表示される名前。例: "Technical Screen"。
形式: ai_interview、roleplay_simulation、practice_session、
manual_review、async_assessment、または final_review。
並び順での位置。0 が最初、1 が次、というように続きます。
不合格の場合、候補者は再挑戦できるか？ デフォルトは false。
automation_rule
none | auto_advance | require_reviewer_approval
ステップが終了したときに何が起きるか:
auto_advance — 自動的に次へ進むrequire_reviewer_approval — 人間の承認を待つnone — 自動では何もしない
ステージを構築する手順
ステージはテンプレートの中に存在するため、ダッシュボードまたはAPIを
通じて、テンプレートから追加します。
ロールを開く
左サイドバーでロールをクリックし、ラウンドを追加したいものを
開きます。
ラウンドを追加する
ロールのラウンドセクションで、ラウンドを追加をクリックします。
名前を付けて形式を選ぶ
タイトルとtype（AI面接、ロールプレイ、練習など）を設定します。
面接官を選ぶ
このラウンドを実施する面接官を選びます。
並び順と合格基準を設定する
並び順と合格しきい値を設定し、完了時の動作（自動で進む、または
承認を待つ）を選択します。
保存する
ステージを保存します。これを繰り返して複数ラウンドのパイプラインを構築します。
テンプレートとエージェントを用意する
role_id と（通常は）interviewer_id が必要です。
ステップに名前を付けて形式を選ぶ
stage_name と stage_type を設定します。
並び順と合格基準を設定する
stage_order（0 から開始）と pass_threshold を設定します。
リクエストを送信する
curl -X POST "https://www.intervyo.ai/api/v1/rounds?accountSlug=<slug>" \
-H "x-api-key: iv_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"role_id": "ce1cd564-...",
"type": "technical",
"stage_name": "Technical Screen",
"stage_type": "ai_interview",
"stage_order": 0,
"duration_minutes": 45,
"pass_threshold": 70,
"automation_rule": "auto_advance",
"interviewer_id": "455b1513-..."
}'
ユースケースごとの例
複数のステップ、上がっていく基準、そして最後のラウンドの前の人間によるチェック。[
{ "stage_name": "Phone Screen", "stage_type": "ai_interview", "stage_order": 0, "pass_threshold": 60, "automation_rule": "auto_advance" },
{ "stage_name": "Technical", "stage_type": "ai_interview", "stage_order": 1, "pass_threshold": 75, "automation_rule": "require_reviewer_approval" },
{ "stage_name": "Final", "stage_type": "final_review", "stage_order": 2, "pass_threshold": 80 }
]
再挑戦できる練習ステップ。ゲートはありません。目標は上達することです。[
{ "stage_name": "Discovery Drill", "stage_type": "roleplay_simulation", "stage_order": 0, "allow_retake": true, "pass_threshold": 70 },
{ "stage_name": "Objection Drill", "stage_type": "roleplay_simulation", "stage_order": 1, "allow_retake": true, "pass_threshold": 70 }
]
本人が好きなだけ繰り返せる、たった1つのステップ。[
{ "stage_name": "Mock Round", "stage_type": "practice_session", "stage_order": 0, "allow_retake": true, "duration_minutes": 45 }
]
次のステップ
ラウンドを作成する（API）
エンドポイントの完全なリファレンス。
