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