Google 검색 도구를 사용하면 에이전트가 웹의 최신 정보를 기반으로 대답할 수 있으므로 대화가 실제 데이터에 그라운딩됩니다. 이 도구는 세계 지식, 최신 소식 또는 광범위한 주제가 필요한 시나리오에 적합합니다.
구성
도구를 만들 때 다음 설정을 구성합니다.
- 이름:
도구 인스턴스의 표시 이름입니다 (예:
search_web). - 설명: 도구의 목적에 관한 간단한 설명입니다. 추론 에이전트는 이 설명을 사용하여 도구를 호출할 시기를 결정합니다.
- 제외된 도메인: 검색 결과에서 제외할 도메인 목록입니다 (최대 2,000개). 예: 'www.example.com' 또는 'example.com'
- 기본 도메인: 검색 결과를 제한할 도메인 목록입니다 (최대 20개). 예: 'www.example.com' 또는 'example.com'
- 컨텍스트 URL: 그라운딩 컨텍스트를 위해 가져올 특정 URL입니다 (최대 20개). 모델은 이러한 페이지의 콘텐츠를 직접 사용합니다. 예: 'example.com/page/path'
- 모달리티:
상담사가 다양한 모달리티의 검색 결과를 처리하고 요약하는 방식을 맞춤설정합니다.
- 텍스트 프롬프트: 텍스트 대화에서 검색 결과를 처리하는 방법에 관한 안내입니다.
- 음성 프롬프트: 음성 대화에서 검색 결과를 처리하는 방법에 관한 안내입니다 (예: 음성을 위해 답변을 간결하고 자연스럽게 유지하고 원시 URL을 암송하지 않음).
설정 우선순위
도메인 및 URL 설정은 다음 순서로 적용됩니다.
- 제외된 도메인: 우선순위가 가장 높습니다. 컨텍스트 URL 또는 기본 도메인에 나열된 경우에도 도메인이 제외됩니다.
- 컨텍스트 URL: 도메인이 제외되지 않는 한 콘텐츠가 가져옵니다.
- 선호 도메인: 우선순위가 가장 낮습니다.
런타임 컨텍스트 URL
도구 구성에 제공된 컨텍스트 URL 외에도 런타임에 URL을 동적으로 삽입하도록 에이전트에 지시할 수 있습니다.
예를 들어 에이전트 요청 사항에 다음을 추가할 수 있습니다.
none
If the user query is about x, look into these urls url1, url2, url3 using
the 'Product Information Search' tool.
인용 및 인라인 인용
에이전트가 Google 검색 도구를 사용하여 대답을 그라운딩하면 런타임 응답에 생성된 문장을 웹 소스로 다시 추적하는 인용 메타데이터가 SessionOutput.citations에 포함됩니다.
인용 메타데이터에는 두 가지 기본 구성요소가 포함됩니다.
- 인용된 청크 (
cited_chunks): 그라운딩에 사용된 소스 문서 목록입니다. 소스uri, 페이지title, 스니펫text,requires_attribution표시기가 포함됩니다. - 인라인 인용 (
inline_citations):cited_chunk_indices에 직접 매핑되는 대답 텍스트의 정확한 바이트 범위 오프셋 (start_index및end_index)입니다. 클라이언트 애플리케이션에서 인라인 인용을 사용하여 에이전트의 대답에 있는 특정 주장에 고정된 대화형 위첨자 배지, 각주 또는 인라인 링크를 렌더링할 수 있습니다.
저작자 표시 요구사항
웹 그라운딩에서 반환된 인용에는 원본 출처에 대한 저작자 표시가 필요할 수 있습니다.
- 각
CitedChunk에서requires_attribution필드를 확인합니다. requires_attribution가true인 경우 클라이언트 애플리케이션은 소스 기여 분석을 표시하고 최종 사용자를 위해 소스 URI로 연결해야 합니다.