에이전트 자주 묻는 질문
이 문서에서는 Braze Agents에 대해 자주 묻는 질문에 대한 답변을 제공합니다.
일반
Braze Agent와 의사 결정 에이전트의 차이점은 무엇인가요?
Braze Agent는 캔버스 단계나 카탈로그 필드에서 한 사용자의 컨텍스트를 바탕으로 추론합니다. 반면 Decisioning Studio의 의사 결정 에이전트는 전체 사용자 집단에서 측정된 성과를 바탕으로 학습합니다. 자세한 내용은 Braze Agent와 의사 결정 에이전트 비교를 참조하세요.
Braze Agents와 BrazeAI Operator의 차이점은 무엇인가요?
Operator는 사용자가 대시보드에서 작업을 구성하는 동안 함께 작업합니다. Braze Agents는 발송 시점에 실행되며 사용자마다 다른 결과를 생성합니다. 자세한 내용은 콘텐츠 생성을 참조하세요.
캔버스 단계 에이전트와 카탈로그 에이전트의 차이점은 무엇인가요?
에이전트를 생성할 때 캔버스 단계 에이전트와 카탈로그 에이전트 중 어떤 유형을 만들지 지정합니다. 이 선택에 따라 에이전트가 지원할 수 있는 지침과 옵션의 유형이 결정됩니다. 캔버스 단계 에이전트는 여정 내에서 사용자를 실시간으로 처리하고, 카탈로그 에이전트는 처리된 정보로 열을 추가하거나 업데이트하여 카탈로그 데이터를 보강합니다.
자동(Auto) 모델과 자체 모델(BYO) 사용을 비교하면 어떤 이점이 있나요?
Braze 자동(Auto) 모델을 사용하면 다음과 같은 이점이 있습니다.
- API 키를 가져오거나 입력할 필요가 없고 통합 설정도 필요하지 않습니다.
- 각 호출이 작업에 가장 효과적인 모델로 자동 라우팅됩니다.
현재 에이전트 사용량은 어디에서 확인할 수 있나요?
설정 > 청구 > 크레딧 사용량 > 에이전트 콘솔로 이동하면 크레딧 소비량, 호출 횟수, 에이전트별 크레딧 비율을 확인할 수 있습니다. 자세한 내용은 일일 호출 및 크레딧 한도를 참조하세요.
에이전트 지침에 조건부 Liquid 문을 사용할 수 있나요?
아니요. {% if %} 문 같은 Liquid 블록을 작성하면 유효성 검사 오류가 발생할 수 있습니다. 대신 프롬프트에서 자연어 설명을 통해 에이전트가 다양한 시나리오를 처리하도록 할 수 있습니다.
에이전트가 제가 전달한 특정 Liquid 속성이나 Canvas 컨텍스트 외의 사용자 데이터에 액세스할 수 있나요?
아니요. 에이전트는 지침 내 Liquid, + 에이전트 컨텍스트 선택 항목, Canvas의 업스트림 컨텍스트 단계, 또는 에이전트 단계의 추가 컨텍스트를 통해 전달된 특정 사용자 데이터 포인트만 받습니다. 에이전트는 받도록 구성하지 않은 속성을 찾기 위해 고객 프로필을 검색할 수 없습니다.
또한 에이전트는 필요한 데이터가 누락되어도 경고하지 않고, 프롬프트에 있는 내용만으로 작업을 진행합니다. 따라서 에이전트 설정은 입력부터 출력까지 의도적으로 설계해야 합니다. 에이전트에 필요한 모든 필드를 전달하고, 에이전트의 로그 탭에서 입력값을 확인하세요. 자세한 안내는 에이전트가 받는 데이터를 참조하세요.
문제 해결
에이전트가 지침이나 규칙을 따르지 않는 이유는 무엇인가요?
가능하면 긍정적이고 명확한 지침을 작성하세요. 에이전트가 무엇을 해야 하는지 알려 주고, 제한 사항은 구체적으로 명시하세요. 예를 들면 다음과 같습니다. “{{product_name}}이(가) 비어 있으면 처음부터 제공되지 않은 것으로 간주하세요.”
Operator를 사용해 프롬프트를 검토하세요. Operator는 지침을 하나씩 살펴보고 에이전트가 어느 지점에서 의도와 다르게 동작했을 가능성이 높은지 설명합니다.
카탈로그 에이전트가 일부 행을 건너뛴 이유는 무엇인가요?
카탈로그 에이전트는 실행에 필요로 표시한 열이 비어 있거나 누락된 경우 해당 행을 건너뜁니다. 예를 들어 gender 필드가 채워지지 않은 경우가 이에 해당합니다. 입력 열을 선택한 후 카탈로그 필드에 대해 필수 입력 컨트롤을 활성화하고, 에이전트가 실행되기 전에 값이 있어야 하는 열을 선택하세요. 선택한 열은 기본적으로 필수로 설정되지만, 비어 있어도 호출을 막지 않아도 되는 열은 제거할 수 있습니다. 이렇게 하면 불완전한 데이터에 토큰이 낭비되는 것을 방지할 수 있습니다.
에이전트는 열 간의 종속성도 준수합니다. 출력 열이 다른 열에 의존하는 경우(예: D열에 B열과 C열의 값이 필요한 경우), 해당 행의 상위 열이 채워질 때까지 에이전트가 실행되지 않습니다.
자세한 내용은 카탈로그 에이전트 모범 사례를 참조하세요.
실패한 에이전트 호출도 크레딧을 소비하나요?
실패 유형에 따라 다릅니다.
| 실패 유형 | 크레딧 소비 여부 |
|---|---|
| 사용량 제한 오류 | 아니요 |
| 모델 사용 불가 | 아니요 |
| 일일 호출 한도 도달 | 아니요 |
| 시간 초과 | 예 |
자세한 내용은 크레딧이 소비되는 경우를 참조하세요.
에이전트가 복잡한 작업을 잘 처리하지 못합니다. 성능을 어떻게 개선할 수 있나요?
요청한 작업을 에이전트가 잘 처리하지 못한다면 하위 에이전트 방식을 고려해 보세요. 예를 들어 세 개의 에이전트를 사용해 다음과 같이 작업을 나눌 수 있습니다.
- 에이전트 1은 수신된 비정형 Canvas 컨텍스트 데이터를 표준화하고 변환합니다.
- 에이전트 2는 항목 세부 정보 카탈로그를 참조하여 관련성이 있을 만한 항목을 식별합니다.
- 에이전트 3은 각 항목에 대한 다양한 설명이 담긴 다른 카탈로그를 참조하여, 이메일에 넣을 사용자와 가장 관련성 높은 항목 설명을 식별합니다.
커스텀 에이전트가 자주 시간 초과되는 원인은 무엇인가요?
다음과 같은 경우 커스텀 에이전트가 시간 초과될 수 있습니다.
- 에이전트 지침이 불완전하거나 서로 모순되는 경우
- 에이전트 지침이 모든 시나리오를 다루지 않거나 대체 조건을 포함하지 않는 경우(예: “모든 입력이 비어 있으면 ‘개인화할 수 없음’을 출력하세요”)
- 에이전트 지침이 출력 탭에 지정된 형식과 다른 출력 형식을 요구하는 경우(예: 에이전트 지침은 문자열을 요구하지만 출력 탭에서는 출력이 숫자로 정의된 경우)
- 에이전트의 작업이 너무 복잡하여 하위 에이전트 방식이 더 적합한 경우
시간 초과를 줄이는 방법
에이전트가 자주 시간 초과된다면, 계정 매니저에게 더 높은 시간 초과 한도를 문의하기 전에 다음 방법을 시도해 보세요.
- 더 단순하거나 비용이 낮은 모델 선택: 더 빠른 모델은 일반적으로 기본 시간 초과 범위 내에 작업을 완료합니다. 사용할 모델 결정하기를 참조하세요.
- 사고 수준 낮추기(BYO 모델만 해당): 최소에서 시작하고, 출력 품질이 떨어지는 경우에만 수준을 높이세요. 사고 수준을 참조하세요.
- 프롬프트 단순화: 중복된 지침을 제거하고, 예시를 줄이고, 출력 스키마의 범위를 좁히세요. Operator를 사용해 지침을 검토하고 다듬을 수 있습니다.
- 복잡한 워크플로를 여러 에이전트로 분할: 사용 사례에 여러 하위 단계가 있는 경우(예: 의도를 분류한 다음 문구를 생성하는 경우), 모든 작업을 하나의 에이전트로 처리하는 대신 Canvas 또는 카탈로그에서 별도의 에이전트를 순서대로 사용하세요. 하위 에이전트 방식을 참조하세요.

