이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

에이전트 자주 묻는 질문

이 문서에서는 Braze 에이전트에 대해 자주 묻는 질문에 대한 답변을 제공합니다.

일반

Braze Agent와 의사 결정 에이전트의 차이점은 무엇인가요?

Braze Agent는 캔버스 단계 또는 카탈로그 필드에서 한 사용자의 컨텍스트를 기반으로 추론합니다. Decisioning Studio의 의사 결정 에이전트는 전체 모집단에서 측정된 성과를 학습합니다. 자세한 내용은 Braze Agent와 의사 결정 에이전트 비교를 참조하세요.

Braze Agents와 BrazeAI Operator의 차이점은 무엇인가요?

Operator는 대시보드에서 빌드하는 동안 함께 작동합니다. Braze Agents는 발송 시점에 실행되며 각 사용자에 대해 서로 다른 결과를 생성합니다. 자세한 내용은 콘텐츠 생성을 참조하세요.

Canvas Step Agent와 Catalog Agent의 차이점은 무엇인가요?

에이전트를 만들 때 Canvas Step Agent 또는 Catalog Agent 중 어떤 것을 만들지 지정합니다. 이에 따라 에이전트가 지원할 수 있는 지침과 옵션의 유형이 결정됩니다. Canvas Step Agent는 여정 내에서 실시간으로 사용자를 처리하고, Catalog Agent는 처리된 정보로 열을 추가하거나 업데이트하여 카탈로그 데이터를 보강합니다.

Auto 모델과 직접 모델 연동(BYO)의 장점은 무엇인가요?

Braze Auto 모델 사용의 장점은 다음과 같습니다:

API 키 검색이나 입력, 통합 설정이 필요하지 않음
각 호출을 작업에 가장 효과적인 모델로 자동 라우팅

현재 에이전트 사용량은 어디에서 확인할 수 있나요?

설정 > 청구 > 크레딧 사용량 > Agent Console로 이동하여 크레딧 소비, 호출 횟수 및 에이전트별 크레딧 비율을 확인할 수 있습니다. 자세한 내용은 일일 호출 및 크레딧 한도를 참조하세요.

에이전트 지침에서 조건부 Liquid 구문을 사용할 수 있나요?

아니요, {% if %} 구문과 같은 Liquid 블록을 작성하면 유효성 검사 오류가 발생할 수 있습니다. 대신 에이전트는 프롬프트에서 자연어 설명을 통해 다양한 시나리오를 처리할 수 있습니다.

에이전트가 전달한 특정 Liquid 속성이나 Canvas 컨텍스트 외의 사용자 데이터에 접근할 수 있나요?

아니요. 에이전트는 지침에서 Liquid를 사용하여 전달된 특정 사용자 데이터 포인트, + Agent context 선택, Canvas의 업스트림 Context 단계, 또는 Agent 단계의 추가 컨텍스트만 수신합니다. 에이전트는 수신하도록 구성하지 않은 속성에 대해 사용자 프로필을 검색할 수 없습니다.

또한 에이전트는 필수 데이터가 누락되었을 때 경고할 수 없으며, 프롬프트에 있는 내용만으로 진행합니다. 에이전트 설정을 의도적인 입력-출력 설계로 취급하세요: 에이전트가 필요로 하는 모든 필드를 전달하고 Agent Console > 로그에서 입력을 확인하세요. 자세한 안내는 에이전트가 수신하는 데이터를 참조하세요.

문제 해결

에이전트가 지침이나 규칙을 따르지 않는 이유는 무엇인가요?

가능하면 긍정적이고 명확한 지침을 작성하세요. 에이전트에게 무엇을 해야 하는지 알려주고, 제한 사항은 구체적인 용어로 명시하세요. 예: “{{product_name}}이 비어 있으면 제공되지 않은 것으로 처리하세요.”

Operator를 사용하여 프롬프트를 검토하세요. Operator는 지침을 단계별로 살펴보고 에이전트가 어디에서 벗어났을 가능성이 있는지 설명합니다.

Catalog 에이전트가 일부 행을 건너뛴 이유는 무엇인가요?

Catalog 에이전트는 실행에 필수로 표시한 열이 비어 있거나 누락된 경우 해당 행을 건너뜁니다. 예를 들어, 값이 채워지지 않은 gender 필드가 이에 해당합니다. 입력 열을 선택한 후 카탈로그 필드에 대한 필수 입력 컨트롤을 활성화하고, 에이전트가 실행되기 전에 값이 포함되어야 하는 열을 선택합니다. 선택된 열은 기본적으로 필수로 설정되지만, 호출을 차단하지 않고 비어 있어도 되는 열은 제거할 수 있습니다. 이렇게 하면 불완전한 데이터에 토큰을 낭비하는 것을 방지할 수 있습니다.

에이전트는 열 간 종속성도 따릅니다. 출력 열이 다른 열에 종속되는 경우(예: 열 D가 열 B와 C의 값을 필요로 하는 경우), 해당 행의 업스트림 열이 채워질 때까지 에이전트는 실행되지 않습니다.

자세한 내용은 Catalog 에이전트 모범 사례를 참조하세요.

실패한 에이전트 호출도 크레딧을 소모하나요?

실패 유형에 따라 다릅니다:

실패 유형	크레딧 소모 여부
사용량 제한 오류	아니요
모델 사용 불가	아니요
일일 호출 한도 도달	아니요
시간 초과	예

자세한 내용은 크레딧이 소모되는 경우를 참조하세요.

