대화형 에이전트
대화형 에이전트는 사용자가 AI 에이전트와 대화하며 사용자가 정의한 작업을 완료할 수 있게 해주는 채널입니다. 브랜드를 위해 에이전트가 수행할 작업을 설명하는 대화형 워크플로를 생성합니다. 예를 들어, 워크플로를 통해 사용자가 선호도에 따라 상품을 구매하도록 도울 수 있습니다.

대화형 에이전트는 현재 베타 버전입니다. 이 베타에 참여하고 싶으시면 Braze 계정 매니저에게 문의하세요.
프로덕션에 배포하기 전에 대화형 인공지능 사용에 따른 영향에 대해 법무 팀과 상의하세요.
작동 방식
대화형 워크플로는 에이전트가 완료해야 하는 작업입니다. 각 워크플로에는 목적, 채널 설정, 대상 오디언스, 자연어로 작성된 단계가 포함됩니다. 단계에 도구를 추가하면 에이전트가 카탈로그를 검색하고, 속성을 설정하고, 이벤트를 기록하고, 웹훅을 호출할 수 있습니다.
워크플로를 만든 후에는 설정에서 브랜드 가이드라인과 채널 동작을 확인하세요. 대화 미리보기, 시뮬레이션 만들기, 대화 기록 검토를 사용해 경험을 테스트하고 도구 호출을 검토할 수 있습니다.
웹 채팅 위젯 설정
사이트에 Conversational Agents 채팅 위젯을 표시하려면 Braze Web SDK에서 다음 단계를 완료하세요.
1단계: SDK 인증 설정
웹 앱에 대해 SDK 인증을 활성화하세요.
2단계: Web SDK 설치
다음 중 하나를 설치하세요.
| 옵션 | 세부 정보 |
|---|---|
| npm | 최신 @braze/web-sdk 패키지를 설치합니다. |
| CDN | 대화형 빌드를 로드합니다. https://js.appboycdn.com/web-sdk/latest/braze.conversational.min.js |
3단계: 사용자 제공 JavaScript를 활성화하여 초기화
initialize 호출에서 allowUserSuppliedJavascript: true를 설정하세요.
braze.initialize("{YOUR_API_KEY}", {
baseUrl: "{YOUR_SDK_ENDPOINT}",
allowUserSuppliedJavascript: true
});
{YOUR_API_KEY}를 웹 SDK API 키로, {YOUR_SDK_ENDPOINT}를 SDK 엔드포인트로 바꿉니다.
4단계: 채팅 위젯 활성화
세션을 열기 전에 braze.automaticallyManageChat()을 호출하세요.
braze.automaticallyManageChat();
braze.openSession();
대화형 워크플로 만들기
대화형 워크플로를 사용하여 작업을 정의하고, 채널과 오디언스를 선택하고, 각 단계에서 에이전트가 수행할 작업을 지정할 수 있습니다.
1단계: 워크플로 세부 정보 설정
Agents > Conversational Agents로 이동한 다음 워크플로의 세부 정보를 설정합니다.
- 워크플로 이름을 입력합니다.
- 이 워크플로가 수행하는 작업을 설명하는 목적을 입력합니다. 에이전트는 목적과 대화 기록을 바탕으로 사용할 워크플로를 선택하므로, 워크플로가 적용되는 상황을 설명하세요. 예를 들어 “사용자가 이벤트 시간이나 환불에 대해 질문이 있습니다.”와 같이 작성합니다.
- 이 워크플로를 활성화할 채널을 선택합니다. 지원되는 채널은 SMS, RCS, WhatsApp, 웹입니다.
- 웹의 경우 이 워크플로를 활성화할 웹 앱을 선택합니다.
- SMS, RCS, WhatsApp의 경우 이 워크플로를 활성화할 구독 그룹을 선택합니다.
- 사용자가 이 워크플로에 액세스하기 위해 속해야 하는 Segments를 선택합니다.

