> ## 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.

# 개요

> 플로우 에이전트를 생성하고 테스트하는 방법을 안내합니다.

# 플로우 에이전트

플로우 에이전트는 대화를 여러 노드로 나누어 관리하는 방식입니다. 단일 프롬프트 에이전트보다 대화 흐름을 세밀하게 제어할 수 있어, 복잡한 시나리오에 적합합니다.

## 주요 구성 요소

<CardGroup cols={3}>
  <Card title="글로벌 설정" icon="gear" href="#글로벌-설정">
    플로우 에이전트 전체에 적용되는 설정입니다. 기본 프롬프트, 음성, 기타
    에이전트 관련 설정을 여기서 구성할 수 있습니다.
  </Card>

  <Card title="노드" icon="circle-nodes" href="/docs/build/flow/nodes/overview">
    대화 흐름의 기본 단위입니다. 다양한 유형의 노드가 있으며, 사용자와의
    상호작용 방식, 함수 호출 방법 등을 정의할 수 있습니다.
  </Card>

  <Card title="전환" icon="arrow-right-arrow-left" href="/docs/build/flow/transitions">
    두 노드 간의 연결을 의미합니다. 한 노드에서 다른 노드로 전환하기 위한 조건을
    정의합니다.
  </Card>

  <Card title="API 작성 및 검증" icon="brackets-curly" href="/docs/build/flow/api-authoring">
    v3 API에서 `flow` 필드로 플로우 그래프를 생성하고 저장 전 검증하는 방법을
    확인합니다.
  </Card>
</CardGroup>

## 작동 방식

<Note>
  플로우 에이전트는 대화를 여러 부분으로 나누어 각 부분을 개별 노드로
  관리합니다. 에이전트와 사용자 간의 대화가 진행되는 동안, 특정 조건을 충족하면
  다음 노드로 이동합니다.
</Note>

```mermaid theme={null}
flowchart LR
    A[시작 노드] --> B[대화 노드]
    B --> C{조건 노드}
    C -- 예약 확인 --> D[API 노드]
    C -- 기타 문의 --> E[대화 노드]
    D --> F[종료 노드]
    E --> F
```

플로우 에이전트는 아래 순서로 작동합니다:

1. **대화**: 각 노드는 대화의 특정 부분을 관리합니다. 인사, 정보 수집, 문제 해결, 종료 등 단계별로 대화를 구조화할 수 있습니다.

2. **조건부 전환**: 에이전트와 사용자 간의 대화가 진행되는 동안, 전환 조건이 충족되면 현재 노드에서 다음 노드로 이동합니다. 예를 들어, 필요한 정보가 수집되면 정보 수집 노드에서 문제 해결 노드로 전환합니다.

3. **성능 향상**: 각 노드의 프롬프트와 전환 조건을 반복 테스트하여 에이전트의 성능을 향상시킬 수 있습니다.

4. **안정적인 성능**: 초기 설정에 시간이 걸리지만, 한번 완료되면 유지 관리가 쉽고 성능이 안정적입니다.

<video autoPlay muted loop playsInline className="w-full aspect-video" src="https://dfsf8iy3e65cn.cloudfront.net/public/vox/videos/vox-how-to-work-drag.mp4" style={{ borderRadius: "0.5rem" }} />

## 빠른 시작

