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

# ラウンド

> ラウンドとは何か、各フィールドをわかりやすく解説し、パイプラインの構築方法を説明します。採用、トレーニング、模擬面接の例つき。

**ラウンド**とは、[ロール](/jp/concepts/roles)の中の**1つのステップ**です。
ロールが旅全体だとすれば、ラウンドは候補者が通り抜ける1枚の扉です。

ラウンドは1つ（手早いスクリーニング）でも、連続した複数（スクリーニング →
技術 → 最終）でも構いません。各ラウンドはそれぞれ独自の面接を実施します。

## ラウンドのつながり方

```text theme={null}
Role: "Senior Backend Engineer"
   Round 1: Phone Screen   →   Round 2: Technical   →   Round 3: Final
   pass? advance               pass? advance             pass? recommend
```

各ラウンドは**面接官**（そのステップ用のAIペルソナ）を指し示し、独自の
合格基準を持ちます。

## 各フィールドをわかりやすく

<ParamField path="role_id" type="uuid" required>
  このステージが属するテンプレート。
</ParamField>

<ParamField path="type" type="string" required>
  ステップの短いラベル。例: `"technical"`。
</ParamField>

<ParamField path="stage_name" type="string">
  候補者に表示される名前。例: `"Technical Screen"`。
</ParamField>

<ParamField path="stage_type" type="enum">
  形式: `ai_interview`、`roleplay_simulation`、`practice_session`、
  `manual_review`、`async_assessment`、または `final_review`。
</ParamField>

<ParamField path="interviewer_id" type="uuid">
  このステップを実施する面接官。
</ParamField>

<ParamField path="stage_order" type="integer">
  並び順での位置。`0` が最初、`1` が次、というように続きます。
</ParamField>

<ParamField path="duration_minutes" type="integer">
  面接の長さ（デフォルト `30`）。
</ParamField>

<ParamField path="pass_threshold" type="number (0–100)">
  このステップに合格するために必要なスコア。
</ParamField>

<ParamField path="allow_retake" type="boolean">
  不合格の場合、候補者は再挑戦できるか？ デフォルトは `false`。
</ParamField>

<ParamField path="automation_rule" type="none | auto_advance | require_reviewer_approval">
  ステップが終了したときに何が起きるか:

  * `auto_advance` — 自動的に次へ進む
  * `require_reviewer_approval` — 人間の承認を待つ
  * `none` — 自動では何もしない
</ParamField>

## ステージを構築する手順

ステージは**テンプレートの中**に存在するため、ダッシュボードまたはAPIを
通じて、テンプレートから追加します。

<Tabs>
  <Tab title="ダッシュボード（UI）">
    <Steps>
      <Step title="ロールを開く">
        左サイドバーで**ロール**をクリックし、ラウンドを追加したいものを
        開きます。
      </Step>

      <Step title="ラウンドを追加する">
        ロールの**ラウンド**セクションで、**ラウンドを追加**をクリックします。
      </Step>

      <Step title="名前を付けて形式を選ぶ">
        **タイトル**と**type**（AI面接、ロールプレイ、練習など）を設定します。
      </Step>

      <Step title="面接官を選ぶ">
        このラウンドを実施する**面接官**を選びます。
      </Step>

      <Step title="並び順と合格基準を設定する">
        **並び順**と**合格しきい値**を設定し、完了時の動作（自動で進む、または
        承認を待つ）を選択します。
      </Step>

      <Step title="保存する">
        ステージを保存します。これを繰り返して複数ラウンドのパイプラインを構築します。
      </Step>
    </Steps>
  </Tab>

  <Tab title="API">
    <Steps>
      <Step title="テンプレートとエージェントを用意する">
        `role_id` と（通常は）`interviewer_id` が必要です。
      </Step>

      <Step title="ステップに名前を付けて形式を選ぶ">
        `stage_name` と `stage_type` を設定します。
      </Step>

      <Step title="並び順と合格基準を設定する">
        `stage_order`（`0` から開始）と `pass_threshold` を設定します。
      </Step>

      <Step title="リクエストを送信する">
        ```bash theme={null}
        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-..."
          }'
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## ユースケースごとの例

<Tabs>
  <Tab title="採用">
    複数のステップ、上がっていく基準、そして最後のラウンドの前の人間によるチェック。

    ```json theme={null}
    [
      { "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 }
    ]
    ```
  </Tab>

  <Tab title="トレーニング">
    再挑戦できる練習ステップ。ゲートはありません。目標は上達することです。

    ```json theme={null}
    [
      { "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 }
    ]
    ```
  </Tab>

  <Tab title="模擬面接">
    本人が好きなだけ繰り返せる、たった1つのステップ。

    ```json theme={null}
    [
      { "stage_name": "Mock Round", "stage_type": "practice_session", "stage_order": 0, "allow_retake": true, "duration_minutes": 45 }
    ]
    ```
  </Tab>
</Tabs>

## 次のステップ

<CardGroup cols={2}>
  <Card title="参加者" icon="user" href="/jp/concepts/participants">
    ラウンドを通過する人々を追加します。
  </Card>

  <Card title="ラウンドを作成する（API）" icon="terminal" href="/api-reference/rounds/post-rounds">
    エンドポイントの完全なリファレンス。
  </Card>
</CardGroup>