워크플로는 Canvas에 연결되어 있지 않습니다. 하나의 구독 그룹이나 웹 앱에 여러 워크플로를 둘 수 있으며, 에이전트는 대화 중에 워크플로 사이를 이동합니다. 특정 Canvas 메시지를 받은 사용자로 워크플로를 제한하려면 해당 사용자로 Segment를 만들고 워크플로에서 선택하세요. 먼저 소규모 오디언스로 테스트하려면 일부 사용자로 구성된 소규모 Segment를 사용하세요.
SMS, RCS, WhatsApp의 경우 일부 인바운드 메시지 트리거가 에이전트를 차단할 수 있습니다. 설정 페이지에서 각 구독 그룹별로 에이전트를 차단할 수 있는 트리거를 검토하세요.
2단계: 워크플로 단계 작성
에이전트가 워크플로를 완료하기 위해 수행해야 하는 단계를 추가합니다. 워크플로에는 최대 10개의 단계를 포함할 수 있습니다. 각 단계에는 지침이 필요하며, 지침은 최대 5,000자까지 입력할 수 있습니다.
목표가 하나인 단계의 경우 지침을 1~3개의 짧은 문장으로 작성하세요. 규칙을 명확하게 유지하고, 에이전트가 사용자에게 보낼 다음 응답을 어떻게 표현해야 할지 알 수 있도록 명시적인 질문이나 확인으로 마무리하세요.
3단계: 단계에 도구 추가
단계에는 에이전트가 작업하는 동안 사용하는 도구를 포함할 수 있습니다. 단계의 Instructions에서 /를 입력하여 도구를 삽입하면 지침에 태그로 표시됩니다. 하나의 단계에서 최대 10개의 도구를 참조할 수 있습니다.