<Steps>
  <Step title="대시보드 접속">
    vox.ai [대시보드](https://www.tryvox.co/dashboard)에 접속하여 새 플로우
    에이전트를 생성합니다.
  </Step>

  <Step title="템플릿 선택">
    미리 구축된 템플릿 중 하나를 선택하여 시작합니다. 대시보드에서 에이전트에
    사용 가능한 모든 옵션을 확인할 수 있습니다.
  </Step>

  <Step title="설정 수정">
    필요에 맞게 템플릿을 수정합니다. 모든 변경 사항은 자동으로 저장됩니다.
  </Step>

  <Step title="테스트 및 배포">
    에이전트를 테스트하고 성능에 만족하면 실제 환경에 배포합니다.
  </Step>
</Steps>

## 장점

플로우 에이전트의 장점은 다음과 같습니다:

* **세밀한 제어**: 대화 흐름을 더 정밀하게 제어하여 복잡한 시나리오를 효과적으로 처리할 수 있습니다.
* **모듈식 설계**: 각 노드는 특정 기능을 담당하므로 유지 관리와 업데이트가 용이합니다.
* **조건부 로직**: 다양한 조건에 따라 대화 흐름을 분기하여 맞춤형 사용자 경험을 제공할 수 있습니다.

## 글로벌 설정

글로벌 설정은 플로우 에이전트 전체에 적용되는 설정으로, 에이전트의 기본적인 동작과 특성을 정의합니다. 이 설정은 모든 노드에 영향을 미치므로 신중하게 구성해야 합니다.

<Note>
  대시보드에서 빈 캔버스를 클릭한 후 설정 아이콘을 클릭하여 글로벌 설정에 접근할
  수 있습니다.
</Note>

### 주요 설정 항목

<Steps>
  <Step title="목소리 설정">
    vox.ai에서 제공하는 다양한 고품질 목소리 중에서 선택할 수 있습니다. 비즈니스
    특성과 브랜드 이미지에 맞는 목소리를 선택하세요.
  </Step>

  <Step title="글로벌 프롬프트 작성">
    에이전트의 페르소나, 정체성, 가이드라인 등을 지정합니다. 이 텍스트는 모든
    노드에서 사용 가능하며 모든 응답 생성에 영향을 미칩니다.

    <Tip>
      효과적인 프롬프트 작성에 대한 자세한 내용은 [프롬프트 작성
      가이드](/docs/build/single-prompt/prompt-writing)를 참조하세요.
    </Tip>
  </Step>

  <Step title="기타 설정">
    플로우 에이전트 전체에 적용되는 추가 설정을 구성할 수 있습니다:

    * **음성 설정**: 에이전트의 음성을 선택합니다. 자세한 내용은 [음성 선택](/docs/build/voice/voice-select)을 참조하세요.
    * **발화 설정**: 발화 속도, 끼어들기 허용 등을 설정합니다. 자세한 내용은 [발화 설정](/docs/build/conversation/speech-settings)을 참조하세요.
    * **통화 설정**: 최대 통화 시간, 비활성 타임아웃 등을 설정합니다. 자세한 내용은 [통화 설정](/docs/build/conversation/call-settings)을 참조하세요.
    * **보안**: [데이터 보존 정책](/docs/build/security/data-retention)과 [개인정보 보호](/docs/build/security/pii-protection)를 설정합니다.
    * **웹훅**: 통화 이벤트 웹훅을 설정합니다. 자세한 내용은 [웹훅 개요](/docs/operate/monitor/webhooks/overview)를 참조하세요.
  </Step>
</Steps>

### 대화 시작 방식 설정

에이전트가 대화를 시작하는 방식을 정의합니다. `begin` 노드를 클릭하여 통화에서 누가 먼저 말할지 선택할 수 있습니다.

<CardGroup cols={2}>
  <Card title="사용자 먼저" icon="user">
    사용자가 먼저 대화를 시작하고 에이전트는 사용자의 입력을 기다립니다.
  </Card>

  <Card title="에이전트 먼저" icon="robot">
    에이전트가 대화를 먼저 시작합니다. 인사말이나 소개로 대화를 시작할 수
    있습니다.
  </Card>
</CardGroup>

## 다음 단계

플로우 에이전트를 활용하면 안정적이고 예측 가능한 대화 경험을 만들 수 있습니다. 이제 첫 번째 플로우 에이전트를 구축해 보세요.

<CardGroup cols={2}>
  <Card title="노드 추가" icon="circle-nodes" href="/docs/build/flow/nodes/overview">
    다양한 유형의 노드를 추가하고 구성하는 방법을 알아보세요.
  </Card>

  <Card title="전환 조건" icon="arrow-right-arrow-left" href="/docs/build/flow/transitions">
    노드 간 전환 조건을 설정하는 방법을 알아보세요.
  </Card>

  <Card title="API로 작성 및 검증" icon="brackets-curly" href="/docs/build/flow/api-authoring">
    API, SDK, MCP에서 플로우 그래프를 작성하고 검증하는 계약을 확인하세요.
  </Card>
</CardGroup>

***

<Accordion title="연관 검색어">
  플로우 에이전트, flow agent, 대화 흐름, 플로우 에디터, 글로벌 설정, flow builder, flow API, 캔버스, 노드 기반 에이전트
</Accordion>
