지식 소스
지식 소스는 에이전트가 카탈로그 데이터를 에이전트 컨텍스트로 검색하고 가져오는 수단입니다. 지식 소스를 사용하면 에이전트가 카탈로그 콘텐츠를 해석하고 목표에 맞는 행과 필드를 반환할 수 있습니다. 카탈로그 에이전트는 배포된 카탈로그 필드에서 행 데이터도 받으며, 지식 소스는 + Agent context에서 검색 가능한 카탈로그 컨텍스트를 추가합니다. Braze Agents에 대한 소개는 Braze Agents를 참조하세요. 에이전트에 지식 소스를 추가하려면 커스텀 에이전트 만들기를 참조하세요.
작동 방식
지식 소스는 + 에이전트 컨텍스트로 추가하는 카탈로그의 큐레이트된 보기입니다. 지식 소스를 에이전트에 연결할 때는 사용 사례에 필요한 필드만 포함합니다. 에이전트는 카탈로그 정보가 필요할 때 지식 소스를 쿼리하여 일치하는 행을 검색합니다. Braze는 전체 카탈로그가 아닌 관련 카탈로그 데이터만 반환하므로, 에이전트는 핵심에 집중된 정확한 컨텍스트로 작업할 수 있습니다.
예를 들어, 사용자가 가장 좋아하는 요리(커스텀 속성)를 기반으로 뉴욕시의 레스토랑을 추천하는 에이전트를 만든다고 가정해 보겠습니다. 이 에이전트는 “nyc_restaurants” 카탈로그의 지식 소스를 참조합니다. 이 지식 소스를 에이전트에 연결할 때는 레스토랑 이름, 위치, 요리 종류처럼 에이전트에 필요한 필드만 포함하고, 추천에 도움이 되지 않는 다른 카탈로그 열은 제외합니다.
에이전트의 지침에는 에이전트의 역할과 제약 조건이 명확하게 설명되어 있습니다.
You are a restaurant recommendation agent. Use your knowledge to help find restaurants for the user. Only include filters in your knowledge source query. Don't ask any followup questions. The user's favorite cuisine is {{custom_attribute.${favorite_cuisine}}}
사용자가 가장 좋아하는 요리가 피자라면, 에이전트는 지식 소스를 바탕으로 다음과 같은 응답을 반환할 수 있습니다.
Here are some pizza recommendations for you:
- Dale's Pizza (Greenwich Village, Manhattan): Dale's Pizza invites you to savor the taste of authentic New York. Nestled in the heart of Manhattan, this iconic pizzeria offers a warm and inviting atmosphere perfect for any occasion.
- Pizza Palace (Carroll Gardens, Brooklyn): Pizza Palace is a highly-rated culinary gem renowned for its exquisite pizza. This inviting spot offers a warm and modern dining experience.
지식 소스 생성
지식 소스를 생성하려면 다음 단계를 따르세요:
- 에이전트 > 지식 소스로 이동합니다.
- 지식 소스 추가를 선택합니다. 드롭다운에서 카탈로그를 선택합니다.
- 드롭다운에서 카탈로그를 선택합니다.
- (선택 사항) 지식 소스에 어떤 내용이 포함되어 있는지 설명을 추가합니다.
- 지식 소스 생성을 선택합니다.

에이전트를 구축하는 도중에도 에이전트의 지침 섹션에서 지식 소스를 생성할 수 있습니다. 지식 추가 > 지식 소스 생성을 선택하세요.
인공지능 에이전트에서 지식 소스 사용하기
지식 소스 섹션에서 지식 소스를 관리할 수 있습니다. 이 섹션에서는 활성 상태인 지식 소스와 마지막 동기화 시점 등의 세부 정보를 확인할 수 있습니다. 지식 소스의 이름은 소스로 사용된 카탈로그의 이름과 같습니다.
인공지능 에이전트에서 지식 소스를 사용하려면 다음 단계를 따르세요.
- 에이전트의 지침 섹션으로 이동합니다.
- + 에이전트 컨텍스트 > 지식 추가를 선택합니다.
- 드롭다운에서 지식 소스를 선택합니다.
- 해당 지식 소스의 필드 구성을 선택한 다음, 에이전트가 검색할 때 사용하지 않아야 하는 카탈로그 필드의 선택을 해제합니다.
모든 카탈로그 필드를 포함하면 불필요한 컨텍스트가 추가되어 출력 품질이 떨어질 수 있습니다. 사용 사례와 관련 없는 필드의 선택을 해제하면 에이전트가 중요한 데이터에 집중하는 데 도움이 됩니다.
이제 에이전트가 지식 소스를 참조하고 관련 카탈로그 데이터를 가져올 수 있습니다.
대화형 에이전트의 경우, + 에이전트 컨텍스트 대신 워크플로 단계에서 지식 소스를 도구로 추가하세요. 자세한 내용은 지식 소스 검색을 참조하세요.
자주 묻는 질문
지식 소스는 어떻게 작동하나요?
카탈로그를 지식 소스로 변환하면 Braze Agents가 카탈로그에 있는 단어와 문구의 실제 의미를 이해할 수 있습니다. 그 결과 에이전트가 의미 있는 데이터를 더 효과적으로 찾아 더 나은 결과를 만들어 낼 수 있습니다.
지식 소스는 언제 만들어야 하나요?
에이전트가 카탈로그 데이터를 검색하거나 가져와야 할 때 지식 소스를 만드세요. 예를 들어 Canvas 여정 중에 여행지, 제품, 레스토랑을 조회하거나 대화형 워크플로에서 제품 및 FAQ 관련 질문에 답변해야 하는 경우입니다. 검색 가능한 카탈로그 컨텍스트를 추가하는 방법으로 지원되는 것은 지식 소스입니다. 배포된 행만 보강하는 카탈로그 에이전트는 런타임에 추가 카탈로그 데이터를 참조해야 하는 경우가 아니라면 지식 소스가 필요하지 않을 수 있습니다.
카탈로그를 에이전트 컨텍스트로 직접 첨부할 수도 있나요?
아니요. 새 에이전트는 기존의 카탈로그 필드 추가 옵션 대신 지식 소스를 사용합니다. 기존 에이전트가 이전의 카탈로그 필드 추가 옵션으로 구성되어 있다면, 동등한 지식 소스로 마이그레이션하는 동안 계속 사용할 수 있습니다.
에이전트에 지식 소스를 컨텍스트로 제공한 경우, 원본 카탈로그도 컨텍스트로 할당해야 하나요?
아니요. 지식 소스가 에이전트의 카탈로그 참조 역할을 하므로 둘 다 첨부할 필요가 없습니다. 지식 소스를 에이전트에 첨부할 때는 에이전트에 필요한 카탈로그 필드만 포함하세요.
지식 소스의 효과는 어떻게 평가해야 하나요?
여전히 카탈로그를 컨텍스트로 직접 첨부하고 있는 기존 에이전트를 복제한 다음, 동등한 지식 소스를 사용하도록 전환하세요. 에이전트 콘솔에서 몇 차례 테스트 호출을 실행해 정확성을 확인한 후, 기존 에이전트가 배포된 곳에서 새 에이전트로 교체하거나 실험 경로 단계를 사용해 기존 에이전트와 새 에이전트를 A/B 테스트하여 성능에 미치는 영향을 파악하는 것을 고려해 보세요.