Google 추천 검색어 사용

Google 검색으로 그라운딩을 사용하고 응답에 추천 검색어를 얻는 경우 프로덕션 및 애플리케이션에 추천 검색어를 표시해야 합니다.

Google 검색으로 그라운딩하는 방법에 관한 자세한 내용은 Google 검색으로 그라운딩을 참고하세요.

특히 그라운딩된 응답의 메타데이터에 포함된 검색어를 표시해야 합니다. 응답에 다음이 포함됩니다.

  • "content": LLM에서 생성한 응답입니다.
  • "webSearchQueries": 추천 검색어에 사용할 쿼리입니다.

예를 들어 다음 코드 스니펫에서 Gemini는 열대 식물 유형을 묻는 검색 그라운딩된 프롬프트에 응답합니다.

"predictions": [
  {
    "content": "Monstera is a type of vine that thrives in bright indirect light…",
    "groundingMetadata": {
      "webSearchQueries": ["What's a monstera?"],
    }
  }
]

추천 검색어를 사용하여 이 출력을 가져와 표시할 수 있습니다.

추천 검색어 요구사항

다음은 추천에 대한 요구사항입니다.

요구사항 설명
권장사항
  • 디스플레이 요구사항을 준수하면서 추천 검색어를 변경 없이 제공된 대로 정확하게 표시합니다.
  • 추천 검색어와 상호작용할 때 검색 결과 페이지(SRP)로 바로 이동합니다.
금지사항
  • 사용자 탭과 SRP 디스플레이 사이에 화면이나 추가 단계를 포함합니다.
  • 추천 검색어 또는 연결된 그라운딩된 LLM 응답 옆에 다른 검색 결과나 추천을 표시합니다.

디스플레이 요구사항

다음은 디스플레이 요구사항입니다.

  • 추천 검색어를 제공된 대로 정확하게 표시하고 색상, 글꼴 또는 모양을 수정하지 마세요. 추천 검색어가 밝은 모드와 어두운 모드와 같은 다음 모의에 지정된 대로 렌더링되는지 확인합니다.

  • 그라운딩된 응답이 표시될 때마다 해당 추천 검색어가 계속 표시되어야 합니다.
  • 브랜딩의 경우 브랜드 리소스 센터 시작에서 Google 브랜드 표시의 서드 파티 사용에 관한 Google 가이드라인을 엄격하게 준수해야 합니다.
  • 검색과 함께 그라운딩을 사용하면 추천 검색어 칩이 표시됩니다. 추천 칩이 포함된 필드는 LLM의 그라운딩된 응답과 너비가 같아야 합니다.

탭할 때 동작

사용자가 칩을 탭하면 칩에 표시된 검색어의 검색 결과 페이지(SRP)로 바로 이동합니다. SRP는 애플리케이션 내부 브라우저 또는 별도의 브라우저 애플리케이션에서 열 수 있습니다. 어떠한 방식으로든 SRP 디스플레이를 최소화, 삭제 또는 방해하지 않는 것이 중요합니다. 다음 애니메이션 목업에서는 탭-SRP 상호작용을 보여줍니다.

앱/데스크톱 예시

추천 검색어를 구현하는 코드

API를 사용하여 검색에 대한 응답을 그라운딩하는 경우, 모델 응답은 애플리케이션에서 추천 검색어를 표시하기 위해 구현하는 renderedContent 필드에 호환되는 HTML 및 CSS 스타일을 제공합니다. API 응답의 예시를 보려면 검색으로 그라운딩의 응답 섹션을 참조하세요.

다음 단계