> ## 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, ...)** | 배포할 때마다 자동으로 번호가 부여되는 스냅샷. 에이전트의 모든 설정이 저장됩니다. |
| **프로덕션**             | 실제 통화에 적용되는 버전. 배포된 버전 중 하나를 프로덕션으로 지정합니다.     |

```mermaid theme={null}
graph LR
    A[현재 편집] -->|배포| B[v1]
    A -->|배포| C[v2]
    A -->|배포| D[v3]
    C -.->|프로덕션 지정| E[실제 통화]
```

## 배포하기

에이전트 편집을 마쳤다면 배포하여 버전을 생성하세요.

1. 에이전트 편집 화면 상단의 **배포** 버튼을 클릭합니다
2. 변경 사항을 설명하는 메모를 입력합니다 (선택)
3. **즉시 프로덕션으로 설정**을 체크하면 배포와 동시에 프로덕션 버전이 변경됩니다
4. **배포**를 클릭하면 새 버전이 생성됩니다

<Tip>
  "즉시 프로덕션으로 설정"을 체크하지 않으면 버전만 생성되고 프로덕션은 변경되지 않습니다. 검증 후 수동으로 프로덕션을 전환하고 싶을 때 유용합니다.
</Tip>

## 버전 히스토리

에이전트 편집 화면의 버전 표시를 클릭하면 배포 히스토리를 확인할 수 있습니다.

히스토리에서 확인할 수 있는 정보:

* **버전 번호와 배포 시각**
* **배포 메모** — 배포 시 입력한 변경 설명
* **연결된 전화번호** — 각 버전에 매핑된 인바운드/아웃바운드 번호
* **프로덕션 여부** — 현재 프로덕션으로 지정된 버전 표시

과거 버전을 클릭하면 해당 시점의 에이전트 설정을 읽기 전용으로 확인할 수 있습니다.

## 프로덕션 변경

프로덕션 버전을 변경하려면 버전 히스토리에서 원하는 버전을 선택하고 프로덕션으로 지정하세요.

* 새 버전을 프로덕션으로 올릴 때: 최신 버전을 선택
* 문제가 발생하여 롤백할 때: 이전 안정 버전을 선택

프로덕션 변경은 즉시 반영됩니다. 변경 후 새로 걸려오는 통화부터 해당 버전이 적용됩니다.

<Warning>
  진행 중인 통화에는 영향을 주지 않습니다. 프로덕션 변경 시점 이후의 새 통화부터 적용됩니다.
</Warning>

## 번호별 버전 지정

전화번호마다 다른 에이전트 버전을 지정할 수 있습니다. 이를 활용하면:

* **테스트 번호 운영** — 내부 테스트 번호에는 최신 버전을, 운영 번호에는 프로덕션 버전을 유지
* **번호별 고정 운영** — 브랜드·지역·업무별로 다른 버전을 고정

번호 관리 화면에서 에이전트를 선택할 때 특정 버전(현재, 프로덕션, v1, v2 등)을 지정할 수 있습니다.

| 선택 옵션           | 동작                         |
| --------------- | -------------------------- |
| **프로덕션**        | 항상 프로덕션으로 지정된 버전을 따름 (기본값) |
| **현재**          | 편집 중인 최신 상태를 실시간 반영        |
| **v1, v2, ...** | 특정 버전을 고정                  |

<Note>
  대부분의 경우 "프로덕션"으로 설정하면 됩니다. 특정 버전을 고정하는 것은 테스트 번호나 별도 운영 번호에만 제한적으로 사용하세요.
</Note>

## A/B 테스트

한 전화번호에서 여러 버전을 나눠 테스트해야 한다면 번호 설정에서 A/B 테스트를 사용할 수 있습니다.
새로 시작되는 통화를 지정한 비율에 따라 서로 다른 에이전트 버전으로 연결합니다.

활용 예시:

* **점진적 배포** — 새 버전에 10%만 배정해 실제 통화에서 먼저 검증
* **A/B 테스트** — 같은 번호로 들어오는 통화를 두 버전으로 나눠 성과 비교
* **빠른 롤백** — 문제가 있으면 안정 버전 비율을 100%로 되돌림

<Warning>
  A/B 테스트 변경은 진행 중인 통화에는 영향을 주지 않습니다. 변경 후 새로 시작되는 통화부터 적용됩니다.
</Warning>

<Note>
  자세한 설정 방법은 [A/B 테스트](/docs/operate/monitor/ab-testing) 페이지를 참고하세요.
</Note>

## 관련 문서

* [전화번호](/docs/operate/deploy/phone-numbers)
* [A/B 테스트](/docs/operate/monitor/ab-testing)
* [아웃바운드 단건](/docs/operate/deploy/outbound-single)
* [아웃바운드 대량](/docs/operate/deploy/outbound-batch)

***

<Accordion title="연관 검색어">
  버전 관리, versioning, 배포, deploy, 프로덕션, production, 롤백, rollback, 에이전트 버전, A/B 테스트
</Accordion>