에이전트가 복잡한 작업을 처리하는 데 어려움을 겪고 있습니다. 성능을 어떻게 개선할 수 있나요?

에이전트가 요청한 작업을 처리하는 데 어려움을 겪는 경우, 하위 에이전트 접근 방식을 고려해 보세요. 예를 들어, 세 개의 에이전트를 사용하여 다음을 수행할 수 있습니다:

에이전트 1: 인바운드 비정형 Canvas 컨텍스트 데이터를 표준화하고 변환합니다.
에이전트 2: 항목 상세 정보의 카탈로그를 참조하여 관련될 수 있는 항목을 식별합니다.
에이전트 3: 각 항목에 대한 다양한 설명이 포함된 다른 카탈로그를 참조하여 사용자에게 가장 관련성 높은 항목 설명을 식별하고 이메일에 삽입합니다.

커스텀 에이전트가 자주 시간 초과되는 원인은 무엇인가요?

커스텀 에이전트는 다음과 같은 경우 시간 초과될 수 있습니다:

에이전트 지침이 불완전하거나 모순되는 경우
에이전트 지침이 모든 시나리오를 다루지 않거나 대체 조건을 포함하지 않는 경우(예: “모든 입력이 비어 있으면 ‘Could not personalize’를 출력하세요”)
에이전트 지침이 출력 탭에서 지정된 것과 다른 출력 형식을 요청하는 경우(예: 에이전트 지침은 문자열을 요청하지만 출력 탭에서 출력이 숫자로 정의된 경우)
에이전트의 작업이 너무 복잡하여 대신 하위 에이전트 접근 방식이 더 적합한 경우

시간 초과를 줄이는 방법

에이전트가 자주 시간 초과되는 경우, 계정 매니저에게 더 높은 시간 초과 한도에 대해 문의하기 전에 다음을 시도해 보세요:

더 단순하거나 비용이 낮은 모델을 선택하세요: 더 빠른 모델은 일반적으로 기본 시간 초과 기간 내에 완료됩니다. 사용할 모델 결정하기를 참조하세요.
사고 수준을 낮추세요(BYO 모델에만 해당): 최소에서 시작하여 출력 품질이 떨어지는 경우에만 높이세요. 사고 수준을 참조하세요.
프롬프트를 간소화하세요: 중복되는 지침을 제거하고, 예시를 줄이고, 출력 스키마를 좁히세요. Operator를 사용하여 지침을 검토하고 개선하세요.
복잡한 워크플로를 여러 에이전트로 분할하세요: 사용 사례에 여러 하위 단계가 있는 경우(예: 의도 분류 후 문구 생성), 하나의 에이전트가 모든 것을 처리하는 대신 Canvas 또는 카탈로그에서 별도의 에이전트를 순차적으로 사용하세요. 하위 에이전트 접근 방식을 참조하세요.

참고

시간 초과는 에이전트가 사용 가능한 출력을 반환하지 않더라도 Braze 크레딧을 소모합니다. 크레딧이 소모되는 경우를 참조하세요.

Canvas 단계 에이전트의 경우, 호출이 실패했을 때 사용자가 여전히 출력을 받을 수 있도록 에이전트 콘솔에서 대체 값을 구성하세요.

테스트에서는 에이전트가 잘 작동했는데, Canvas에서 실행하면 사용자별 데이터를 받지 못하는 이유는 무엇인가요?

에이전트가 테스트 중에는 올바르게 작동하지만 실제 Canvas에서 사용자별 데이터를 수신하지 못하는 경우, 다음 문제 해결 단계를 시도해 보세요:

에이전트가 수신해야 하는 사용자별 데이터가 에이전트 지침에 Liquid 변수로 입력되어 있는지 확인하세요.
Canvas 컨텍스트에 중요한 데이터가 있는 경우, 에이전트 구성에서 모든 Canvas 컨텍스트 추가 옵션을 사용하여 에이전트가 전체 Canvas 컨텍스트를 수신하도록 하세요.
에이전트가 접근해야 하는 Canvas 컨텍스트가 Canvas 컨텍스트로 저장되어 있는지 확인하세요. 에이전트 단계 전에 컨텍스트 단계를 사용하여 이 데이터를 저장하세요.

규정 준수

Agent Console은 GDPR/CCPA를 준수하나요?

네. 고객이 Braze Auto 모델(Gemini 기반)을 사용하는 경우, Google은 Braze의 하위 처리업체로서 고객과 Braze 간의 데이터 보호 어드바이저(DPA) 조건에 따라 활동합니다.

Agent Console은 HIPAA를 준수하나요?

네. Braze Auto 모델을 사용하는 경우, Auto 모델을 지원하는 Gemini를 포함하는 Google과의 별도 HIPAA(미국의료정보보호법) 계약인 비즈니스 어소시에이트 부록(BAA)을 체결하고 있습니다.

BAA는 Braze Auto 모델을 사용하는 고객에게만 적용됩니다. 고객이 자체 LLM 키를 사용하는 경우, Braze는 HIPAA가 적용되는 보호 대상 건강 정보(PHI)를 고객을 대신하여 LLM에 전송하지 않으며, 고객이 직접 전송합니다. 이 경우 Braze와 Google 간의 BAA는 적용되지 않습니다. 자체 LLM 키를 통한 데이터 처리는 고객의 계약 및 해당 LLM 제공업체와 직접 체결한 BAA의 적용을 받습니다.

New Stuff!