대화형 에이전트

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

중요

대화형 에이전트는 현재 베타 버전입니다. 이 베타에 참여하고 싶으시면 Braze 계정 매니저에게 문의하세요.

프로덕션에 배포하기 전에 대화형 인공지능 사용에 따른 영향에 대해 법무 팀과 상의하세요.

작동 방식

대화형 워크플로는 에이전트가 완료하도록 하려는 작업입니다. 각 워크플로에는 목적, 채널 설정, 타겟 오디언스, 자연어로 작성된 단계가 포함됩니다. 단계에 도구를 추가하면 에이전트가 카탈로그를 검색하거나, 속성을 설정하거나, 이벤트를 기록하거나, 웹훅을 호출할 수 있습니다.

워크플로를 만든 후에는 설정에서 브랜드 가이드라인과 채널 동작을 확인하세요. 대화 미리 보기, 시뮬레이션 만들기, 대화 기록 검토를 사용해 경험을 테스트하고 도구 호출을 검토할 수 있습니다.

웹 채팅 위젯 설정

사이트에 Conversational Agents 채팅 위젯을 표시하려면 Braze 웹 SDK에서 다음 단계를 완료하세요.

1단계: SDK 인증 설정

웹 앱에 대해 SDK 인증을 활성화합니다.

2단계: 웹 SDK 설치

다음 중 하나를 설치합니다.

3단계: 사용자 제공 JavaScript를 활성화하여 초기화

initialize 호출에서 allowUserSuppliedJavascript: true를 설정합니다.

1
2
3
4

braze.initialize("{YOUR_API_KEY}", {
  baseUrl: "{YOUR_SDK_ENDPOINT}",
  allowUserSuppliedJavascript: true
});

{YOUR_API_KEY}를 웹 SDK API 키로, {YOUR_SDK_ENDPOINT}를 SDK 엔드포인트로 바꾸세요.

4단계: 채팅 위젯 활성화

세션을 열기 전에 braze.automaticallyManageChat()을 호출합니다.

1
2

braze.automaticallyManageChat();
braze.openSession();

대화형 워크플로 만들기

대화형 워크플로를 사용하여 작업을 정의하고, 채널과 오디언스를 선택하고, 각 단계에서 에이전트가 수행할 작업을 지정합니다.

1단계: 워크플로 세부 정보 설정

Agent Console > Conversational Agents로 이동한 다음 워크플로의 세부 정보를 설정합니다.

1. 워크플로 이름을 입력합니다.
2. 에이전트가 이 워크플로를 언제 사용해야 하는지 알 수 있도록 워크플로의 기능을 설명하는 목적을 입력합니다.
3. 이 워크플로를 활성화할 채널을 선택합니다. 지원되는 채널은 SMS, RCS, WhatsApp, 웹입니다.
   • 웹의 경우 이 워크플로를 활성화할 웹 앱을 선택합니다.
   • SMS, RCS, WhatsApp의 경우 이 워크플로를 활성화할 구독 그룹을 선택합니다.
4. 사용자가 이 워크플로에 액세스하기 위해 속해야 하는 Segments를 선택합니다.

SMS, RCS, WhatsApp의 경우 일부 인바운드 메시지 트리거가 에이전트를 차단할 수 있습니다. 설정 페이지에서 각 구독 그룹별로 에이전트를 차단할 수 있는 트리거를 검토하세요.

2단계: 워크플로 단계 작성

에이전트가 워크플로를 완료하기 위해 수행해야 하는 단계를 추가합니다. 워크플로에는 최대 10개의 단계를 포함할 수 있습니다. 각 단계에는 지침이 필요하며, 지침은 최대 5,000자까지 입력할 수 있습니다.

목표가 하나인 단계라면 지침을 1~3개의 짧은 문장으로 작성하세요. 규칙을 명확하게 유지하고, 에이전트가 사용자에게 보낼 다음 응답을 어떻게 표현해야 하는지 알 수 있도록 명시적인 질문이나 확인 문구로 마무리하세요.

3단계: 단계에 도구 추가

단계에는 에이전트가 작업하는 동안 사용하는 도구를 포함할 수 있습니다. 단계의 Instructions에서 /를 입력하면 도구가 삽입되며, 지침 안에 태그로 표시됩니다. 하나의 단계에서 최대 10개의 도구를 참조할 수 있습니다.

도구

단계에 다음 도구를 추가할 수 있습니다.

지식 소스 검색

이 도구를 사용하면 에이전트가 Braze 카탈로그를 쿼리하고 이해할 수 있습니다. 다음과 같은 카탈로그에 대한 지식 소스를 만들어 보세요.

• 제품 카탈로그
• FAQ
• 사이즈 차트

