ElevenAgents를 사용하여 전화로 Hermes 에이전트 호출하기

이 글을 코딩 에이전트에 복사하면 여러 단계를 자동으로 수행할 수 있습니다

코딩 에이전트가 전화를 받을 수 있다면 어떨까요? 자리에서 떨어져 있을 때 지난밤 테스트 실행이 성공했는지 확인하거나, 리팩터링을 시작해서 운전하는 동안 알아서 처리하게 하고 싶을 때가 있죠.

Hermes 에는 이미 ElevenLabs 가 내장된 Text to Speech 및 Speech to Text 기능이 있지만, 진정한 대화형으로 만들려면 ElevenAgents 가 필요합니다.

둘을 연결하면 Hermes 가 전화를 받을 수 있습니다.

**

아키텍처

에이전트 흐름 다이어그램

ElevenLabs Agents 는 턴 테이킹, 음성 합성 및 인식, 전화 통합 및 기타 음성 관련 기능을 처리합니다.

OpenClaw 는 도구, 메모리 및 스킬을 처리합니다.

시스템은 표준 OpenAI 호환 Chat Completions 프로토콜을 사용하여 통신합니다. ElevenLabs 는 각 대화 턴을 다음을 통해 Hermes 로 전송합니다:

1POST /v1/chat/completions

Hermes 는 OpenAI 호환 LLM 처럼 응답하지만, 해당 엔드포인트 뒤에는 전체 Hermes 에이전트 런타임이 있습니다.

**

사전 준비 사항

• ElevenLabs 계정
• 작동하는 모델/공급자로 구성된 Hermes Agent
• ngrok 설치 및 인증 완료
• 실제 전화번호를 연결하려는 경우 Twilio 계정 또는 ElevenLabs 지원 전화번호 설정

**

Hermes 설정

Hermes 는 게이트웨이를 통해 OpenAI 호환 API 서버를 노출합니다. ~/.hermes/.env 에 다음 값을 추가하여 활성화하세요:

1API_SERVER_ENABLED="true"
2API_SERVER_HOST="127.0.0.1"
3API_SERVER_PORT="8642"
4API_SERVER_KEY="YOUR_RANDOM_HERMES_API_SERVER_KEY"
5API_SERVER_MODEL_NAME="hermes-agent"

플레이스홀더 대신 강력한 API 키를 생성하세요. 그런 다음 Hermes 게이트웨이를 설치하고 시작합니다:

1hermes gateway install
2hermes gateway start

로컬 API 서버를 확인합니다:

1curl -sS <http://127.0.0.1:8642/health>

다음과 같은 결과가 표시되어야 합니다:

1{"status": "ok", "platform": "hermes-agent"}

**

ngrok 으로 Hermes 노출

Hermes API 서버로 터널을 시작합니다:

1ngrok http 8642

ngrok 은 다음과 같은 공개 HTTPS URL 을 제공합니다:

1<https://your-ngrok-subdomain.ngrok-free.app>

ngrok 을 계속 실행 상태로 두세요. ElevenLabs 가 이 URL 을 통해 Hermes 를 호출합니다.

ElevenLabs 구성

ElevenLabs Agent 대시보드에서:

1. ElevenLabs Conversational AI Agent 를 생성하거나 엽니다.
2. LLM 설정으로 이동합니다.
3. Custom LLM 을 선택합니다.

대시보드에서 Custom LLM 선택

1. Custom LLM URL 을 ngrok 엔드포인트 https://your-ngrok-subdomain.ngrok-free.app/v1 로 설정합니다.
2. Hermes API 서버 키를 사용하여 인증을 구성합니다.

Hermes 엔드포인트를 사용하여 구성

구성이 완료되면 ElevenLabs 는 대화 턴을 Hermes 로 라우팅합니다. Hermes 는 이를 일반 에이전트 메시지로 처리하며, 게이트웨이/API 서버 플랫폼에서 허용하는 모든 도구와 스킬에 액세스할 수 있습니다.

에이전트를 사용하여 ElevenLabs 구성

대시보드를 사용하는 대신 코딩 에이전트가 이러한 API 요청을 대신 수행할 수 있습니다.

1 단계: ElevenLabs 시크릿 생성

1curl -X POST <https://api.elevenlabs.io/v1/convai/secrets> \\\\
2  -H "xi-api-key: YOUR_ELEVENLABS_API_KEY" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "type": "new",
6    "name": "hermes_gateway_token",
7    "value": "YOUR_RANDOM_HERMES_API_SERVER_KEY"
8  }'

그러면 secret_id 가 포함된 응답이 반환됩니다:

1{
2  "type": "stored",
3  "secret_id": "abc123...",
4  "name": "hermes_gateway_token"
5}

2 단계: ElevenLabs Agent 생성

1curl -X POST <https://api.elevenlabs.io/v1/convai/agents/create> \\\\
2  -H "xi-api-key: YOUR_ELEVENLABS_API_KEY" \\\\
3  -H "Content-Type: application/json" \\\\
4  -d '{
5    "name": "Hermes Voice Agent",
6    "conversation_config": {
7      "agent": {
8        "language": "en",
9        "first_message": "Hello, how can I help?",
10        "prompt": {
11          "llm": "custom-llm",
12          "prompt": "You are Hermes Agent speaking through ElevenLabs in a live voice conversation. Be warm, conversational, and concise. Use Hermes tools when they are clearly needed, then summarize results naturally.",
13          "custom_llm": {
14            "url": "https://YOUR_NGROK_URL.ngrok-free.app/v1",
15            "api_type": "chat_completions",
16            "api_key": {
17              "secret_id": "RETURNED_SECRET_ID"
18            }
19          }
20        }
21      }
22    }
23  }'

전화번호 연결

이제부터가 재미있는 부분입니다.

Twilio 를 사용하는 경우:

1. 전화번호를 구매합니다.
2. Twilio 계정 SID 와 Auth Token 을 복사합니다.

ElevenLabs 에서:

1. Conversational AI Agent 를 엽니다.
2. Phone 섹션으로 이동합니다.
3. Twilio 계정을 연결하거나 ElevenLabs 계정에서 지원하는 다른 전화번호 옵션을 사용합니다.

Twilio 전화번호 추가

1. 전화번호를 ElevenLabs 에이전트에 연결합니다.

끝입니다. 이제 Hermes Agent 가 전화를 받습니다.