mcpField
T
tavus-cvi-persona

tavus-cvi-persona

github.com/tavus-engineeringエージェントワークフロー959 回インストール40 週間前に更新
リポジトリ

tavus-cvi-persona について

tavus-cvi-persona は、Tavus CVI のペルソナ動作と処理レイヤーを設定するスキルです。モデルや音声、知覚、ターン検出、パイプラインモードを扱い、ペルソナの作成・更新例も示します。

主な機能

  1. 01LLM レイヤーと互換 API の設定
  2. 02TTS エンジンと音声 ID の指定
  3. 03Raven による知覚の有効化
  4. 04発話ターン検出の調整
  5. 05フル、エコー、音声のみのモード選択
  6. 06ペルソナの作成、更新、一覧表示、削除

活用シーン

  1. 01面接用ペルソナとシステムプロンプトの定義
  2. 02ペルソナと OpenAI 互換モデル API の接続
  3. 03音声とターン検出感度の設定
  4. 04画面や周囲の認識設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tavus-engineering/tavus-skills --skill tavus-cvi-persona

インストール後、Claude Code で/tavus-cvi-personaを入力して読み込まれたか確認します。

詳細

Tavus CVI ペルソナの設定

ペルソナの動作、LLM、TTS、認識、ターンテイキングを詳細に設定します。

ペルソナの完全なスキーマ

curl -X POST https://tavusapi.com/v2/personas \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_name": "Technical Interviewer",
    "pipeline_mode": "full",
    "system_prompt": "You are a senior technical interviewer...",
    "context": "Focus on system design and coding problems.",
    "default_replica_id": "rfe12d8b9597",
    "layers": {
      "llm": {...},
      "tts": {...},
      "perception": {...},
      "stt": {...}
    }
  }'

LLM レイヤー

組み込みモデル（最適化済み）
{
  "layers": {
    "llm": {
      "model": "tavus-gpt-4o"
    }
  }
}

オプション：tavus-gpt-4o、tavus-gpt-4o-mini、tavus-llama

独自の LLM を使用

OpenAI 互換 API であれば使用できます：

{
  "layers": {
    "llm": {
      "model": "gpt-4-turbo",
      "base_url": "https://api.openai.com/v1",
      "api_key": "sk-...",
      "speculative_inference": true
    }
  }
}

対応サービス：OpenAI、Anthropic（プロキシ経由）、Groq、Together、OpenAI 互換エンドポイントを持つローカルモデル。

関数呼び出し／ツール
{
  "layers": {
    "llm": {
      "model": "tavus-gpt-4o",
      "tools": [
        {
          "type": "function",
          "function": {
            "name": "get_weather",
            "description": "Get current weather for a location",
            "parameters": {
              "type": "object",
              "properties": {
                "location": {
                  "type": "string",
                  "description": "City and state"
                }
              },
              "required": ["location"]
            }
          }
        }
      ]
    }
  }
}

ツール呼び出しは Interactions Protocol を介して送信されます。

TTS レイヤー

Cartesia（デフォルト）
{
  "layers": {
    "tts": {
      "tts_engine": "cartesia",
      "voice_id": "your-cartesia-voice-id"
    }
  }
}
ElevenLabs
{
  "layers": {
    "tts": {
      "tts_engine": "elevenlabs",
      "voice_id": "your-elevenlabs-voice-id",
      "api_key": "your-elevenlabs-key"
    }
  }
}
PlayHT
{
  "layers": {
    "tts": {
      "tts_engine": "playht",
      "voice_id": "your-playht-voice-id",
      "api_key": "your-playht-key"
    }
  }
}

認識レイヤー（Raven）

レプリカが「見る」ことを可能にします。表情、視線、背景、画面の内容を分析します。

{
  "layers": {
    "perception": {
      "perception_model": "raven-0",
      "ambient_awareness": true
    }
  }
}

ユースケース：

  • ユーザーの表情や感情に反応する
  • 共有画面を見る
  • ユーザーの周囲の環境を分析する

STT レイヤー（音声認識）

スマートターン検出（Sparrow）
{
  "layers": {
    "stt": {
      "smart_turn_detection": true,
      "participant_pause_sensitivity": "medium",
      "participant_interrupt_sensitivity": "medium"
    }
  }
}

感度オプション：low、medium、high

  • pause_sensitivity：レプリカが応答するまでのユーザーの一時停止時間
  • interrupt_sensitivity：ユーザーがレプリカをどれだけ簡単に中断できるか

パイプラインモード

フル（デフォルト）

すべてのレイヤーを含む完全なパイプライン：

{ "pipeline_mode": "full" }
エコー

LLM をバイパスし、送信した内容をレプリカがそのまま話します：

{ "pipeline_mode": "echo" }

Interactions Protocol と併用すると、音声を直接制御できます。

音声のみ

音声のみで、動画はありません：

{
  "pipeline_mode": "full",
  "audio_only": true
}

既存のペルソナを更新

curl -X PATCH https://tavusapi.com/v2/personas/{persona_id} \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "system_prompt": "Updated prompt...",
    "context": "New context..."
  }'

ペルソナの一覧表示と削除

# List
curl https://tavusapi.com/v2/personas -H "x-api-key: YOUR_API_KEY"

# Delete
curl -X DELETE https://tavusapi.com/v2/personas/{persona_id} \
  -H "x-api-key: YOUR_API_KEY"

対応言語

Cartesia と ElevenLabs のフォールバックにより、30 以上の言語に対応しています： 英語、フランス語、ドイツ語、スペイン語、ポルトガル語、中国語、日本語、ヒンディー語、イタリア語、韓国語、オランダ語、ポーランド語、ロシア語、スウェーデン語、トルコ語、インドネシア語、フィリピン語、アラビア語、チェコ語、ギリシャ語、フィンランド語、クロアチア語、デンマーク語、タミル語、ウクライナ語、ハンガリー語、ノルウェー語、ベトナム語など。

コメント

Markdown 対応