> ## 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.

# クイックスタート

> 5 分で最初の AI 面接を実施します。UI または API のいずれかで進められます。

Role をセットアップし、候補者を面接へと進め、候補者が面接を終えてからおよそ 2 分以内に採点済みのトランスクリプトを確認します。自分に合った方法を選んでください。

<Tabs>
  <Tab title="UI で（コード不要）">
    最速の方法です。API には一切触れたくない採用マネージャー、リクルーター、L\&D チーム向けです。

    <Steps>
      <Step title="ワークスペースを作成する">
        [intervyo.ai/auth/sign-up](https://intervyo.ai/auth/sign-up) でサインアップし、
        チームを作成します。トライアルは無料で、カードの登録は不要です。
      </Step>

      <Step title="Role を選ぶ">
        **Roles** を開き、キャリブレーション済みのスターター（ソフトウェア
        エンジニア、営業担当者、カスタマーサポートなど）を選ぶか、独自に作成します。
        [Roles](/jp/concepts/roles)を参照してください。初めての方は、既成の
        [クックブックのレシピ](/jp/cookbook/overview)をお試しください。
      </Step>

      <Step title="候補者を参加させる">
        **Participants** の下の **Add** をクリックして直接誰かを招待するか、
        Role の公開応募リンクを共有して、応募者自身に
        [応募してもらいます](/jp/guides/self-serve-applications)。いずれの場合も
        メールで本人確認が行われ、AI が面接を実施します。
      </Step>

      <Step title="スコアカードを確認する">
        セッションが完了すると、評価軸ごとのスコア、推奨判定、トランスクリプト、
        録画を含む完全なスコアカードが、参加者のプロフィールに表示されます。
        [ログイン不要のリンク](/jp/guides/sharing-candidate-profiles)を使って、
        審査メンバーと共有できます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="API で">
    intervyo.ai を自社製品や ATS に統合する開発者向けです。詳細な
    ウォークスルー：[採用のステップバイステップ](/jp/guides/hiring-step-by-step)。

    <Steps>
      <Step title="API キーを取得する">
        ダッシュボードで **Developer → API Keys** に移動し、`participants:write` と
        `sessions:write` のスコープを持つキーを作成します。
        [認証](/jp/authentication)を参照してください。
      </Step>

      <Step title="環境をセットアップする">
        ```bash theme={null}
        export INTERVYO_API_KEY="iv_live_…"
        export ROLE_ID="ce1cd564-..."   # from your Roles page
        export TEAM_SLUG="your-team-slug"
        ```
      </Step>

      <Step title="参加者を作成する">
        セッションは参加者に属するため、まず参加者を作成します。

        <CodeGroup>
          ```bash cURL theme={null}
          curl -X POST "https://www.intervyo.ai/api/v1/participants?accountSlug=$TEAM_SLUG" \
            -H "x-api-key: $INTERVYO_API_KEY" \
            -H "Content-Type: application/json" \
            -d '{
              "name": "Ada Lovelace",
              "email": "ada@example.com",
              "role_id": "'"$ROLE_ID"'"
            }'
          ```

          ```ts TypeScript theme={null}
          const res = await fetch(
            `https://www.intervyo.ai/api/v1/participants?accountSlug=${process.env.TEAM_SLUG}`,
            {
              method: "POST",
              headers: {
                "x-api-key": process.env.INTERVYO_API_KEY!,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                name: "Ada Lovelace",
                email: "ada@example.com",
                role_id: process.env.ROLE_ID,
              }),
            },
          );
          const { data } = await res.json();
          const candidateId = data.id;
          ```

          ```python Python theme={null}
          import os, requests

          res = requests.post(
              "https://www.intervyo.ai/api/v1/participants",
              params={"accountSlug": os.environ["TEAM_SLUG"]},
              headers={"x-api-key": os.environ["INTERVYO_API_KEY"]},
              json={
                  "name": "Ada Lovelace",
                  "email": "ada@example.com",
                  "role_id": os.environ["ROLE_ID"],
              },
          )
          candidate_id = res.json()["data"]["id"]
          ```
        </CodeGroup>

        返された `id` を `candidate_id` として保存します。
      </Step>

      <Step title="セッションをスケジュールする">
        招待メールは自動的に送信されます。

        ```bash theme={null}
        curl -X POST "https://www.intervyo.ai/api/v1/sessions?accountSlug=$TEAM_SLUG" \
          -H "x-api-key: $INTERVYO_API_KEY" \
          -H "Content-Type: application/json" \
          -d '{
            "candidate_id": "<candidate_id-from-previous-step>",
            "role_id": "'"$ROLE_ID"'",
            "stage": "screen",
            "idempotency_key": "quickstart-ada-screen"
          }'
        ```

        レスポンスには `join_url` が含まれます（招待がメール送信されたことも確認できます）。
      </Step>

      <Step title="スコアカードを受け取る">
        [Webhook](/jp/concepts/webhooks) を設定して、面接終了の瞬間に
        `session.completed` を受け取るか、`status` が `completed` になるまで
        [`GET /api/v1/sessions/{id}`](/api-reference/sessions/get-sessions-id)
        をポーリングします。Webhook を強く推奨します。そうしないと、待機時間に
        上限がなくなります。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## いま何が起きたのか

<CardGroup cols={2}>
  <Card title="AI があなたのルーブリックを実行した" icon="sliders">
    Interviewer のすべての評価軸が、評価軸ごとの根拠と引用とともに、
    トランスクリプトに照らしてスコアリングされました。
  </Card>

  <Card title="真正性シグナルを記録した" icon="shield-check">
    タブの切り替え、ペースト、音声なりすましのシグナルが、あなたの判断のために
    ダッシュボードに表示されます。これらが不採用を自動で決めることは決してありません。
  </Card>

  <Card title="録画をアーカイブした" icon="video">
    音声とトランスクリプトは、署名付きアクセスを備えた暗号化済み・リージョン対応の
    バケットに保存されます。保持期間はワークスペースのポリシーに従います。
  </Card>

  <Card title="Webhook を配信した" icon="webhook">
    設定されている場合、あなたのエンドポイントは HMAC 署名付きの完全なスコアカードを
    含むイベントを受信します。失敗時にはリトライが行われます。
  </Card>
</CardGroup>

<Tip>
  **次のステップ：** [Interviewer](/jp/concepts/interviewers) で AI が評価する内容を
  調整するか、2 つ目の [Round](/jp/concepts/rounds) を追加して、合格時に候補者が
  自動的に次へ進むようにしましょう。
</Tip>