Egma

Egma는 음성 에이전트(voice agents)를 테스트하고 프로덕션 환경에서 모니터링하기 위한 오픈 소스 플랫폼입니다.

Docs · Egma Cloud · Discord

🧩 핵심 기능 (Core features)

• 배포 전에 테스트하세요. 시뮬레이션된 음성 및 텍스트 대화와 모의(mocked) 도구 응답을 사용하여 회귀 테스트 스위트(regression suites)를 구축할 수 있습니다. 테스트는 에이전트의 리포지토리에 보관하고 Egma CLI 또는 코딩 에이전트를 사용하여 실행하세요.
• 프로덕션 환경 모니터링. 실제 대화, 도구 호출 및 메트릭을 검토합니다. 그레이더(graders)를 사용하여 에이전트의 동작을 확인하고 실패 원인을 조사할 수 있습니다.
• 자체 API 키 사용. Egma Cloud 또는 자체 호스팅 시 모델 제공업체의 자체 API 키를 사용할 수 있습니다. 모델 사용에 대한 Egma의 추가 비용 없이, 제공업체에게 직접 지불합니다.
• 테스트 사용자 정의. 지원되는 모델 중에서 선택하고 호출자 페르소나(caller personas)를 사용자 정의할 수 있습니다. 테스트하려는 동작에 대해 그레이딩 지침(grading instructions)과 통과 임계값(pass thresholds)을 설정하세요.

Egma는 LiveKit (JS/TS) 및 Retell을 지원합니다. 다른 플랫폼이나 기능 요청은 Discord로 문의해 주세요.

🚀 시작하기 (Get started)

최소한의 시간으로 첫 음성 시뮬레이션을 실행할 수 있습니다.

코딩 에이전트에서 음성 에이전트의 리포지토리를 열고 다음 내용을 붙여넣으세요:

Set up Egma in this repo. Install its skills with
npx skills add egma-ai/egma, then use them to connect
my voice agent and run my first voice simulation.

Egma Cloud의 경우, 계정을 생성하고 위의 프롬프트를 사용하세요.
자체 호스팅(self-host)의 경우, 자체 호스팅 가이드를 따르고 인스턴스의 URL을 프롬프트에 포함시키세요. 설치 및 첫 빌드에는 추가 시간이 걸릴 수 있습니다.

🖥️ 자체 호스팅 (Self-hosting)

자신의 장치에서 Egma 실행하기

git clone https://github.com/egma-ai/egma.git
cd egma
npm install --global egma-cli
...

자체 호스팅 가이드를 사용하여 .env 파일을 구성한 다음, Egma를 시작하세요:

egma self-host up

Open localhost:3101에 접속하여 계정을 만드세요.
에이전트 연결, 서버 설정 및 문제 해결 방법은 셀프 호스팅 가이드를 참고하세요.

🧭 향후 계획

Egma는 현재 테스트와 프로덕션 모니터링을 지원합니다. 저희는 자동 수정 기능을 추가할 계획입니다. Egma는 프로덕션 실패 사례를 활용하여 음성 에이전트의 하네스(harness)에 대한 변경 사항을 제안하고, 이를 테스트한 후 검토할 풀 리퀘스트(pull request)를 열어줄 것입니다.

💬 도움말 및 피드백

문서를 읽어보세요.

Discord에 참여하세요.

GitHub 이슈를 열어주세요.

⚖️ 라이선스

이 저장소는 ee 폴더를 제외하고 MIT 라이선스를 따릅니다. 자세한 내용은 LICENSE를 참고하세요.