캔버스 단계 에이전트의 경우, 호출이 실패해도 사용자가 출력을 받을 수 있도록 에이전트 콘솔에서 대체 값을 구성하세요.
테스트에서는 에이전트가 잘 작동했는데, Canvas에서 실행하면 사용자별 데이터를 받지 못하는 이유는 무엇인가요?
테스트 중에는 에이전트가 올바르게 작동하지만 실시간 Canvas에서 사용자별 데이터를 받지 못한다면 다음 문제 해결 단계를 시도해 보세요.
- 에이전트가 받아야 하는 사용자별 데이터가 에이전트 지침에 Liquid 변수로 입력되어 있는지 확인하세요.
- Canvas 컨텍스트에 중요한 데이터가 있다면, 에이전트 구성에서 모든 Canvas 컨텍스트 추가 옵션을 사용해 에이전트가 전체 Canvas 컨텍스트를 받도록 하세요.
- 에이전트가 접근해야 하는 Canvas 컨텍스트가 Canvas 컨텍스트로 저장되어 있는지 확인하세요. 에이전트 단계 앞에 컨텍스트 단계를 배치해 이 데이터를 저장하세요.
규정 준수
Agent Console은 GDPR/CCPA를 준수하나요?
예. 고객이 Gemini 기반의 Braze Auto 모델을 사용하는 경우, Google은 Braze의 하위 처리자 역할을 합니다. 이때 Google은 고객과 Braze 간에 체결된 데이터 처리 부속서(DPA)의 조건을 따릅니다.
Agent Console은 HIPAA를 준수하나요?
예. Braze Auto 모델을 사용하는 경우가 해당됩니다. Braze는 Auto 모델의 기반인 Gemini에 대해 Google과 별도의 HIPAA(미국의료정보보호법) 계약인 비즈니스 제휴 부속서(BAA)를 체결했습니다.
이 BAA는 Braze Auto 모델을 사용하는 고객에게만 적용됩니다. 고객이 자체 LLM 키를 사용하는 경우, Braze는 HIPAA 적용 대상인 보호 대상 건강 정보(PHI)를 고객을 대신해 LLM으로 보내지 않으며, 고객이 직접 보냅니다. 이 경우 Braze와 Google 간의 BAA는 적용되지 않습니다. 고객의 자체 LLM 키를 통한 데이터 처리에는 고객의 계약과 고객이 LLM 제공업체와 직접 체결한 BAA가 적용됩니다.
사용자가 삭제되면 에이전트 로그는 어떻게 되나요?
고객 프로필을 삭제하면 Braze는 에이전트의 로그에서 해당 사용자의 콘텐츠를 삭제 처리합니다. 이는 개별 사용자를 삭제하거나, 사용자 Segment를 삭제하거나, 워크스페이스를 삭제하는 경우에 모두 적용됩니다.
Braze는 해당 사용자의 각 로그 항목에서 다음 내용을 대체하거나 비웁니다.
- 렌더링된 Liquid 및 Canvas 컨텍스트를 포함한 에이전트 입력
- Braze가 입력에 추가한 프로필 데이터
- 에이전트 출력 및 모든 대체 값
- 도구 호출 인수 및 출력
또한 Braze는 사용자 ID도 제거하므로, 로그에서 해당 사용자를 검색해도 더 이상 해당 항목이 반환되지 않습니다. 에이전트의 지침은 변경되지 않습니다.
로그 항목 자체는 그대로 남으므로, 에이전트 호출 횟수와 크레딧 사용량에는 계속 포함됩니다. 삭제 전에 내보낸 로그는 변경되지 않습니다.