tavus-cvi-knowledge

Tavus CVI ナレッジベースとメモリ

ペルソナがドキュメントや永続的なメモリにアクセスできるようにします。

ナレッジベース（RAG）

会話中にペルソナが参照できるドキュメントをアップロードします。

ステップ 1：ドキュメントを作成

curl -X POST https://tavusapi.com/v2/documents \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "document_name": "Product FAQ",
    "document_url": "https://example.com/faq.pdf",
    "tags": ["support", "faq"]
  }'

レスポンス：

{
  "document_id": "d1234567890",
  "status": "processing"
}

対応しているソース

• PDF：PDF ファイルへの直接 URL
• テキストファイル：プレーンテキストのドキュメント
• ウェブサイト：単一ページまたはクロールしたページ

ウェブサイトのクロール

単一ページ（デフォルト）：

{
  "document_name": "Landing Page",
  "document_url": "https://example.com/features"
}

複数ページのクロール：

{
  "document_name": "Full Docs",
  "document_url": "https://docs.example.com",
  "crawl_pages": true
}

ステップ 2：会話で使用

ドキュメント ID を指定：

{
  "persona_id": "p123",
  "replica_id": "r456",
  "document_ids": ["d1234567890", "d0987654321"]
}

タグを指定：

{
  "persona_id": "p123",
  "replica_id": "r456",
  "document_tags": ["support", "faq"]
}

ペルソナに添付（常に利用可能）

このペルソナとのすべての会話で利用できるドキュメント：

curl -X POST https://tavusapi.com/v2/personas \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_name": "Support Agent",
    "pipeline_mode": "full",
    "system_prompt": "You are a helpful support agent...",
    "document_ids": ["d1234567890"],
    "document_tags": ["support"]
  }'

検索戦略

検索速度と品質のバランスを最適化します：

{
  "persona_id": "p123",
  "document_ids": ["d123"],
  "retrieval_strategy": "balanced"
}

オプション：

• speed - 最速。簡単な検索に適しています
• quality - 最良の結果。処理は遅くなります
• balanced - デフォルト。速度と品質のバランスが取れています

ドキュメントを管理

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

# Get document status
curl https://tavusapi.com/v2/documents/{document_id} \
  -H "x-api-key: YOUR_API_KEY"

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

---

メモリ（永続的なコンテキスト）

同じユーザーとの会話をまたいで情報を記憶します。

仕組み

1. 会話に memory_store キーを割り当てます
2. ペルソナが会話中にメモリを形成します
3. 同じキーを使った今後の会話で、そのメモリにアクセスできます

メモリを使った会話を作成

{
  "persona_id": "p123",
  "replica_id": "r456",
  "memory_stores": ["user_alice_persona_sales"]
}

メモリストアの命名

一貫性のある一意な識別子を使用します：

• user_{user_id}_persona_{persona_id} - ユーザーごと、ペルソナごと
• user_{user_id} - ペルソナをまたいでユーザーごと
• session_{session_id} - セッションごと

重要：キーにペルソナ名を使用しないでください（変更される可能性があります）。

例：再訪ユーザー

最初の会話：

{
  "persona_id": "p_coach",
  "memory_stores": ["user_alice_coaching"]
}

ユーザーが「4 月のマラソンに向けてトレーニングしています」と話します。

2 回目の会話（数日後）：

{
  "persona_id": "p_coach", 
  "memory_stores": ["user_alice_coaching"]
}

ペルソナはマラソンの目標を覚えており、それについて言及できます。

複数のメモリストア

コンテキスト間でメモリを共有します：

{
  "persona_id": "p123",
  "memory_stores": [
    "user_alice_global",
    "user_alice_sales_specific"
  ]
}

ユースケース：複数ペルソナ間でのメモリ共有

ユーザーが営業担当のペルソナと話した後、サポート担当のペルソナと話します：

// Sales conversation
{
  "persona_id": "p_sales",
  "memory_stores": ["user_alice"]
}

// Support conversation (later)
{
  "persona_id": "p_support",
  "memory_stores": ["user_alice"]
}

サポート担当のペルソナは、営業担当が話した内容を把握しています。

---

ナレッジとメモリの併用

多機能なサポートエージェント：

# Create persona with knowledge base
curl -X POST https://tavusapi.com/v2/personas \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_name": "Premium Support",
    "pipeline_mode": "full",
    "system_prompt": "You are a premium support agent. Reference the knowledge base for product info. Remember user preferences and past issues.",
    "document_tags": ["support", "product-docs"],
    "default_replica_id": "rfe12d8b9597"
  }'

# Start conversation with user memory
curl -X POST https://tavusapi.com/v2/conversations \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "persona_id": "p_premium_support",
    "memory_stores": ["user_12345_support"],
    "document_ids": ["d_urgent_issue_docs"]
  }'

これにより、ペルソナは次のことができます：

• ドキュメントから製品情報を検索する
• このユーザーの過去の問題を記憶する
• 以前の会話を踏まえて対応する