먼저 지식 소스 페이지에서 지식 소스를 만듭니다. 그런 다음 지침 텍스트 상자에 /를 입력하고 지식 소스 검색을 선택합니다. 기존 대화형 지식 소스 도구를 선택하거나 새 검색 도구 생성을 선택합니다.

새 도구를 만들 때는 이름과 설명을 입력한 다음 지식 소스를 선택합니다. 지식 소스를 선택한 후에는 에이전트가 액세스할 수 있는 필드를 선택합니다.

워크플로 속성 설정

이 도구를 사용하면 같은 워크플로의 이후 단계에서 에이전트가 다시 사용할 수 있는 속성을 설정할 수 있습니다. 워크플로 속성은 설정된 워크플로 안에서만 적용됩니다. 커스텀 이벤트 속성정보, 커스텀 속성 값, 웹훅 파라미터로 활용할 수 있습니다.

속성을 만들 때 선택적으로 허용 값을 추가할 수 있습니다.

• 허용 값을 비워 두면 에이전트가 대화 내용을 바탕으로 해당 유형의 어떤 값이든 설정할 수 있습니다.
• 허용 값을 추가하면 에이전트가 정의한 값 중에서만 선택하도록 제한할 수 있습니다. 이후 도구(예: 웹훅 호출, 커스텀 이벤트 기록, 커스텀 속성 설정)에서 에이전트가 자유롭게 고른 값 대신 통제된 값을 다시 사용해야 할 때 이 방법을 사용하세요.

지침에 /를 입력하고 워크플로 속성 설정을 선택합니다. 기존 워크플로 속성을 선택하거나 새 속성 생성을 선택합니다.

새 속성을 만들 때는 이름과 설명을 입력한 다음 유형을 선택합니다. 유형을 선택한 후에는 선택적으로 허용 값을 추가합니다.

워크플로 속성 가져오기

이 도구를 사용하면 이전 단계에서 설정한 워크플로 속성의 값을 가져올 수 있습니다.

커스텀 이벤트 기록

이 도구를 사용하면 Braze 커스텀 이벤트를 기록할 수 있습니다. 지침 텍스트 상자에 /를 입력하고 커스텀 이벤트 기록을 선택합니다. 기존 커스텀 이벤트 기록 도구를 선택하거나 새 커스텀 이벤트 도구 생성을 선택합니다.

새 도구를 만들 때는 커스텀 이벤트를 선택한 다음 이름과 설명을 입력합니다. 커스텀 이벤트와 함께 보낼 이벤트 속성정보를 선택합니다. 각 커스텀 이벤트 속성정보에는 다음 소스 중 하나를 사용할 수 있습니다.

모든 속성정보에 값을 설정할 필요는 없습니다. 일부 속성정보 유형은 지원되지 않습니다.

속성정보 값이 비어 있을 때 도구가 실패하도록 하려면 필수를 선택합니다.

사용자를 Canvas에 진입시키려면 Canvas가 엔트리 속성정보로 사용하는 커스텀 이벤트를 기록하세요.

커스텀 속성 설정

이 도구를 사용하면 사용자에게 커스텀 속성을 설정할 수 있습니다. 지침 텍스트 상자에 /를 입력하고 커스텀 속성 설정을 선택합니다. 기존 커스텀 속성 설정 도구를 선택하거나 새 커스텀 속성 도구 생성을 선택합니다.

새 도구를 만들 때는 이름과 설명을 입력한 다음 도구가 설정할 커스텀 속성을 선택합니다. 커스텀 속성에는 다음 소스 중 하나를 사용할 수 있습니다.

참고

커스텀 속성은 비동기적으로 설정됩니다. 에이전트가 커스텀 속성을 설정한 직후에 읽으면 아직 이전 값이 반환될 수 있습니다.

커스텀 속성 가져오기

이 도구를 사용하면 커스텀 속성을 가져올 수 있습니다.

사용자 속성 가져오기

이 도구를 사용하면 표준 고객 프로필 필드를 가져올 수 있습니다. 지침 텍스트 상자에 슬래시(/)를 입력하고 사용자 속성 가져오기를 선택합니다. 다음 필드 중 하나를 선택합니다.

• 외부 ID
• Braze ID
• 이메일
• 이름
• 성
• 전화번호

웹훅 호출

이 도구를 사용하면 웹훅을 호출할 수 있습니다. 지침 텍스트 상자에 /를 입력하고 웹훅 호출을 선택합니다. 기존 웹훅 도구를 선택하거나 새 웹훅 생성을 선택합니다.

새 도구를 만들 때는 이름과 설명을 입력한 다음 변수를 추가합니다. 변수를 사용하면 웹훅 URL, 본문 또는 헤더에 개인화된 값을 포함할 수 있습니다.

