Vapi アシスタント作成

Vapi API を使用して、完全に設定された音声 AI アシスタントを作成します。アシスタントは、言語モデル、音声、トランスクライバーを組み合わせて、リアルタイムの電話および Web 通話を処理します。

セットアップ: VAPI_API_KEY が設定されていることを確認してください。必要に応じて setup-api-key スキルを参照してください。

クイックスタート

cURL

curl -X POST https://api.vapi.ai/assistant \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Support Assistant",
    "firstMessage": "Hello! How can I help you today?",
    "model": {
      "provider": "openai",
      "model": "gpt-4.1",
      "messages": [
        {
          "role": "system",
          "content": "You are a friendly phone support assistant. Keep responses concise and under 30 words."
        }
      ]
    },
    "voice": {
      "provider": "vapi",
      "voiceId": "Elliot"
    },
    "transcriber": {
      "provider": "deepgram",
      "model": "nova-3",
      "language": "en"
    }
  }'

TypeScript (Server SDK)

import { VapiClient } from "@vapi-ai/server-sdk";

const vapi = new VapiClient({ token: process.env.VAPI_API_KEY! });

const assistant = await vapi.assistants.create({
  name: "Support Assistant",
  firstMessage: "Hello! How can I help you today?",
  model: {
    provider: "openai",
    model: "gpt-4.1",
    messages: [
      {
        role: "system",
        content: "You are a friendly phone support assistant. Keep responses concise and under 30 words.",
      },
    ],
  },
  voice: {
    provider: "vapi",
    voiceId: "Elliot",
  },
  transcriber: {
    provider: "deepgram",
    model: "nova-3",
    language: "en",
  },
});

console.log("Assistant created:", assistant.id);

Python

import requests
import os

response = requests.post(
    "https://api.vapi.ai/assistant",
    headers={
        "Authorization": f"Bearer {os.environ['VAPI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "name": "Support Assistant",
        "firstMessage": "Hello! How can I help you today?",
        "model": {
            "provider": "openai",
            "model": "gpt-4.1",
            "messages": [
                {
                    "role": "system",
                    "content": "You are a friendly phone support assistant. Keep responses concise and under 30 words.",
                }
            ],
        },
        "voice": {"provider": "vapi", "voiceId": "Elliot"},
        "transcriber": {"provider": "deepgram", "model": "nova-3", "language": "en"},
    },
)

assistant = response.json()
print(f"Assistant created: {assistant['id']}")

コア設定

モデル (必須)

アシスタントの知能を支える言語モデル。

プロバイダー	モデル	説明
openai	gpt-4o, gpt-4o-mini, gpt-4-turbo	最も人気、ツール呼び出しが最高
anthropic	claude-3-5-sonnet-20241022, claude-3-5-haiku-20241022	強力な推論
google	gemini-1.5-pro, gemini-1.5-flash	マルチモーダル対応
groq	llama-3.1-70b-versatile, llama-3.1-8b-instant	超高速推論
deepinfra	meta-llama/Meta-Llama-3.1-70B-Instruct	オープンソースモデル
openrouter	様々なモデル	100 以上のモデルへのアクセス
perplexity	llama-3.1-sonar-large-128k-online	Web 接続対応
together-ai	様々なオープンソース	コスト効率的

{
  "model": {
    "provider": "openai",
    "model": "gpt-4.1",
    "temperature": 0.7,
    "maxTokens": 1000,
    "messages": [
      {
        "role": "system",
        "content": "Your system prompt here. Define the assistant's personality, rules, and behavior."
      }
    ]
  }
}

音声

アシスタント用のテキストから音声への変換音声。

プロバイダー	人気の音声	説明
vapi	Elliot, Lily, Rohan, Paola, Kian	Vapi 最適化音声、最小遅延
11labs	ElevenLabs の音声 ID	高品質、多数の音声
playht	PlayHT の音声 ID	表現力豊かな音声
cartesia	Cartesia の音声 ID	高速、高品質
openai	alloy, echo, fable, onyx, nova, shimmer	OpenAI TTS 音声
azure	Azure 音声名	エンタープライズグレード
deepgram	aura-asteria-en, aura-luna-en	低遅延
rime-ai	Rime の音声 ID	特殊な音声

{
  "voice": {
    "provider": "vapi",
    "voiceId": "Elliot"
  }
}

トランスクライバー

発話者を理解するためのスピーチツーテキストエンジン。

プロバイダー	モデル	説明
deepgram	nova-3, nova-2	最速、最も正確
google	latest_long, latest_short	Google Cloud STT
gladia	fast, accurate	ヨーロッパプロバイダー
assembly-ai	best, nano	高精度
speechmatics	様々なモデル	エンタープライズ STT
talkscriber	デフォルト	特殊対応

{
  "transcriber": {
    "provider": "deepgram",
    "model": "nova-3",
    "language": "en",
    "keywords": ["Vapi:2", "AI:1"]
  }
}

keywords フィールドは特定の単語の認識を強化します (単語:ブースト形式、ブースト 1-10)。

動作設定

最初のメッセージ

{
  "firstMessage": "Hello! Thanks for calling Acme Corp. How can I help you today?",
  "firstMessageMode": "assistant-speaks-first"
}

firstMessageMode オプション:

• "assistant-speaks-first" — アシスタントがすぐに挨拶 (デフォルト)
• "assistant-waits-for-user" — アシスタントが発話者の話を待機
• "assistant-speaks-first-with-model-generated-message" — LLM が挨拶を生成

バックグラウンドサウンド

{
  "backgroundSound": "office"
}

オプション: "off", "office", "static"

バックチャネリング

自然な会話の確認応答 ("uh-huh", "I see") を有効化:

{
  "backgroundDenoisingEnabled": true,
  "backchannelingEnabled": true
}