도구
단계에 다음 도구를 추가할 수 있습니다.
| 도구 | 설명 |
|---|---|
| 지식 소스 검색 | 지식 소스를 통해 카탈로그를 쿼리합니다. |
| 워크플로 속성 설정 | 이 워크플로 범위에서만 사용하는 값을 저장합니다. |
| 워크플로 속성 가져오기 | 이전 단계에서 설정한 워크플로 속성을 가져옵니다. |
| 커스텀 이벤트 로그 | Braze 커스텀 이벤트를 기록합니다. |
| 커스텀 속성 설정 | 사용자에 커스텀 속성을 설정합니다. |
| 커스텀 속성 가져오기 | 사용자의 커스텀 속성을 가져옵니다. |
| 사용자 속성 가져오기 | 표준 고객 프로필 필드를 가져옵니다. |
| 웹훅 호출 | 외부 엔드포인트로 HTTP 요청을 보냅니다. |
| 웹훅 응답 가져오기 | 이전 웹훅 응답에서 추출한 필드를 가져옵니다. |
지식 소스 검색
이 도구를 사용하면 에이전트가 Braze 카탈로그를 쿼리하고 이해하는 데 도움이 됩니다. 다음과 같은 카탈로그에 대해 지식 소스를 만들 수 있습니다.
- 제품 카탈로그
- FAQ
- 사이즈 차트
먼저 지식 소스 페이지에서 지식 소스를 만듭니다. 그런 다음 지침 텍스트 상자에 /를 입력하고 지식 소스 검색을 선택합니다. 기존 대화형 지식 소스 도구를 선택하거나 새 검색 도구 만들기를 선택합니다.
새 도구를 만들 때는 이름과 설명을 입력한 다음 지식 소스를 선택합니다. 지식 소스를 선택한 후에는 에이전트가 액세스할 수 있는 필드를 선택합니다.
워크플로 속성 설정
이 도구를 사용하면 에이전트가 같은 워크플로 안에서 나중에 다시 사용할 수 있는 속성을 설정할 수 있습니다. 워크플로 속성은 해당 속성이 설정된 워크플로 범위에서만 유효합니다. 커스텀 이벤트 속성정보, 커스텀 속성 값, 웹훅 파라미터로 활용할 수 있습니다.
속성을 만들 때 선택적으로 허용 값을 추가할 수 있습니다.
- 허용 값을 비워 두면 에이전트가 대화 내용을 바탕으로 해당 유형의 어떤 값이든 설정할 수 있습니다.
- 허용 값을 추가하면 에이전트가 정의한 값 중에서만 선택하도록 제한할 수 있습니다. 이후 도구(예: 웹훅 호출, 커스텀 이벤트 기록, 커스텀 속성 설정)에서 에이전트가 자유롭게 고른 값 대신 통제된 값을 다시 사용해야 할 때 활용하세요.
지침에 /를 입력하고 워크플로 속성 설정을 선택합니다. 기존 워크플로 속성을 선택하거나 새 속성 만들기를 선택합니다.
새 속성을 만들 때는 이름과 설명을 입력한 다음 유형을 선택합니다. 유형을 선택한 후에는 선택적으로 허용 값을 추가할 수 있습니다. 각 허용 값에는 최대 100자의 값과 최대 250자의 설명이 필요합니다. 값은 고유해야 하며, 하나의 속성에는 최대 250개의 허용 값을 지정할 수 있습니다.
허용 값을 설정하면 사용자가 다른 표현을 쓰더라도 에이전트가 지정한 값 중 하나를 선택합니다. 예를 들어 skin_type 속성에 dry와 oily만 허용되어 있고 사용자가 건성 피부를 다른 동의어로 설명하면, 에이전트는 dry를 설정합니다. 허용 값이 없으면 에이전트는 속성 설명과 단계 지침을 바탕으로 값을 선택하는데, 대체로 이를 따르지만 엄격하게 따르지 않을 수도 있습니다.
통제된 값을 고객 프로필에 저장하려면 같은 단계에서 두 가지 도구를 함께 사용하세요.
- 사용자가 답변을 확인한 후 워크플로 속성 설정을 사용해 속성을 설정합니다.
- 커스텀 속성 설정을 사용하고, 커스텀 속성 값의 소스로 워크플로 속성을 선택합니다.
워크플로 속성 가져오기
이 도구를 사용하면 이전 단계에서 설정한 워크플로 속성의 값을 가져올 수 있습니다.
커스텀 이벤트 로그
이 도구를 사용하면 Braze 커스텀 이벤트를 기록할 수 있습니다. 지침 텍스트 상자에 /를 입력하고 커스텀 이벤트 기록을 선택합니다. 기존 커스텀 이벤트 기록 도구를 선택하거나 새 커스텀 이벤트 도구 만들기를 선택합니다.
새 도구를 만들 때는 커스텀 이벤트를 선택한 다음 이름과 설명을 입력합니다. 커스텀 이벤트와 함께 보낼 이벤트 속성정보를 선택합니다. 각 커스텀 이벤트 속성정보는 다음 소스 중 하나를 사용할 수 있습니다.
| 소스 | 설명 |
|---|---|
| 에이전트 | 에이전트가 지침과 도구 설명을 바탕으로 값을 결정합니다. |
| 워크플로 속성 | 에이전트가 이전 단계에서 설정한 워크플로 속성을 사용합니다. |
| 커스텀 속성 | 사용자의 커스텀 속성을 사용합니다. |
모든 속성정보에 값을 설정할 필요는 없습니다. 일부 속성정보 유형은 지원되지 않습니다.
속성정보 값이 비어 있을 때 도구가 실패하도록 하려면 필수를 선택하세요.
사용자를 Canvas에 진입시키려면 Canvas가 항목 속성정보로 사용하는 커스텀 이벤트를 기록하세요.
커스텀 속성 설정
이 도구를 사용하면 사용자에게 커스텀 속성을 설정할 수 있습니다. 지침 텍스트 상자에 /를 입력하고 커스텀 속성 설정을 선택합니다. 기존 커스텀 속성 설정 도구를 선택하거나 새 커스텀 속성 도구 만들기를 선택합니다.
새 도구를 만들 때는 이름과 설명을 입력한 다음 도구가 설정할 커스텀 속성을 선택합니다. 커스텀 속성은 다음 소스 중 하나를 사용할 수 있습니다.
| 소스 | 설명 |
|---|---|
| 에이전트 | 에이전트가 지침과 도구 설명을 바탕으로 값을 결정합니다. |
| 워크플로 속성 | 에이전트가 이전 단계에서 설정한 워크플로 속성을 사용자 속성에 사용합니다. |

