오버라이드
사용자별 맞춤 컨텍스트로 각 대화를 맞춤 설정하세요.
시스템 프롬프트나 첫 메시지를 완전히 교체하는 경우에는 여전히 오버라이드가 지원되지만, 에이전트 응답을 맞춤 설정하고 실시간 데이터를 삽입하는 기본 방법으로 동적 변수를 사용하는 것을 권장합니다. 동적 변수는 더 뛰어난 유지 관리성과 더 구조화된 개인화 방식을 제공합니다.
오버라이드를 사용하면 어시스턴트가 각 사용자 상호작용에 맞춰 동작을 조정할 수 있습니다. 각 대화 시작 시 맞춤 데이터와 설정을 전달하여 어시스턴트가 실시간 컨텍스트로 응답과 지식을 개인화하도록 할 수 있습니다. 오버라이드는 에이전트 대시보드에 정의된 에이전트의 기본값을 완전히 재정의합니다.
개요
오버라이드를 사용하면 여러 에이전트를 만들지 않고도 AI 에이전트의 동작을 실시간으로 수정할 수 있습니다. 이를 통해 사용자별 데이터로 응답을 개인화할 수 있습니다.
에이전트의 보안 설정에서 다음 필드에 오버라이드를 활성화할 수 있습니다.
- 시스템 프롬프트
- 첫 메시지
- 언어
- 음성 ID
- LLM(대규모 언어 모델)
- LLM 추론 노력
- 도구
- 지식 베이스
- 텍스트 전용 모드
- 안정성
- 속도
- 유사성 향상
- ASR 키워드
- 프로시저
- 워크플로 시작 노드
프로시저 오버라이드는 conversation_config_override를 사용하지 않습니다. 대신 클라이언트는 대화 시작 클라이언트 데이터의 최상위 수준에서 procedure_ids 및 start_procedure_ids를 전달합니다. 대화별 프로시저 선택을 참조하세요.
워크플로 시작 노드 오버라이드도 conversation_config_override 외부에서 작동합니다. 클라이언트는 최상위 수준에서 starting_workflow_node_id를 전달합니다. 클라이언트 데이터 구조를 참조하세요.
필드에 오버라이드가 활성화되어 있어도 오버라이드 제공은 선택 사항입니다. 제공하지 않으면 에이전트는 대시보드에 정의된 기본값을 사용합니다. 대부분의 필드에서는 해당 필드에 오버라이드가 활성화되지 않았는데 오버라이드를 제공하면 오류가 발생합니다.
ASR 키워드는 소프트 비허용 방식을 사용합니다. Security 토글이 꺼져 있어도 클라이언트가
asr.keywords를 전송하면 대화는 계속되고 키워드는 무시됩니다(오류 없음). 대화별 키워드 부스팅을
적용하려면 Security 설정에서 ASR 키워드 오버라이드를 활성화하세요. 대화당 최대 50개의 키워드가 지원됩니다.
추론 노력은 에이전트의 LLM이 지원하는 수준이어야 합니다. 그렇지 않으면 대화가 시작되지 않고 지원되지 않는 수준을 명시하는 오류와 함께 연결이 종료됩니다. Security
토글이 꺼져 있으면 prompt.reasoning_effort가 무시되고 에이전트에 저장된 추론 노력이
사용됩니다. 이 값은 전체 대화 동안 고정되며 시작 후에는 변경할 수 없습니다.
오버라이드가 유용한 몇 가지 예시는 다음과 같습니다.
- 이름으로 사용자를 환영하기
- 응답에 계정별 세부 정보 포함하기
- 사용자 선호도에 따라 에이전트의 언어 또는 어조 조정하기
- 계정 잔액이나 주문 상태와 같은 실시간 데이터 전달하기
- ASR 키워드를 통해 통화별 이름이나 용어(예: CRM 회사명)의 전사 정확도 향상하기
오버라이드는 개인화된 상호작용이 필요하거나 에이전트의 기본 구성에 저장하면 안 되는 민감한 사용자 데이터를 처리하는 애플리케이션에 특히 유용합니다.
가이드
사전 요구 사항
- ElevenLabs 계정
- 구성된 ElevenLabs 대화형 에이전트(여기에서 생성)
이 가이드에서는 기본 에이전트의 시스템 프롬프트, 첫 메시지, LLM, 추론 노력, 도구, 지식 베이스, TTS 설정, ASR 키워드를 오버라이드하는 방법을 안내합니다.
오버라이드 활성화
보안을 위해 오버라이드는 기본적으로 비활성화되어 있습니다. first_message, prompt.prompt, prompt.reasoning_effort, prompt.tool_ids, prompt.knowledge_base, language, asr.keywords 등 오버라이드를 허용할 필드를 활성화하세요.
대시보드에서 업데이트
CLI에서 업데이트
API에서 업데이트
에이전트 설정으로 이동하여 Security 탭을 선택하세요. First message, System prompt, Tools, Knowledge base, ASR keywords 및 LLM 또는 Reasoning effort 등 필요한 다른 오버라이드를 활성화하세요.

대화 오버라이드
대화를 시작하는 코드에서 오버라이드를 매개변수로 전달하세요. 도구 및 지식 베이스 오버라이드는 해당 대화의 기본 배열을 대체합니다. ASR 키워드 오버라이드는 해당 대화의 에이전트 기본 키워드 목록을 대체합니다(최대 50개 키워드).
최신 SDK가 설치되어 있는지 확인하세요.
오버라이드를 사용할 때는 오버라이드하지 않을 필드를 빈 문자열이나 null 값으로 설정하지 말고 생략하세요. 맞춤 설정하려는 필드만 포함하세요.
올바른 LLM 모델 문자열을 찾으려면 지원되는 모든 LLM 모델과 정확한 문자열 식별자가 나열된 에이전트 API 레퍼런스를 참조하세요.