변수에는 다음 소스 중 하나를 사용할 수 있습니다.

변수를 설정한 후 요청 메서드를 선택합니다. 지원되는 요청 메서드는 다음과 같습니다.

• GET
• POST
• PUT
• PATCH
• DELETE

그런 다음 URL을 입력합니다. URL에서 변수를 사용하려면 {{variable_name}} 구문으로 참조합니다. 예를 들면 다음과 같습니다.

1

https://myurl.com/create/{{user_id}}

다음으로 요청 본문을 설정합니다. 본문을 비워 두거나 {{variable_name}} 입력 안내를 포함할 수 있는 문자열을 입력합니다. 대부분의 API에서는 JSON 본문을 보냅니다. 예를 들면 다음과 같습니다.

1
2
3
4
5
6
7

{
  "user": {
    "id": "{{external_id}}",
    "favorite_color": "{{favorite_color}}",
    "is_called_by_agent": true
  }
}

변수를 사용해 헤더를 설정할 수도 있습니다. 자격 증명이 필요하면 대시보드에서 연결된 콘텐츠 자격 증명을 만든 다음 이 도구에서 참조하세요.

웹훅 응답은 클 수 있으므로 워크플로에 필요한 필드만 추출할 수 있습니다. 응답 본문의 값을 가리키는 JMESPath 표현식으로 응답 필드를 만드세요. 이러한 필드를 제대로 추출하려면 응답 본문이 유효한 JSON이어야 합니다. 추출한 필드는 나중에 웹훅 응답 가져오기 도구로 참조할 수 있습니다.

웹훅 응답 가져오기

이 도구를 사용하면 이전 웹훅 호출 단계에서 추출한 웹훅 응답 필드를 참조할 수 있습니다.

설정

대화형 에이전트의 브랜드 가이드라인과 채널 동작을 구성합니다. 에이전트 콘솔 > 대화형 에이전트로 이동한 다음 설정을 선택하세요.

브랜드 가이드라인

에이전트가 응답할 때 따를 브랜드 가이드라인을 선택합니다. 가이드라인은 콘텐츠 > 브랜드 가이드라인에서 생성하고 관리할 수 있으며, 여기에서 그중 하나를 선택하면 됩니다.

웹 설정

시작 메시지를 설정합니다. 사용자가 웹 대화를 시작할 때 가장 먼저 보게 되는 메시지입니다.

SMS, RCS 및 WhatsApp 설정

다음 항목을 구성합니다.

우선 적용될 수 있는 트리거는 다음과 같습니다.

• 키워드 트리거
• 실행 기반 Campaigns
• 실행 기반 Canvas 진입
• Canvas 행동 경로
• Canvas 종료

대화 미리보기

미리보기하는 방법에는 두 가지가 있습니다.

• 저장된 워크플로를 편집할 때는 해당 워크플로만 미리 볼 수 있습니다. 새 워크플로는 저장하기 전까지 미리보기를 사용할 수 없습니다.
• 설정 페이지에서는 웹 앱 또는 구독 그룹에 대한 경험을 미리 볼 수 있습니다. 필요한 경우 초안 워크플로 포함을 선택하면 초안 워크플로를 활성화하기 전에 테스트할 수 있습니다.

두 경우 모두 특정 사용자로 미리보기합니다.

참고

미리보기 모드에서는 커스텀 속성이나 커스텀 이벤트가 기록되지 않습니다.

시뮬레이션 만들기

에이전트 콘솔 > 대화형 에이전트로 이동한 다음 시뮬레이션을 선택합니다.

사용자 시나리오와 예상 성과를 설명하는 시뮬레이션 사례를 만듭니다. 시뮬레이션을 실행하여 워크스페이스의 대화형 워크플로에 대해 해당 사례를 테스트합니다. 웹훅 응답을 모의로 설정하면 에이전트 동작을 평가하는 동안 사례 결과를 예측 가능하게 유지할 수 있습니다.

대화 기록 검토

Conversational Agents 페이지에서 Conversation history를 선택합니다. 이 페이지에는 실제 사용자와의 대화와 미리보기에서 진행한 대화가 표시됩니다.

대화 기록을 사용하여 도구 호출을 검토하고 에이전트가 예상대로 동작하는지 확인하세요.

예시

가상의 의류 소매 브랜드인 Flash & Thread는 다음과 같은 2단계 쇼핑 워크플로를 사용할 수 있습니다.

• 1단계: 사용자에게 어떤 제품 카테고리를 쇼핑하고 있는지 묻습니다.
• 2단계: 워크플로 속성 설정 도구를 사용해 product_category 속성을 문자열로 저장합니다. 이 속성은 1단계에서 사용자가 오늘 쇼핑하고 있다고 답한 제품 카테고리를 기록합니다.