커스텀 속성은 비동기적으로 설정됩니다. 에이전트가 커스텀 속성을 설정한 직후에 읽으면 값이 아직 이전 상태일 수 있습니다.
커스텀 속성 가져오기
이 도구를 사용하면 커스텀 속성을 가져올 수 있습니다.
사용자 속성 가져오기
이 도구를 사용하면 표준 고객 프로필 필드를 가져올 수 있습니다. 지침 텍스트 상자에 슬래시(/)를 입력하고 사용자 속성 가져오기를 선택합니다. 다음 필드 중 하나를 선택하세요.
- 외부 ID
- Braze ID
- 이메일
- 이름
- 성
- 전화번호
웹훅 호출
이 도구를 사용하면 웹훅을 호출할 수 있습니다. 지침 텍스트 상자에 /를 입력하고 웹훅 호출을 선택합니다. 기존 웹훅 도구를 선택하거나 새 웹훅 만들기를 선택합니다.
새 도구를 만들 때는 이름과 설명을 입력한 다음 변수를 추가합니다. 변수를 사용하면 웹훅 URL, 본문 또는 헤더에 개인화된 값을 포함할 수 있습니다.
변수는 다음 소스 중 하나를 사용할 수 있습니다.
| 소스 | 설명 |
|---|---|
| 에이전트 | 에이전트가 지침과 설명을 바탕으로 값을 결정합니다. |
| 워크플로 속성 | 에이전트가 이전 단계에서 설정한 워크플로 속성을 사용합니다. |
| 커스텀 속성 | 사용자의 커스텀 속성을 사용합니다. |
| 고객 프로필 | 고객 프로필 필드(외부 ID, Braze ID, 이메일, 이름, 성, 전화번호)를 사용합니다. |
변수를 설정한 후 요청 메서드를 선택합니다. 지원되는 요청 메서드는 다음과 같습니다.
GETPOSTPUTPATCHDELETE
그런 다음 URL을 입력합니다. URL에서 변수를 사용하려면 {{variable_name}} 구문으로 참조하세요. 예를 들면 다음과 같습니다.
https://myurl.com/create/{{user_id}}
다음으로 요청 본문을 설정합니다. 본문을 비워 두거나 {{variable_name}} 입력 안내를 포함할 수 있는 문자열을 입력하세요. 대부분의 API에서는 JSON 본문을 보냅니다. 예를 들면 다음과 같습니다.
{
"user": {
"id": "{{external_id}}",
"favorite_color": "{{favorite_color}}",
"is_called_by_agent": true
}
}
변수를 사용해 헤더를 설정할 수도 있습니다. 자격 증명이 필요한 경우 대시보드에서 연결된 콘텐츠 자격 증명을 만든 다음 이 도구에서 참조하세요.
웹훅 응답은 용량이 클 수 있으므로 워크플로에 필요한 필드만 추출할 수 있습니다. 응답 본문의 값을 가리키는 JMESPath 표현식으로 응답 필드를 만드세요. 해당 필드를 성공적으로 추출하려면 응답 본문이 유효한 JSON이어야 합니다. 이후 웹훅 응답 가져오기 도구로 이 필드를 참조할 수 있습니다.
웹훅 응답 가져오기
이 도구를 사용하면 이전 웹훅 호출 단계에서 추출한 웹훅 응답 필드를 참조할 수 있습니다.
설정
대화형 에이전트의 브랜드 가이드라인과 채널 동작을 구성합니다. 에이전트 > 대화형 에이전트로 이동한 다음 설정을 선택합니다.
브랜드 가이드라인
에이전트가 응답할 때 따를 브랜드 가이드라인을 선택합니다. 가이드라인은 콘텐츠 > 브랜드 가이드라인에서 만들고 관리할 수 있으며, 여기에서 그중 하나를 선택하면 됩니다.
웹 설정
시작 메시지를 설정합니다. 사용자가 웹 대화를 시작할 때 가장 먼저 보게 되는 메시지입니다.
SMS, RCS 및 WhatsApp 설정
다음 항목을 구성합니다.
| 설정 | 설명 |
|---|---|
| 일일 턴 한도 | 메시징 채널에서 사용자당 하루에 허용되는 최대 턴 수입니다. |
| AI 고지 메시지 | 모든 SMS, RCS, WhatsApp 대화에서 에이전트의 첫 번째 답장 맨 앞에 표시되는 텍스트입니다. 문구는 바꿀 수 있지만 끌 수는 없습니다. 기본 메시지를 사용하려면 필드를 비워 두세요. |
| 에이전트를 차단할 수 있는 트리거 | 워크플로에서 활성화된 각 구독 그룹의 인바운드 메시지 트리거 목록입니다. 인바운드 메시지가 이러한 트리거 중 하나를 활성화하면 대화형 에이전트는 응답하지 않습니다. |
우선순위를 가질 수 있는 트리거는 다음과 같습니다.
- 키워드 트리거
- 액션 기반 Campaign
- 액션 기반 Canvas 진입
- Canvas 행동 경로
- Canvas 종료
대화 미리보기
미리보기하는 방법에는 두 가지가 있습니다.
- 저장된 워크플로를 편집할 때는 해당 워크플로만 미리 볼 수 있습니다. 새 워크플로는 저장하기 전까지 미리보기를 사용할 수 없습니다.
- 설정 페이지에서는 웹 앱 또는 구독 그룹에 대한 경험을 미리 볼 수 있습니다. 필요한 경우 초안 워크플로 포함을 선택하면 초안 워크플로를 활성화하기 전에 테스트할 수 있습니다.
두 경우 모두 특정 사용자로 미리보기합니다.

