커스텀 에이전트 생성

커스텀 에이전트를 생성하는 방법, 시작하기 전에 준비해야 할 사항, 그리고 메시징, 의사결정 및 데이터 관리 전반에 걸쳐 에이전트를 작동시키는 방법을 배웁니다. 더 일반적인 정보는 Braze Agents를 참조하세요.

필수 조건

Before you start, you’ll need the following:

• 작업 공간에서 Agent Console에 접근할 권한이 필요합니다. 이 옵션이 보이지 않으면 Braze 관리자에게 확인하세요.
• 커스텀 AI 에이전트를 생성하고 편집할 수 있는 권한입니다.
• 에이전트가 달성하기를 원하는 목표에 대한 아이디어입니다. Braze 에이전트는 다음과 같은 작업을 지원할 수 있습니다:
  • 메시징: 주제 라인, 헤드라인, 제품 내 복사 또는 기타 콘텐츠를 생성합니다.
  • 의사결정: 행동, 선호도 또는 커스텀 속성에 따라 Canvas에서 사용자를 라우팅합니다.
  • 데이터 관리: 값을 계산하고, 카탈로그 항목을 보강하거나, 프로필 필드를 새로 고칩니다.

작동 방식

에이전트를 생성할 때, 그 목적을 정의하고 어떻게 행동해야 하는지에 대한 가이드라인을 설정합니다. 라이브 상태가 되면, 에이전트는 Braze에서 개인화된 복사를 생성하고, 실시간 결정을 내리거나, 카탈로그 필드를 업데이트하는 데 배포될 수 있습니다. 대시보드에서 언제든지 에이전트를 일시 중지하거나 업데이트할 수 있습니다.

다음 사용 사례는 커스텀 에이전트를 활용하는 몇 가지 방법을 보여줍니다.

에이전트 생성

1단계: 에이전트 유형 선택

커스텀 에이전트를 생성하려면:

1. Braze 대시보드에서 에이전트 콘솔 > 에이전트 관리로 이동합니다.
2. 에이전트 생성을 선택합니다.
3. 캔버스 에이전트 또는 카탈로그 에이전트를 생성하도록 선택합니다.

2단계: 세부정보 설정

다음으로, 에이전트의 세부정보를 설정합니다:

1. 팀이 목적을 이해할 수 있도록 이름과 설명을 입력합니다.
2. (선택 사항) 에이전트를 필터링하기 위해 태그를 추가합니다.
3. 에이전트가 사용할 모델을 선택합니다.
4. 모델의 사고 수준을 선택합니다. 최소, 낮음, 중간 또는 높음 중에서 선택할 수 있습니다. 최소로 시작하고 에이전트의 응답을 테스트하고 필요에 따라 조정하는 것을 권장합니다.

Braze에서 커스텀 에이전트를 생성하기 위한

3단계: 지침을 작성하십시오

에이전트에게 지침을 제공합니다. 예기치 않거나 모호한 시나리오에서 에이전트가 수행해야 할 작업에 대한 지침을 포함하는 것이 좋습니다. 이것은 에이전트의 혼란이 오류로 이어질 위험을 최소화합니다. 예를 들어, 에이전트에게 “긍정적” 또는 “부정적” 감정 값만 요청하는 대신, 결정할 수 없으면 “확신 없음”을 반환하도록 요청하십시오.

최고의 관행을 위한 지침 작성을 참조하고 에이전트를 유도하는 방법에 대한 영감을 얻기 위해 예시를 참조하십시오.

3.1 단계: 맥락 추가

에이전트가 참조할 수 있는 내용을 선택하려면 맥락 추가를 선택하십시오. This includes:

• 카탈로그 필드: 보다 정확한 응답을 위해 에이전트에게 카탈로그 데이터에 대한 액세스를 제공합니다.
• 세그먼트 멤버십: 에이전트가 사용자가 속한 세그먼트에 따라 응답을 개인화할 수 있도록 합니다. 최대 다섯 개의 세그먼트를 선택할 수 있습니다.
• 브랜드 가이드라인: 에이전트가 따를 브랜드 음성과 스타일 가이드라인을 참조하십시오. 예를 들어, 에이전트가 사용자가 체육관 회원 가입을 유도하는 SMS 복사본을 생성하도록 하려면, 이 필드를 사용하여 미리 정의된 굵고 동기 부여가 되는 가이드라인을 참조할 수 있습니다.
• 모든 캔버스 컨텍스트: 이 에이전트가 호출될 때 사용자의 모든 캔버스 컨텍스트 데이터를 분석하십시오. 여기에는 지침 섹션에서 참조되지 않은 변수도 포함됩니다.

3.2 단계: 선택적 설정 추가

선택적 설정에서 에이전트 생성 복사본의 온도를 조정할 수 있습니다. 더 높은 온도는 에이전트가 제공된 정보를 사용하여 더 창의적으로 만들 수 있게 합니다.

