런타임 설정(Runtime Configuration)을 활용한 재사용 가능한 음성 에이전트 구축

저는 제가 계속 마주치게 되는 패턴을 바탕으로 작은 Telnyx Voice 예제를 구축했습니다: 하나의 음성 에이전트, 여러 개의 비즈니스 컨텍스트(Business Contexts).

예약 일정을 잡는 경우, 치과, 의료 클리닉, 물리 치료실은 종종 동일한 기본 통화 흐름(Call Flow)을 필요로 합니다. 어시스턴트는 여전히 전화를 받고, 예약 세부 정보를 수집하며, 다음 단계를 확인합니다.

변하는 것은 비즈니스 컨텍스트입니다: 이름, 운영 시간, 서비스, 어조(Tone), 그리고 인사말입니다.

모든 비즈니스마다 별도의 어시스턴트를 만드는 대신, 이 예제는 하나의 재사용 가능한 베이스 어시스턴트를 사용하고 통화가 시작될 때 런타임 지침(Runtime Instructions)을 적용합니다.

흐름은 다음과 같습니다:

1. 발신자가 Telnyx 번호로 전화를 겁니다.
2. 웹훅(Webhook)이 어떤 번호로 전화가 왔는지 확인합니다.
3. 해당 번호가 비즈니스 설정(Business Config)에 매핑됩니다.
4. 서버가 적절한 지침과 인사말을 렌더링합니다.
5. Telnyx가 해당 런타임 컨텍스트(Runtime Context)로 어시스턴트를 시작합니다.

이를 통해 전체 어시스턴트 설정을 복사할 필요 없이, 하나의 어시스턴트 패턴을 여러 비즈니스에 걸쳐 더 쉽게 재사용할 수 있습니다.

실행하기:

git clone https://github.com/team-telnyx/telnyx-code-examples.git
cd telnyx-code-examples/provisional-telnyx-voice-api-agents-nodejs
npm install
...

생성된 페이로드(Payload)를 미리 볼 수도 있습니다:
npm run preview -- smile-dental

코드 예제:
[https://github.com/team-telnyx/telnyx-code-examples/tree/main/provisional-telnyx-voice-api-agents-nodejs]