mcpField
T
tavus-cvi-quickstart

tavus-cvi-quickstart

github.com/tavus-engineeringAgent 工作流966 次安装40 周前更新
代码仓库

关于 tavus-cvi-quickstart

tavus-cvi-quickstart 是帮助开发者使用 Tavus 启动实时 AI 视频对话的技能。它介绍通过 API 创建 Persona 和对话，以及可选的流程模式与会话控制。

主要功能

  1. 01通过 API 启动对话
  2. 02创建自定义 Persona
  3. 03选择 Replica 和 Persona 资源
  4. 04配置对话选项
  5. 05结束进行中的对话
  6. 06选择 full、echo 或 audio 模式

适用场景

  1. 01使用现成资源启动视频对话
  2. 02设置自定义对话 Persona
  3. 03创建练习或演示通话
  4. 04通过 API 结束对话

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/tavus-cvi-quickstart确认已加载。

详细介绍

Tavus CVI 快速入门

几分钟内即可开始实时 AI 视频对话。

最快方式：使用现成资源

curl -X POST https://tavusapi.com/v2/conversations \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "replica_id": "rfe12d8b9597",
    "persona_id": "pdced222244b"
  }'

响应：

{
  "conversation_id": "c123456",
  "conversation_url": "https://tavus.daily.co/c123456",
  "status": "active"
}

在浏览器中打开 conversation_url 即可加入通话。

现成资源

虚拟形象（视觉化身）：

  • rfe12d8b9597 - 默认
  • re8e740a42 - Nathan

角色（行为／个性）：

  • pdced222244b - 默认
  • p24293d6 - Celebrity DJ

创建自定义角色和对话

第 1 步：创建角色
curl -X POST https://tavusapi.com/v2/personas \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_name": "Sales Coach",
    "pipeline_mode": "full",
    "system_prompt": "You are a friendly sales coach helping reps practice cold calls. Ask probing questions and give constructive feedback.",
    "context": "Focus on B2B SaaS sales scenarios.",
    "default_replica_id": "rfe12d8b9597"
  }'

响应：

{
  "persona_id": "p123456",
  "persona_name": "Sales Coach"
}
第 2 步：开始对话
curl -X POST https://tavusapi.com/v2/conversations \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_id": "p123456",
    "conversation_name": "Practice Session"
  }'

对话选项

{
  "persona_id": "p123456",
  "replica_id": "rfe12d8b9597",
  "conversation_name": "Demo Call",
  "conversational_context": "User is interested in enterprise pricing.",
  "custom_greeting": "Hi! I'm excited to help you today.",
  "callback_url": "https://your-webhook.com/tavus",
  "properties": {
    "enable_recording": true,
    "max_duration": 600
  }
}

结束对话

curl -X POST https://tavusapi.com/v2/conversations/{conversation_id}/end \
  -H "x-api-key: YOUR_API_KEY"

关键概念

概念含义
虚拟形象视觉化身（面部、外观）
角色行为、语音、大模型配置、系统提示词
对话结合虚拟形象和角色的实时 WebRTC 会话

管线模式

  • full - 完整 CVI，包含感知、STT、大模型、TTS（推荐）
  • echo - 绕过大模型，虚拟形象直接说出你发送的内容
  • audio - 仅音频，无视频

延迟

使用完整管线时，语音到语音的响应时间约为 600ms。

后续步骤

  • tavus-cvi-persona - 深入了解角色配置
  • tavus-cvi-ui - React 组件集成
  • tavus-cvi-interactions - 以编程方式控制对话
  • tavus-cvi-knowledge - 添加知识库和记忆

评论

支持 Markdown