> ## 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.
# ロール
> ロールやアセスメントの設計図 — ラウンド、ルーブリック、AI インタビュアー、応募フロー。
**ロール** は、採用または評価の対象を定義する設計図です。以下を定義します。
* **ラウンド** — ステップ数（単一ラウンドのスクリーニング、複数ラウンドのファネル）。
[ラウンド](/jp/concepts/rounds) を参照してください。
* **ラウンドごとのルーブリック** — 採点される内容
* **インタビュアー** — 各ラウンドを実施する AI ペルソナ（名前、声、トーン）。
[インタビュアー](/jp/concepts/interviewers) を参照してください。
* **応募フロー** — 公開応募 URL、HR 承認ゲート、OTP
* **ブランディング** — 面接中に候補者が目にするロゴと配色
設定が完了すると、ロールは数千人の候補者と共有したり、プログラムから呼び出したりできます。ルーブリックと会話の挙動は毎回同一です。
## 作成手順をステップごとに
テンプレートはダッシュボードまたは API で作成できます。どちらでも結果は同じです。
チームダッシュボードで、左サイドバーの **Roles** をクリックします。
**New**（または **Create Role**）をクリックします。
**Name** を入力し、**Use case**（Hiring、Admissions、Training など）を選び、**Objective**（面接で見極めるべき唯一の事柄）を記述します。
探りたい **Skills** と、候補者が合格するために満たすべき **Requirements** を列挙します。デフォルトの **duration** と **difficulty** を設定します。
ロールを保存し、1 つ以上の
[ラウンド](/jp/concepts/rounds) を追加します。
`template_name` と `use_case` を設定します。`description` と `objective` を追加します。
`skills`、`requirements`、`default_duration_minutes`、`default_difficulty` を設定します。
```bash theme={null}
curl -X POST "https://www.intervyo.ai/api/v1/roles?accountSlug=" \
-H "x-api-key: iv_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"template_name": "Senior Backend Engineer",
"use_case": "hiring",
"description": "Backend role focused on distributed systems.",
"objective": "Decide if the candidate can own backend system design.",
"skills": ["Go", "PostgreSQL", "Distributed Systems"],
"level": "Senior / 5+ years",
"default_duration_minutes": 45,
"default_difficulty": "advanced"
}'
```
レスポンスでテンプレートの `id` が返されます。ステージや参加者を作成する際にこれを使用します。
## 入力例（ノーコード）
数分でダッシュボードに作成できる、完成済みの **「カスタマーサポートスペシャリスト」** ロールの例を示します。技術的な知識は不要です。
| フィールド | 入力する内容 |
| ---------------- | ------------------------------------------------------------------------------- |
| **Name** | `Customer Support Specialist` |
| **Use case** | `Hiring` |
| **Objective** | `Can this person calm an upset customer and resolve the issue clearly?` |
| **Skills** | `Communication, Empathy, Problem-solving, Product knowledge` |
| **Requirements** | `Stays calm under pressure, follows policy, confirms the fix with the customer` |
| **Duration** | `20 min` · **Difficulty** `Easy` |
保存したら、**ラウンド** を追加します。このロールでは 2 つで十分です。
| # | ラウンド | インタビュアー | 合格点 |
| - | ---------------- | ---------------------------------- | --- |
| 1 | Screening | Friendly Screener | 60 |
| 2 | Support Roleplay | Support Roleplay（AI が怒っている顧客を演じます） | 70 |
これで完成した実用的なセットアップです。候補者を追加する（または応募リンクを共有する）と、AI が面接を処理します。すぐに使えるセットアップ例については、[クックブック](/jp/cookbook/overview) を参照してください。
## 1 つのテンプレートと複数のテンプレートの使い分け
デフォルトです。募集中の各ロールに専用のテンプレートを用意することで、ルーブリックと AI ペルソナを業務に合わせて調整できます。同じ人物が 2 つのロールに応募すると、テンプレートごとに 1 行ずつ、計 2 つの参加者行が作成されます。
人材育成（L\&D）、認定、入学選考向けです。ステージ、合格しきい値、AI ペルソナをコホートごとに一度だけ定義します。参加者は自動的に進行します。
テンプレートのコストは低いものです。フォーク（複製）するか再利用するか迷ったら、フォークしてください。ルーブリックがわずかに異なる 2 つのテンプレートのほうが、条件付き採点を持つ 1 つのテンプレートよりも理解しやすいです。
## 単一ステージと複数ステージ
最もシンプルなテンプレートは **1 つのステージ** だけを持ちます。AI 面接を 1 回行い、採点して終了です。これはほとんどの一次スクリーニングに適した形です。
プログラムやシニア採用では、ステージを連結します。
```text theme={null}
Stage 1: Phone Screen Stage 2: Technical Stage 3: Behavioral
────────────────────────► ────────────────────────► ────────────────────
Communication: 8.5 Code quality: 7.8 Ownership: 8.2
Domain: 7.0 Trade-offs: 8.1 Collaboration: 7.5
passed → auto-advance passed → auto-advance passed → recommend
failed → auto-decline failed → auto-decline failed → archive
```
各ステージには以下があります。
* 独自のルーブリックと合格しきい値
* 独自の AI ペルソナ（ステージ 1 はスクリーニング用ペルソナ、ステージ 2 はシニアエンジニア用ペルソナ）
* 独自の質問バンクまたはコーディング問題プール
プラットフォームは合否判定に基づいて、ステージ間で候補者を自動的に振り分けます。リクルーターは手動で上書きできますが（ボーダーラインの候補者を昇進させる、候補者をレビュー保留にするなど）、デフォルトのフローには人手の介在を必要としません。
## ブランディング + ペルソナ
2 つの要素により、面接を自社のものらしく演出できます。
AI に名前を付け（「Mia」「Aki」「Alex」など）、ペルソナライブラリから声、トーン、語り口を選びます。候補者はインタビュアーを名前で呼び、面接間で一貫性を保てます。
テンプレート詳細ページの **Persona** タブからテンプレートごとに設定するか、API で `personaId` を設定します。
ロゴ、配色、フォント、そして（任意で）カスタムドメイン。候補者は応募ページから面接、フィードバックメールに至るまで、サードパーティの透かしなしに自社のブランドを目にします。
デフォルトではワークスペース単位ですが、エンタープライズプランではマルチブランドのワークフロー（代理店、複数製品を扱う組織）向けにテンプレートごとの上書きをサポートします。
## 公開応募フロー
すべてのテンプレートには、`https://intervyo.ai/apply/` に **公開応募 URL** が用意されています。候補者は以下を行います。
1. URL を開く
2. 6 桁の OTP でメールアドレスを検証する
3. 履歴書（PDF / Word / スキャン）をアップロードする
4. AI による一次スクリーニングをすぐに受ける
応募 URL はテンプレート詳細ページからワンクリックで **ローテーション** できます。漏洩した場合、古い URL は即座に機能しなくなります。
応募と面接の間に **HR 承認** を必須にできます。承認を有効にすると、以下のようになります。
* 候補者の応募がステータス `pending` でパネルに表示されます
* リクルーターが CV のマッチスコアを確認し、履歴書にざっと目を通します
* 承認 → 候補者が面接リンクを受け取ります
* 却下 → 候補者が丁寧なお断りを受け取ります
承認を無効にすると（自動承認）、応募ページが候補者に面接リンクを即座に渡します。すべての CV をレビューすることがボトルネックになる大量採用のロールには、自動承認を使用してください。
## テンプレートごとの参加者モデル
各候補者は **一度に 1 つのテンプレート** に紐付きます。同じメールアドレスが 2 つのテンプレートに応募すると、テンプレートごとに 1 行ずつ、計 2 つの参加者行が作成されます。これにより各ロールのファネルがすっきり保たれ、誤った上書きを防げます。
参加者ページから参加者をテンプレート間で移動できます。プラットフォームが新しいテンプレートに承認済みの応募行を作成するため、その候補者はそのテンプレートのパネルに表示されます。移動操作については、ワークスペース UI の参加者編集フローを参照してください。
## 候補者プロフィールの共有
テンプレートは 2 つの共有モードをサポートします。
* **単一候補者共有** — 1 人の候補者の面接履歴を表示する 1 つの URL。採用パネルや少人数のパネルとの共有向けです。
* **複数候補者共有** — 複数の候補者を並べてランク付けしてまとめる 1 つの URL。代理店ワークフローでのクライアント提出向けです。
どちらのモードも以下を備えます。
* 設定可能な期限（7 / 30 / 90 / 180 日）で失効する
* ワンクリックで取り消せる
* 閲覧回数と最終閲覧日時を表示する
* ステージごとに常に **最新の** セッションを表示する（再試行が自動的に反映されます）
* 受信者側でのログインが不要
共有は、詳細ページのテンプレートの **Share** パネルから設定します。