미리보기 모드에서는 커스텀 속성이나 커스텀 이벤트가 기록되지 않습니다.
시뮬레이션 생성
시뮬레이션은 실제 사용자 없이 워크스페이스의 대화형 워크플로를 테스트합니다. 시나리오와 기대하는 성과를 설명하는 케이스를 생성하세요. 시뮬레이션 사용자가 해당 시나리오를 따라 진행합니다. 대화가 끝나면 채점기가 대화 내용과 도구 호출을 기대 성과와 비교하여 확인합니다. 웹훅 응답을 모의 처리하면 케이스 결과를 예측 가능하게 유지할 수 있습니다.
에이전트 > 대화형 에이전트로 이동한 다음 시뮬레이션을 선택합니다.
케이스 생성
케이스 탭에서 케이스 생성을 선택한 후 다음 항목을 설정합니다.
| 필드 | 설명 |
|---|---|
| 케이스 이름 | 케이스의 고유한 이름입니다. |
| 워크플로 | 대화가 진입할 수 있는 워크플로입니다. 하나 이상 선택하세요. |
| 사용자 | 테스트 모드에서 대화를 실행할 사용자입니다. 이메일, 전화번호 또는 외부 사용자 ID로 검색할 수 있습니다. |
| 사용자의 첫 메시지 | 시뮬레이션 사용자가 보내는 첫 번째 메시지입니다. |
| 사용자가 원하는 것, 행동 방식, 알고 있는 것 | 시나리오입니다. 시뮬레이션 사용자는 여기에 작성한 내용만 알고 있습니다. 예를 들어 환불 문제로 불만을 느끼는 사용자나 예약을 원하는 사용자를 설정할 수 있습니다. |
| 기대 성과 | 에이전트가 해야 할 행동이나 말 각각에 대해 확인 가능한 문장 하나씩을 작성합니다. 예: “에이전트가 사용자에게 지원 이메일 주소를 안내합니다.” 최대 10개까지 추가할 수 있습니다. |
| 웹훅 응답 | 선택 사항입니다. 웹훅에 대해 모의 응답 대상을 켠 다음, 엔드포인트를 호출하는 대신 반환할 고정 값을 입력합니다. |
불만을 느끼는 사용자, 예약을 원하는 사용자, 환불 관련 질문이 있는 사용자 등 테스트하려는 각 시나리오에 대해 케이스를 생성하세요.
시뮬레이션 실행 및 결과 검토
시뮬레이션 실행을 선택하고 실행할 케이스를 고른 다음 실행 시작을 선택합니다. 이전 실행 내역은 실행 탭에서 검토할 수 있습니다.

Braze는 케이스에서 모의 처리하지 않은 웹훅을 모두 호출합니다. 엔드포인트 호출을 피하려면 워크플로에서 사용하는 모든 웹훅을 모의 처리하세요.
실행의 각 케이스에는 시뮬레이션 사용자와 에이전트 간의 대화, 그리고 각 기대 성과에 대한 결과와 설명이 표시됩니다.
- 통과
- 실패
- 판단 불가: 대화에 판단할 수 있는 근거가 충분하지 않은 경우
성과 중 하나라도 실패하면 케이스는 실패합니다. 실패한 성과는 없지만 판단 불가인 성과가 하나라도 있으면 케이스는 판단 불가가 됩니다. 그 외의 경우 케이스는 통과합니다.
대화 기록 검토
Conversational Agents 페이지에서 Conversation history를 선택합니다. 이 페이지에는 실제 사용자와의 대화와 미리보기에서 진행한 대화가 표시됩니다.
대화 기록을 사용하여 도구 호출을 검토하고 에이전트가 예상대로 동작하는지 확인하세요.

예시
가상의 의류 소매 브랜드인 Flash & Thread는 다음과 같은 2단계 쇼핑 워크플로를 사용할 수 있습니다.
- 1단계: 사용자에게 쇼핑하려는 제품 카테고리를 묻습니다.
- 2단계: 워크플로 속성 설정 도구를 사용하여 product_category 속성을 문자열로 캡처합니다. 이 속성은 사용자가 1단계에서 오늘 쇼핑하려고 한다고 말한 제품 카테고리를 기록합니다.
