オーバーライド

ユーザーごとのパーソナライズされたコンテキストで、各会話を最適化します。

システムプロンプトまたは最初のメッセージを完全に置き換えるためのオーバーライドは引き続きサポートされていますが、エージェントの応答をカスタマイズし、リアルタイムデータを挿入する推奨の方法として、動的変数の使用をおすすめします。動的変数は、メンテナンス性に優れ、より構造化されたパーソナライズ方法を提供します。

オーバーライド を使用すると、アシスタントはユーザーごとの操作に合わせて動作を調整できます。各会話の開始時にカスタムデータや設定を渡すことで、リアルタイムのコンテキストに基づき、アシスタントの応答や知識をパーソナライズできます。オーバーライドは、エージェントのダッシュボードで定義されているデフォルト値を完全に上書きします。

概要

オーバーライドを使用すると、複数のエージェントを作成せずに、AIエージェントの動作をリアルタイムで変更できます。これにより、ユーザー固有のデータを使って応答をパーソナライズできます。

エージェントのセキュリティ設定では、次のフィールドでオーバーライドを有効にできます。

システムプロンプト
最初のメッセージ
言語
Voice ID
LLM（大規模言語モデル）
ツール
ナレッジベース
テキストのみモード
安定性
速度
類似性ブースト
ASRキーワード
手順

手順のオーバーライドでは、conversation_config_overrideを使用しません。代わりに、クライアントは会話開始クライアントデータのトップレベルでprocedure_idsとstart_procedure_idsを渡します。会話ごとに手順を選択するを参照してください。

フィールドのオーバーライドを有効にしても、オーバーライドの指定は任意です。指定しない場合、エージェントはダッシュボードで定義されているデフォルト値を使用します。ほとんどのフィールドでは、オーバーライドが有効になっていないフィールドにオーバーライドを指定するとエラーになります。

ASRキーワード にはソフト拒否が適用されます。Securityトグルがオフでもクライアントが asr.keywordsを送信した場合、会話は継続され、キーワードは無視されます（エラーにはなりません）。会話ごとのキーワードブーストを適用するには、Security設定で ASRキーワード のオーバーライドを有効にしてください。会話ごとに最大50個のキーワードをサポートします。

オーバーライドが役立つ例をいくつか紹介します。

ユーザーの名前で挨拶する
応答に アカウント固有の詳細を含める
ユーザーの好みに応じて エージェントの言語 やトーンを調整する
アカウント残高や注文状況などの リアルタイムデータを渡す
ASRキーワードを介して、通話ごとの名前や用語（CRMの会社名など）の 文字起こし精度を高める

オーバーライドは、パーソナライズされたやり取りが必要なアプリケーションや、エージェントの基本設定に保存すべきではない機密性の高いユーザーデータを扱う場合に特に役立ちます。

ガイド

前提条件

ElevenLabsアカウント
設定済みのElevenLabs会話型エージェント（こちらで作成）

このガイドでは、エージェントのデフォルトの システムプロンプト、最初のメッセージ、LLM、ツール、ナレッジベース、TTS設定、および ASRキーワード をオーバーライドする方法を紹介します。

オーバーライドを有効にする

セキュリティ上の理由から、オーバーライドはデフォルトで無効になっています。first_message、prompt.prompt、prompt.tool_ids、prompt.knowledge_base、language、asr.keywordsなど、オーバーライドを許可するフィールドを有効にしてください。

ダッシュボードで更新

CLIで更新

APIで更新

エージェントの設定に移動し、Security タブを選択します。First message、System prompt、Tools、Knowledge base、ASR keywords、およびLLMなど必要なその他のオーバーライドを有効にしてください。

会話をオーバーライドする

会話を開始するコードで、オーバーライドをパラメータとして渡します。ツールとナレッジベースのオーバーライドは、その会話のデフォルト配列を置き換えます。ASRキーワードのオーバーライドは、その会話のエージェントのデフォルトキーワードリストを置き換えます（最大50キーワード）。

会話開始ペイロード

{
  "conversation_config_override": {
    "agent": {
      "prompt": {
        "tool_ids": ["tool_7101k5zvyjhmfg983brhmhkd98n6"],
        "knowledge_base": [
          {
            "type": "file",
            "name": "Unladen Swallow Facts",
            "id": "5xM3yVvZQKV0EfqQpLrJ",
            "usage_mode": "auto"
          }
        ]
      }
    },
    "asr": {
      "keywords": ["Acme Corp", "Contoso", "Globex"]
    }
  }
}

最新のSDKがインストールされていることを確認してください。

from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData
...
conversation_override = {
    "agent": {
        "prompt": {
            "prompt": f"The customer's bank account balance is {customer_balance}. They are based in {customer_location}.", # Optional: override the system prompt.
            "llm": "gpt-4o", # Optional: override the LLM model.
            "tool_ids": [
                "tool_7101k5zvyjhmfg983brhmhkd98n6"
            ], # Optional: replace the tools available to the agent.
            "knowledge_base": [
                {
                    "type": "file",
                    "name": "Unladen Swallow Facts",
                    "id": "5xM3yVvZQKV0EfqQpLrJ",
                    "usage_mode": "auto",
                }
            ], # Optional: replace the knowledge base available to the agent.
        },
        "first_message": f"Hi {customer_name}, how can I help you today?", # Optional: override the first_message.
        "language": "en" # Optional: override the language.
    },
    "tts": {
        "voice_id": "custom_voice_id", # Optional: override the voice.
        "stability": 0.7, # Optional: override stability (0.0 to 1.0).
        "speed": 1.1, # Optional: override speed (0.7 to 1.2).
        "similarity_boost": 0.9 # Optional: override similarity boost (0.0 to 1.0).
    },
    "conversation": {
        "text_only": True # Optional: enable text-only mode (no audio).
    },
    "asr": {
        "keywords": ["Acme Corp", "Contoso"] # Optional: boost ASR for per-call terms (max 50). Requires Security → ASR keywords.
    }
}
config = ConversationInitiationData(
    conversation_config_override=conversation_override
)
conversation = Conversation(
    ...
    config=config,
    ...
)
conversation.start_session()

オーバーライドを使用する場合は、オーバーライドしたくないフィールドを空の文字列やnull値に設定するのではなく、省略してください。カスタマイズしたいフィールドだけを含めてください。

正しいLLMモデル文字列を確認するには、サポートされているすべてのLLMモデルと正確な文字列識別子が記載されたAgent APIリファレンスを参照してください。