Claude Code로 ElevenAgents 구축하기

Claude Code에서 자연어 프롬프트만으로 ElevenAgents 음성 에이전트를 반나절 만에 조립하는 흐름을 보여준다. 페르소나와 음성, LLM을 먼저 만들고, 지식베이스, 워크플로, 도구, 가드레일, 테스트를 차례로 얹어 실제 전화번호까지 연결한다.

밤사이 CI 실패를 브리핑하는 에이전트, 다국어 지원 라인, 포트폴리오 사이트에서 본인처럼 말하는 인터랙티브 에이전트 같은 활용 예시도 제시한다. 가장 빠른 모델은 약 75ms 지연을 내고, pause와 interruption을 실시간 처리하는 turn-taking model을 써서 기존 음성 에이전트의 어색함을 줄인다. Eleven v3 TTS는 말투 전환, 웃음, 한숨까지 표현할 수 있다.

설정은 다음 순서로 진행된다:

• ElevenLabs skill을 Claude Code에 설치한다.
• setup-api-key skill로 API key를 연결한다.
• 키는 agents-write로만 제한하고 일일 지출 상한을 건다.

이후에는 Qwen-3.6을 LLM으로 쓰는 에이전트를 만들고, 문서·URL·README.md를 지식베이스로 인덱싱한다. RAG가 관련 문서를 찾아 넣고, 소스가 바뀌면 자동 재색인해 동기화를 유지한다.

워크플로는 greeting → 의도 분류 → KB 답변 또는 사람 상담원 연결 → 마무리처럼 노드별로 나뉜다. 툴은 client tool show_help_article, webhook tool get_weather, built-in tool end_call, language_detection처럼 붙이며, 프런트엔드 UI 조작과 서버 API 호출, 통화 종료를 각각 맡긴다.

마지막으로 platform_settings에 guardrail을 두고, 시스템 프롬프트와 함께 중복 적용해 LLM 바깥에서 작동하는 방어층을 만든다. focus와 prompt injection protection을 켠 뒤, 가격 주장·미공개 기능 추측·billing 시스템 쓰기 권한을 막는 커스텀 규칙을 더한다. 테스트는 greeting 톤을 검증하는 response test, show_help_article 호출을 확인하는 tool call test, 가격 질문에 sales로 넘기는 simulation test로 마무리한다.