지식 소스
지식 소스는 에이전트가 에이전트 컨텍스트로 카탈로그 데이터를 검색하고 가져오는 방법입니다. 지식 소스는 에이전트가 카탈로그 콘텐츠를 해석하고 목표에 맞는 올바른 행과 필드를 반환하도록 도와줍니다. 카탈로그 에이전트는 배포된 카탈로그 필드에서 행 데이터도 수신하며, 지식 소스는 + Agent context에서 검색 가능한 카탈로그 컨텍스트를 추가합니다. Braze 에이전트에 대한 소개는 Braze 에이전트를 참조하세요. 에이전트에 지식 소스를 추가하려면 커스텀 에이전트 만들기를 참조하세요.
작동 방식
지식 소스는 + Agent context로 추가하는 카탈로그의 큐레이트된 뷰입니다. 지식 소스를 에이전트에 연결할 때, 사용 사례를 지원하는 필드만 포함합니다. 에이전트가 카탈로그 정보를 필요로 하면 지식 소스를 쿼리하여 일치하는 행을 검색합니다. 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.
지식 소스 만들기
지식 소스를 만들려면:
- Agent Console > Knowledge Sources로 이동합니다.
- Add knowledge source를 선택합니다. 드롭다운에서 Catalog를 선택합니다.
- 드롭다운에서 카탈로그를 선택합니다.
- (선택 사항) 지식 소스에 포함된 내용을 설명하는 설명을 추가합니다.
- Create knowledge source를 선택합니다.
에이전트를 구축하면서 지식 소스를 만들 수도 있습니다. 에이전트의 Instructions 섹션으로 이동한 후 Add knowledge > Create knowledge source를 선택합니다.
AI 에이전트에서 지식 소스 사용하기
지식 소스 섹션에서 지식 소스를 관리할 수 있습니다. 여기에서 활성화된 지식 소스와 마지막 동기화 시점 등의 세부 정보를 확인할 수 있습니다. 지식 소스의 이름은 소스로 사용되는 카탈로그의 이름과 동일합니다.
AI 에이전트에서 지식 소스를 사용하려면 다음을 수행하세요.
- 에이전트의 지침 섹션으로 이동합니다.
- + 에이전트 컨텍스트 > 지식 추가를 선택합니다.
- 드롭다운에서 지식 소스를 선택합니다.
- 지식 소스에 대해 필드 구성을 선택한 다음, 에이전트가 검색 시 사용하지 않아야 하는 카탈로그 필드의 선택을 해제합니다.
모든 카탈로그 필드를 포함하면 불필요한 컨텍스트가 추가되어 출력 품질이 저하될 수 있습니다. 사용 사례와 관련 없는 필드의 선택을 해제하면 에이전트가 중요한 데이터에 집중할 수 있습니다.
이제 에이전트가 지식 소스를 참조하고 관련 카탈로그 데이터를 검색할 수 있습니다.
대화형 에이전트의 경우, + 에이전트 컨텍스트 대신 워크플로 단계에서 지식 소스를 도구로 추가합니다. 지식 소스 검색을 참조하세요.
자주 묻는 질문
지식 소스는 어떻게 작동하나요?
카탈로그를 지식 소스로 변환하면 Braze Agents가 카탈로그에 있는 단어와 구문의 실제 의미를 이해할 수 있게 되어, 에이전트가 더 효과적으로 의미 있는 데이터를 찾아 더 나은 결과를 도출할 수 있습니다.
언제 지식 소스를 만들어야 하나요?
에이전트가 카탈로그 데이터를 검색하거나 조회해야 할 때 지식 소스를 만드세요. 예를 들어, Canvas 여정 중에 대상, 제품 또는 레스토랑을 조회하거나 대화형 워크플로에서 제품 및 FAQ 질문에 답변하는 경우입니다. 지식 소스는 검색 가능한 카탈로그 컨텍스트를 추가하는 지원 방식입니다. 배포된 행만 보강하는 Catalog Agents는 런타임에 추가 카탈로그 데이터를 참조해야 하는 경우가 아니라면 지식 소스가 필요하지 않을 수 있습니다.
카탈로그를 에이전트 컨텍스트로 직접 첨부할 수 있나요?
아니요. 새로운 에이전트는 레거시 Add catalog fields 옵션 대신 지식 소스를 사용합니다. 기존 에이전트가 레거시 Add catalog fields 옵션으로 구성된 경우, 동등한 지식 소스로 마이그레이션하는 동안 계속 사용할 수 있습니다.
에이전트에 지식 소스가 컨텍스트로 제공된 경우, 원본 카탈로그도 컨텍스트로 할당해야 하나요?
아니요. 지식 소스가 에이전트의 카탈로그 참조이므로 둘 다 첨부할 필요가 없습니다. 에이전트에 지식 소스를 첨부할 때, 에이전트에 필요한 카탈로그 필드만 포함하세요.
지식 소스의 효과를 어떻게 평가해야 하나요?
카탈로그를 컨텍스트로 직접 첨부한 기존 에이전트를 복제한 후, 동등한 지식 소스를 사용하도록 전환하세요. Agent Console에서 몇 가지 테스트 호출을 실행하여 정확성을 확인한 다음, 배포된 위치에서 기존 에이전트를 교체하거나, 이전 에이전트와 새 에이전트를 A/B 테스트(실험 경로 단계 사용)하여 성능 영향을 파악하는 것을 고려하세요.