Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt

Use this file to discover all available pages before exploring further.

에이전트 버전 관리

에이전트를 수정할 때마다 배포하여 버전을 생성할 수 있습니다. 버전은 에이전트의 모든 설정(프롬프트, 플로우, 도구, 음성 등)을 스냅샷으로 저장합니다. 프로덕션 버전을 지정하면 실제 통화에 해당 버전이 적용되고, 문제가 생기면 이전 버전으로 즉시 롤백할 수 있습니다.

핵심 개념

상태설명
현재대시보드에서 편집 중인 작업 버전. 아직 배포되지 않은 상태입니다.
버전 (v1, v2, …)배포할 때마다 자동으로 번호가 부여되는 스냅샷. 에이전트의 모든 설정이 저장됩니다.
프로덕션실제 통화에 적용되는 버전. 배포된 버전 중 하나를 프로덕션으로 지정합니다.

배포하기

에이전트 편집을 마쳤다면 배포하여 버전을 생성하세요.
  1. 에이전트 편집 화면 상단의 배포 버튼을 클릭합니다
  2. 변경 사항을 설명하는 메모를 입력합니다 (선택)
  3. 즉시 프로덕션으로 설정을 체크하면 배포와 동시에 프로덕션 버전이 변경됩니다
  4. 배포를 클릭하면 새 버전이 생성됩니다
“즉시 프로덕션으로 설정”을 체크하지 않으면 버전만 생성되고 프로덕션은 변경되지 않습니다. 검증 후 수동으로 프로덕션을 전환하고 싶을 때 유용합니다.

버전 히스토리

에이전트 편집 화면의 버전 표시를 클릭하면 배포 히스토리를 확인할 수 있습니다. 히스토리에서 확인할 수 있는 정보:
  • 버전 번호와 배포 시각
  • 배포 메모 — 배포 시 입력한 변경 설명
  • 연결된 전화번호 — 각 버전에 매핑된 인바운드/아웃바운드 번호
  • 프로덕션 여부 — 현재 프로덕션으로 지정된 버전 표시
과거 버전을 클릭하면 해당 시점의 에이전트 설정을 읽기 전용으로 확인할 수 있습니다.

프로덕션 변경

프로덕션 버전을 변경하려면 버전 히스토리에서 원하는 버전을 선택하고 프로덕션으로 지정하세요.
  • 새 버전을 프로덕션으로 올릴 때: 최신 버전을 선택
  • 문제가 발생하여 롤백할 때: 이전 안정 버전을 선택
프로덕션 변경은 즉시 반영됩니다. 변경 후 새로 걸려오는 통화부터 해당 버전이 적용됩니다.
진행 중인 통화에는 영향을 주지 않습니다. 프로덕션 변경 시점 이후의 새 통화부터 적용됩니다.

번호별 버전 지정

전화번호마다 다른 에이전트 버전을 지정할 수 있습니다. 이를 활용하면:
  • 테스트 번호 운영 — 내부 테스트 번호에는 최신 버전을, 운영 번호에는 프로덕션 버전을 유지
  • 번호별 고정 운영 — 브랜드·지역·업무별로 다른 버전을 고정
번호 관리 화면에서 에이전트를 선택할 때 특정 버전(현재, 프로덕션, v1, v2 등)을 지정할 수 있습니다.
선택 옵션동작
프로덕션항상 프로덕션으로 지정된 버전을 따름 (기본값)
현재편집 중인 최신 상태를 실시간 반영
v1, v2, …특정 버전을 고정
대부분의 경우 “프로덕션”으로 설정하면 됩니다. 특정 버전을 고정하는 것은 테스트 번호나 별도 운영 번호에만 제한적으로 사용하세요.

트래픽 분할

한 전화번호에서 여러 버전을 나눠 테스트해야 한다면 번호 설정에서 트래픽 분할을 사용할 수 있습니다. 새로 시작되는 통화를 지정한 비율에 따라 서로 다른 에이전트 버전으로 라우팅합니다. 활용 예시:
  • 점진적 배포 — 새 버전에 10%만 배정해 실제 통화에서 먼저 검증
  • A/B 테스트 — 같은 번호로 들어오는 통화를 두 버전으로 나눠 성과 비교
  • 빠른 롤백 — 문제가 있으면 안정 버전 비율을 100%로 되돌림
트래픽 분할 변경은 진행 중인 통화에는 영향을 주지 않습니다. 변경 후 새로 시작되는 통화부터 적용됩니다.
아웃바운드 트래픽 분할을 사용하는 번호에서는 캠페인이나 API 요청에서 에이전트를 직접 고정하는 방식과 충돌할 수 있습니다. 한 번호에서 버전 실험을 운영할 때는 트래픽 분할 기준으로 라우팅할지, 요청마다 에이전트를 명시할지 하나로 정하세요.

관련 문서


버전 관리, versioning, 배포, deploy, 프로덕션, production, 롤백, rollback, 에이전트 버전, A/B 테스트