에이전트의 일일 실행 한도를 설정할 수도 있습니다. 기본적으로 이 값은 250,000으로 설정되어 있지만 1,000,000으로 높일 수 있습니다. 1,000,000 이상의 한도를 늘리려면 고객 성공 매니저에게 문의하여 자세히 알아보십시오.

4단계: 출력 {#select-output} 선택

출력 섹션에서 기본 스키마 또는 고급 스키마에 따라 에이전트의 출력을 구성하고 정의할 수 있습니다.

최상의 결과를 얻으려면 출력 섹션에 지정한 내용이 3단계에 입력한 에이전트 지침과 일치하는지 확인하십시오. 예를 들어, 에이전트 지침에서 두 개의 문자열이 있는 객체를 원한다고 언급한 경우, 출력 섹션에서 두 개의 문자열이 있는 객체를 지정해야 합니다. 에이전트 지침이 지정한 출력과 일치하지 않으면 에이전트가 혼란스러워 하거나 시간 초과되거나 원하지 않는 출력을 생성할 수 있습니다.

기본 스키마

기본 스키마는 에이전트가 반환하는 간단한 출력입니다. 이것은 문자열, 숫자, 불리언, 문자열 배열 또는 숫자 배열일 수 있습니다.

예를 들어, 제품을 받은 후 고객의 만족도를 결정하기 위해 간단한 피드백 설문조사에서 사용자 감정 점수를 수집하려는 경우, 출력 형식을 구조화하기 위해 기본 스키마로 숫자를 선택할 수 있습니다.

고급 스키마

고급 스키마 옵션에는 필드를 수동으로 구조화하거나 JSON을 사용하는 것이 포함됩니다.

• Fields: 일관되게 사용할 수 있는 에이전트 출력을 강제하는 코드 없는 방법입니다.
• JSON: 정확한 출력 형식을 생성하는 코드 접근 방식으로, JSON 스키마 내에 변수와 객체를 중첩할 수 있습니다. 카탈로그 에이전트가 아닌 캔버스 에이전트에서만 사용할 수 있습니다.

에이전트가 단일 값 출력을 반환하는 것이 아니라 구조화된 방식으로 정의된 여러 값을 가진 데이터 구조를 반환하도록 하려면 고급 스키마를 사용하는 것이 좋습니다. 이것은 출력을 일관된 컨텍스트 변수로 더 잘 형식화할 수 있게 해줍니다.

예를 들어, 사용자가 제출한 양식을 기반으로 샘플 여행 일정을 생성하기 위한 에이전트 내에서 출력 형식을 사용할 수 있습니다. 출력 형식은 모든 에이전트 응답이 tripStartDate, tripEndDate, 및 destination 값에 대한 값을 반환해야 함을 정의할 수 있게 해줍니다. 이 값들은 모두 컨텍스트 변수에서 추출되어 Liquid를 사용하여 개인화를 위한 메시지 단계에 배치될 수 있습니다.

• fields
• json schema

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "type": "object",
  "properties": {
    "sentiment": {
      "type": "string"
    },
    "reasoning": {
      "type": "string"
    }
  },
  "required": [
    "sentiment",
    "reasoning"
  ]
}

5단계: 에이전트를 테스트하고 생성합니다.

미리보기 창은 구성 경험 내에서 나란히 패널로 표시되는 에이전트의 인스턴스입니다. 에이전트를 생성하거나 업데이트하는 동안 테스트하는 데 사용할 수 있으며, 최종 사용자와 유사한 방식으로 경험할 수 있습니다. 이 단계는 예상대로 작동하는지 확인하는 데 도움이 되며, 라이브로 전환하기 전에 미세 조정할 기회를 제공합니다.

1. 에이전트를 테스트하세요 필드에 예시 고객 데이터 또는 고객 응답을 입력하세요. 에이전트가 처리할 실제 시나리오를 반영하는 모든 것이 가능합니다.
2. 무작위 사용자, 기존 사용자 또는 커스텀 사용자에 대한 에이전트의 응답을 미리 봅니다.
3. 응답 시뮬레이션을 선택하세요. 에이전트는 귀하의 구성에 따라 실행되고 응답을 표시합니다. 테스트 실행은 귀하의 일일 실행 한도에 포함됩니다.

출력을 비판적인 시각으로 검토하세요. 다음 질문을 고려하세요:

• 복사본이 브랜드에 맞게 느껴지나요?
• 결정 논리가 고객을 의도한 대로 라우팅하나요?
• 계산된 값이 정확한가요?

무언가가 이상하게 느껴지면 에이전트의 구성을 업데이트하고 다시 테스트하세요. 에이전트가 시나리오에 따라 어떻게 적응하는지 보기 위해 몇 가지 다른 입력을 실행하세요. 특히 데이터가 없거나 잘못된 응답과 같은 엣지 케이스를 포함하여요.

Step 6: 귀하의 에이전트를 사용하세요

귀하의 에이전트가 이제 사용 준비가 완료되었습니다! 자세한 내용은 에이전트 배포를 참조하세요.

관련 문서

• 에이전트 참조