ナレッジベース

ナレッジベースを利用すると、エージェントが必要に応じて取得できるドメイン固有の情報をエージェントに付与できます。いくつかの例：

よくある質問: お客様からよくある質問への回答をエージェントに装備
従業員ハンドブック: 新入社員に PTO（有給休暇）の付与、経費精算、オープン登録の締切などを案内
製品カタログ: 発信者が商品名や SKU で問い合わせた際に、価格、構成、在庫を回答
サポートランブック: ティア 1 のサポートエージェントにトラブルシューティング手順や既知の問題の回避策を提示

ナレッジベースとは

Cartesia にアップロードしたドキュメントはフォルダー単位で整理されます。エージェントにはフォルダーの内容へのアクセス権が付与され、それがエージェントのナレッジベースを構成します。エージェントが行うクエリは、そのエージェントにアタッチされたフォルダー内のドキュメントだけを検索するため、組織内で異なるエージェントごとに別々のコーパスを保持しつつ、コンテンツの相互流出を防ぐことができます。

ドキュメントのアップロード

フォルダーを作成し、そこにドキュメントを追加します。フォルダーは親フォルダーの中にネストできます。

Playground
API

フォルダーを作成

サイドバーの Knowledge Base に移動します
New folder をクリックして名前を入力します

親フォルダーの行にある「Add subfolder」アイコンをクリックすることで、フォルダーをネストできます。

ドキュメントをアップロード

ドキュメントをアップロードしたいフォルダーの Upload document アイコンをクリックします。
コンピュータからファイルを選択します
後でフィルタリングしたいメタデータを追加します。

ドキュメントはアップロード時に自動的にインデックスされます。

フォルダーを作成

curl -X POST https://api.cartesia.ai/agents/folders \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-03-01" \
  -H "Content-Type: application/json" \
  -d '{"name": "Product Docs", "parent_id": null}'

フォルダーをネストするには "parent_id" を渡します。レスポンスにはフォルダー id が含まれ、後続のリクエストで参照します。

ドキュメントをアップロード

curl -X POST https://api.cartesia.ai/agents/documents \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-03-01" \
  -H "Content-Type: application/json" \
  -d '{
    "folder_id": "folder_abc",
    "name": "Return Policy",
    "content": "Customers may return any unopened item within 30 days...",
    "metadata": {"category": "policy", "audience": "customer"}
  }'

ドキュメントはアップロード時に自動的にインデックスされます。1 回のリクエストで最大 100 ドキュメントをアップロードするには、documents 配列を含む POST /agents/documents/bulk を使用します。

エージェントとフォルダーの関連付け

フォルダーをエージェントにアタッチすると、エージェントの knowledge_base ツールから検索できるようになります。検索対象になるのはエージェントにアタッチされたフォルダーのみであり、フォルダーがアタッチされていないエージェントは、すべてのクエリに対して空の結果を返します。変更は進行中および今後の通話に即時反映されます。

Playground
API

エージェントを開いて、Knowledge Base セクションでアタッチしたいフォルダーを選択します。すべてのフォルダーの選択を解除すると、すべてのフォルダーがデタッチされます。

フォルダーの agents フィールドを、そのフォルダーをナレッジベースに含めたいエージェントに設定します。空の配列を送ると、フォルダーがすべてのエージェントからデタッチされます。

curl -X PATCH https://api.cartesia.ai/agents/folders/$FOLDER_ID \
  -H "X-API-Key: $CARTESIA_API_KEY" \
  -H "Cartesia-Version: 2026-03-01" \
  -H "Content-Type: application/json" \
  -d '{
    "agents": [
      {"id": "agent_abc"},
      {"id": "agent_def"}
    ]
  }'

エージェントからナレッジベースを使用する

`knowledge_base` ツール

knowledge_base は組み込みのツールです。エージェントの tools リストに加えるだけで、LLM が必要に応じて自動的に呼び出します。

import os

from line.llm_agent import LlmAgent, LlmConfig, end_call, knowledge_base

agent = LlmAgent(
    model="anthropic/claude-haiku-4-5-20251001",
    api_key=os.getenv("ANTHROPIC_API_KEY"),
    tools=[end_call, knowledge_base],
    config=LlmConfig(
        system_prompt=(
            "You are a customer support agent. "
            "Use the knowledge_base tool whenever the user asks about products, policies, or pricing."
        ),
        introduction="Hi! How can I help?",
    ),
)

LLM がクエリ文字列を選択し、それ以外のすべてのパラメータは構築時に固定されます。

tools=[knowledge_base(
    filters={"category": "billing"},
    top_k=10,
    description="Look up billing and payment policy details.",
    timeout_s=2.0,
    is_background=True,
)]

オプションの完全なリストについてはパラメータを参照してください。