> ## 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/rounds) を実施する AI ペルソナです。
AI に **誰として振る舞うか** と **どう採点するか** を指示します。つまり、
人格と評価表（レポートカード）をひとまとめにしたものです。

インタビュアーは一度作成すれば、**複数のラウンドやロールにわたって再利用** できます。
（たとえば、1 つの「ITOM スペシャリスト」インタビュアーで、複数の異なる [ロール](/jp/concepts/roles) の ITOM ラウンドを実施できます。）

## 制御する内容

<CardGroup cols={3}>
  <Card title="誰であるか" icon="user-round">
    候補者が対話する相手の名前と人格。
  </Card>

  <Card title="どう話すか" icon="messages-square">
    親しみやすいか厳しいか、易しいか難しいか、深く掘り下げるか軽く触れるか。
  </Card>

  <Card title="どう採点するか" icon="sliders">
    採点する項目の一覧と、各項目の重み付け。
  </Card>
</CardGroup>

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

<ParamField path="name" type="string" required>
  `"Senior Backend Interviewer"` のような、あなた向けのラベル。
</ParamField>

<ParamField path="persona" type="string" required>
  `"Hi, I'm Alex, a senior engineer."` のように、AI が自分自身について最初に話す内容。これが雰囲気を決めます。
</ParamField>

<ParamField path="useCase" type="hiring | admissions | training | custom_api" required>
  面接の目的を選びます。これにより最終評定の文言が変わります（たとえば *採用* と *もっと練習が必要* など）。
</ParamField>

<ParamField path="evaluationDimensions" type="array" required>
  採点する項目。各項目は `{ name, description, weight }` です。**重みの合計は 100 になる必要があります**。例: システム設計 50、コーディング 30、コミュニケーション 20。
</ParamField>

<ParamField path="interaction" type="object">
  対話の雰囲気:

  * `tone` — friendly、professional、strict、または challenging
  * `style` — structured、conversational、または adaptive
  * `difficulty` — easy、medium、hard、または adaptive
  * `probingDepth` — low、medium、または high（どれだけ深く掘り下げるか）
</ParamField>

<ParamField path="scoring" type="object">
  数値の算出方法: `scale`（0-10、0-5、または 0-100）と `scoringMethod`（weighted\_average または rule\_based）。
</ParamField>

<ParamField path="context" type="object">
  AI が場にふさわしく聞こえるための追加の背景情報: `organizationContext`、`domainContext`、`scenarioContext`。
</ParamField>

<ParamField path="output" type="object">
  レポートに含まれる内容: `includeTranscript`、`includeScoreBreakdown`、`includeRecommendation`、`includeImprovementFeedback`。すべてデフォルトで有効です。
</ParamField>

## 作成手順をステップごとに

これは 2 通りの方法で行えます。ダッシュボード（ノーコード）か API です。どちらもまったく同じものを作成します。

<Tabs>
  <Tab title="Dashboard (UI)">
    <Steps>
      <Step title="Interviewers を開く">
        チームダッシュボードで、左サイドバーの **Interviewers** をクリックします。
      </Step>

      <Step title="新規作成を開始する">
        **New**（または **Create Interviewer**）をクリックします。
      </Step>

      <Step title="名前と人格を設定する">
        **Name** と **Persona**（AI がどう自己紹介するかを 1 文で）を入力します。
      </Step>

      <Step title="ユースケースを選ぶ">
        **Use case**（Hiring、Admissions、Training など）を選択します。
      </Step>

      <Step title="採点する項目を追加する">
        2〜4 個の **評価ディメンション** を追加し、合計が **100** になるよう各項目の重みを設定します。**tone** と **difficulty** も設定します。
      </Step>

      <Step title="保存する">
        **Save** をクリックします。これでインタビュアーが一覧に表示され、ラウンドに紐付ける準備が整います。
      </Step>
    </Steps>
  </Tab>

  <Tab title="API">
    <Steps>
      <Step title="名前と人格を設定する">
        `name` と `persona` を選びます。ペルソナは 1 文に収めてください。
      </Step>

      <Step title="ユースケースを選ぶ">
        目的に合わせて `useCase` を設定します（`hiring`、`training` など）。
      </Step>

      <Step title="採点する項目を列挙する">
        2〜4 個の `evaluationDimensions` を追加します。`weight` の値の合計が 100 になるようにします。
      </Step>

      <Step title="リクエストを送信する">
        ```bash theme={null}
        curl -X POST "https://www.intervyo.ai/api/v1/interviewers?accountSlug=<slug>" \
          -H "x-api-key: iv_live_your_key_here" \
          -H "Content-Type: application/json" \
          -d '{
            "name": "Senior Hiring Agent",
            "persona": "Alex, a senior engineer at Acme.",
            "useCase": "hiring",
            "evaluationDimensions": [
              { "name": "Technical Depth", "description": "System design & coding", "weight": 60 },
              { "name": "Communication",   "description": "Explains clearly",        "weight": 40 }
            ],
            "interaction": { "tone": "professional", "difficulty": "hard", "probingDepth": "high" }
          }'
        ```
      </Step>

      <Step title="ID を保存する">
        レスポンスで `id` が返されます。これは後でステージに紐付けます。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 入力例（ノーコード）