HIPAA コンプライアンス

{
  "hipaaEnabled": true
}

有効にすると、Vapi は通話録音とトランスクリプトを保存しません。

ツールの追加

通話中にアシスタントがアクションを実行できるようにツールをアタッチします。

保存済みツール ID の使用

{
  "model": {
    "provider": "openai",
    "model": "gpt-4.1",
    "toolIds": ["tool-id-1", "tool-id-2"],
    "messages": [{"role": "system", "content": "..."}]
  }
}

インラインツール定義

{
  "model": {
    "provider": "openai",
    "model": "gpt-4.1",
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "check_availability",
          "description": "Check appointment availability for a given date",
          "parameters": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string",
                "description": "Date in YYYY-MM-DD format"
              }
            },
            "required": ["date"]
          }
        },
        "server": {
          "url": "https://your-server.com/api/tools"
        }
      }
    ],
    "messages": [{"role": "system", "content": "..."}]
  }
}

フック

特定の通話イベントが発生したときにアクションを自動化します。詳細は フック参照 を参照してください。

{
  "hooks": [
    {
      "on": "customer.speech.timeout",
      "options": {
        "timeoutSeconds": 10,
        "triggerMaxCount": 3
      },
      "do": [
        {
          "type": "say",
          "exact": "Are you still there?"
        }
      ]
    },
    {
      "on": "call.ending",
      "filters": [
        {
          "type": "oneOf",
          "key": "call.endedReason",
          "oneOf": ["pipeline-error"]
        }
      ],
      "do": [
        {
          "type": "tool",
          "tool": {
            "type": "transferCall",
            "destinations": [
              {
                "type": "number",
                "number": "+1234567890"
              }
            ]
          }
        }
      ]
    }
  ]
}

アシスタントの管理

リスト表示

curl https://api.vapi.ai/assistant \
  -H "Authorization: Bearer $VAPI_API_KEY"

取得

curl https://api.vapi.ai/assistant/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY"

更新

curl -X PATCH https://api.vapi.ai/assistant/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "firstMessage": "Updated greeting!"
  }'

削除

curl -X DELETE https://api.vapi.ai/assistant/{id} \
  -H "Authorization: Bearer $VAPI_API_KEY"

一般的なパターン

カスタマーサポートエージェント

{
  "name": "Customer Support",
  "firstMessage": "Thank you for calling! How can I assist you today?",
  "model": {
    "provider": "openai",
    "model": "gpt-4.1",
    "messages": [
      {
        "role": "system",
        "content": "You are a helpful customer support agent for Acme Corp. Be empathetic, concise, and solution-oriented. If you cannot resolve an issue, offer to transfer to a human agent. Keep responses under 30 words."
      }
    ]
  },
  "voice": { "provider": "vapi", "voiceId": "Lily" },
  "transcriber": { "provider": "deepgram", "model": "nova-3", "language": "en" },
  "backchannelingEnabled": true
}

アポイントメントスケジューラー

{
  "name": "Appointment Scheduler",
  "firstMessage": "Hi there! I can help you schedule an appointment. What date works best for you?",
  "model": {
    "provider": "openai",
    "model": "gpt-4.1",
    "messages": [
      {
        "role": "system",
        "content": "You are an appointment scheduling assistant. Collect the customer's preferred date, time, and service type. Confirm details before booking. Be friendly and efficient."
      }
    ],
    "tools": [
      {
        "type": "function",
        "function": {
          "name": "book_appointment",
          "description": "Book an appointment for the given date, time, and service",
          "parameters": {
            "type": "object",
            "properties": {
              "date": { "type": "string", "description": "YYYY-MM-DD" },
              "time": { "type": "string", "description": "HH:MM in 24h format" },
              "service": { "type": "string", "description": "Type of service" },
              "name": { "type": "string", "description": "Customer name" }
            },
            "required": ["date", "time", "service", "name"]
          }
        },
        "server": { "url": "https://your-server.com/api/book" }
      }
    ]
  },
  "voice": { "provider": "vapi", "voiceId": "Paola" },
  "transcriber": { "provider": "deepgram", "model": "nova-3", "language": "en" }
}

多言語エージェント

{
  "name": "Multilingual Support",
  "firstMessage": "Hello! How can I help you? / Hola! Como puedo ayudarte?",
  "model": {
    "provider": "openai",
    "model": "gpt-4.1",
    "messages": [
      {
        "role": "system",
        "content": "You are a multilingual support assistant. Detect the caller's language and respond in the same language. You support English and Spanish."
      }
    ]
  },
  "voice": { "provider": "vapi", "voiceId": "Paola" },
  "transcriber": { "provider": "deepgram", "model": "nova-3", "language": "multi" }
}

参考資料

• フック設定 — 完全なフックイベントとアクション
• 音声およびモデルプロバイダー — サポートされているすべてのプロバイダーとモデル
• Vapi API ドキュメント — 公式ドキュメント

追加リソース

このスキルリポジトリには、Vapi ドキュメント MCP サーバー (vapi-docs) が含まれており、AI エージェントに完全な Vapi ナレッジベースへのアクセスを提供します。searchDocs ツールを使用して、このスキルでカバーされている内容以外のすべています — 高度な設定、トラブルシューティング、SDK の詳細など。

自動設定: これらのスキルをクローンまたはインストールした場合、MCP サーバーはすでに .mcp.json (Claude Code)、.cursor/mcp.json (Cursor)、または .vscode/mcp.json (VS Code Copilot) で設定されています。

手動セットアップ: エージェントが設定を自動検出しない場合は、以下を実行してください:

claude mcp add vapi-docs -- npx -y mcp-remote https://docs.vapi.ai/_mcp/server

サポートされているすべてのエージェント間での完全なセットアップ指示については、README を参照してください。