技術者でない方向けに、シンプルな **「フレンドリースクリーナー」** を作るために各ダッシュボードフィールドへ入力する内容をそのまま示します。これは、ほとんどどの職種にも再利用できる、温かみのある一次面接インタビュアーです。

| フィールド           | 入力する内容                                                                | 理由                           |
| --------------- | --------------------------------------------------------------------- | ---------------------------- |
| **Name**        | `Friendly Screener`                                                   | 一覧用のラベルにすぎません。候補者には表示されません。  |
| **Persona**     | `Hi, I'm Riya. I'll ask a few quick questions about your background.` | AI の最初のあいさつ。親しみやすい 1 文に収めます。 |
| **Use case**    | `Hiring`                                                              | 評定の文言（採用 / 不採用）を決めます。        |
| **Dimension 1** | `Communication` — 重み `40`                                             | 候補者がどれだけ明確に説明できるか。           |
| **Dimension 2** | `Motivation` — 重み `30`                                                | なぜそのロールを希望するのか。              |
| **Dimension 3** | `Relevant experience` — 重み `30`                                       | 基本的な要件を満たしているか。              |
| **Tone**        | `Friendly`                                                            | 威圧的でなく、温かく。                  |
| **Difficulty**  | `Easy`                                                                | 深掘りではなく一次スクリーニングなので。         |

3 つの重みの合計は **100** になります。これが唯一のルールです。**Save** をクリックすれば、フレンドリースクリーナーはどのロールの最初のラウンドにも組み込める状態になります。

<Tip>
  作り直すより再利用が勝ります。この 1 つのインタビュアーで、エンジニアリングロール、セールスロール、サポートロールの最初のラウンドを実施できます。一度作ればよいのです。
</Tip>

## 各ユースケースの例

<Tabs>
  <Tab title="Hiring">
    厳格でスキル重視。

    ```json theme={null}
    {
      "name": "Backend Hiring Agent",
      "persona": "Alex, a staff engineer.",
      "useCase": "hiring",
      "evaluationDimensions": [
        { "name": "System Design", "description": "Scalable design", "weight": 50 },
        { "name": "Coding",        "description": "Correct & clean", "weight": 30 },
        { "name": "Communication", "description": "Clear trade-offs", "weight": 20 }
      ],
      "interaction": { "tone": "professional", "difficulty": "hard" }
    }
    ```
  </Tab>

  <Tab title="Training">
    優しくコーチング的で、学習を継続できるように。

    ```json theme={null}
    {
      "name": "Sales Coach",
      "persona": "Sam, a friendly sales coach.",
      "useCase": "training",
      "evaluationDimensions": [
        { "name": "Discovery",         "description": "Finds the pain", "weight": 50 },
        { "name": "Objection Handling","description": "Handles pushback","weight": 50 }
      ],
      "interaction": { "tone": "friendly", "difficulty": "adaptive" }
    }
    ```
  </Tab>

  <Tab title="Mock interview">
    本番さながらでありながら励ましがあり、フィードバックが豊富。

    ```json theme={null}
    {
      "name": "Mock Interviewer",
      "persona": "Jordan, a big-tech interviewer.",
      "useCase": "training",
      "evaluationDimensions": [
        { "name": "Problem Solving", "description": "Approach & edge cases", "weight": 60 },
        { "name": "Communication",   "description": "Thinks out loud",       "weight": 40 }
      ],
      "interaction": { "tone": "challenging", "difficulty": "hard" },
      "output": { "includeImprovementFeedback": true }
    }
    ```
  </Tab>
</Tabs>

<Tip>
  重み付けに迷ったら、大きなディメンション 1 つ（60）と小さなディメンション 1 つ（40）から始め、数回の面接を経て調整してください。
</Tip>

## 次のステップ

<CardGroup cols={2}>
  <Card title="ロール" icon="file-text" href="/jp/concepts/roles">
    ロールの中でインタビュアーを活用しましょう。
  </Card>

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