개요
Maps Platform 에이전트 UI 툴킷은 대화형 AI 시대를 위해 특별히 설계된 개발자 툴킷입니다. 이 도구는 대규모 언어 모델 (LLM)과 AI 에이전트가 지리 공간 데이터에 대한 실시간 대화형 시각적 응답을 빌드하는 데 도움이 되는 LLM 시스템 명령어와 UI 구성요소 라이브러리를 제공합니다.
개발자는 시각적 요소를 하드 코딩하는 대신 툴킷을 사용하여 LLM의 '의도 기반 안내'를 동적이고 컨텍스트를 인식하는 지도 및 장소 디스플레이로 변환하여 사용자가 채팅 환경에 계속 참여하도록 할 수 있습니다.
일반적인 사용 사례는 다음과 같습니다.
- AI 어시스턴트: 지역 검색어 (예: 호텔, 레스토랑)에 대한 시각적 맥락으로 텍스트 응답을 보강합니다.
- 여행 플래너: 지도, 경로, 장소 세부정보를 인라인으로 표시합니다.
- 로우 코드 개발: 여러 Maps API를 수동으로 조정할 때 발생하는 마찰을 줄입니다.
주요 개념
1. 에이전트 지원 UI
실시간 LLM 기반 환경을 위해 특별히 설계된 확장 가능하고 고품질의 시각적 요소(예: 장소 카드, 몰입형 지도 뷰, 경로 미리보기)를 사용 설정합니다.
2. 컨텍스트가 풍부한 환경
사용자가 채팅을 나가지 않고도 정보를 확인하고 결정을 내릴 수 있도록 지원하세요. 사진 갤러리, 평점, 경로 옵션과 같은 풍부한 인라인 지도 컨텍스트를 제공하면 사용자의 참여도를 높이고 사용자가 안심하고 조치를 취할 수 있습니다.
3. 지능형 구성요소
에이전트 UI 툴킷은 복잡한 지리 공간적 로직을 자동으로 처리하여 컨텍스트와 레이아웃을 사용자 의도에 즉시 적응시키고, 모든 상호작용이 브랜드와 연결되도록 스타일을 지정합니다.
4. LLM에 구애받지 않음
에이전트 UI 툴킷은 AI 스택에 모델을 구애받지 않습니다. Gemini를 사용하는지, OpenAI 또는 Anthropic의 모델을 사용하는지, 그라운딩된 데이터 소스가 무엇인지에 관계없이 에이전트형 UI 툴킷은 위치 데이터를 시각화하는 전용 프레젠테이션 레이어를 제공합니다.
시작하기
에이전트 UI 툴킷을 사용하려면 Google Gemini API 키와 Google Maps Platform API 키로 초기화해야 합니다.
자세한 안내는 시작 가이드를 참고하세요.
UI 결과
에이전트 UI 툴킷은 특화된 UI 기능을 바로 사용할 수 있는 포괄적인 모음을 제공합니다.
- 장소 세부정보 (간결): 간결한 카드에 표시되는 특정 관심 장소 정보입니다.
- 인라인 지도: 포인트 또는 영역 위치 찾기
- 인라인 지도 + 경로: 내비게이션 또는 여정 미리보기
- 인라인 지도 세부정보: 풍부한 이미지를 사용한 위치 분위기 또는 맥락
시스템 안내
에이전트 UI 툴킷은 호스트 LLM이 UI를 언제 어떻게 구성해야 하는지 안내하는 '시스템 요청 사항'을 제공합니다.
가이드라인
호스트 모델은 다음을 이해해야 합니다.
어떤 구성요소가 어떤 사용자 의도와 일치하는지 (예: 방향 쿼리에 인라인 지도를 사용)
자연어에서 스키마로의 매개변수 매핑 (예: 사용자가 '경치'를 요청하면 지도 모드를 위성으로 설정).
도구 사용 스키마
에이전트 UI 툴킷은 표준 LLM 도구 사용 스키마 (예: 함수 호출)와 호환되는 정의 카탈로그를 노출합니다.
정책 및 서비스 약관
이 라이브러리는 Google Maps Platform 서비스를 사용합니다. 이 라이브러리를 통한 Google Maps Platform 서비스 사용에는 Google Maps Platform 서비스 약관이 적용됩니다. Grounding Lite 및 Google 지도 기반 그라운딩과 같은 일부 API 및 백엔드 서비스에는 추가 서비스 약관 요구사항이 있으며, 이 요구사항도 충족해야 합니다.
이 라이브러리는 Google Maps Platform 핵심 서비스가 아닙니다. 따라서 Google Maps Platform 서비스 약관 (예: 기술 지원 서비스, 서비스수준계약, 지원 중단 정책)은 이 라이브러리의 코드에 적용되지 않습니다.
지원
이 라이브러리는 오픈소스 라이선스를 통해 제공됩니다. Google Maps Platform 지원 기술 지원 서비스 가이드라인, SLA 또는 지원 중단 정책의 적용을 받지 않습니다. 하지만 라이브러리에서 사용하는 Google Maps Platform 서비스에는 Google Maps Platform 서비스 약관이 계속 적용됩니다.
Google 지도 소스의 저작자 표시 요구사항
Agentic UI 툴킷의 각 도구 응답에는 소스가 포함됩니다. 툴킷에서 제공하는 도구를 사용하는 결과를 표시할 때는 다음 요구사항을 충족하는 방식으로 연결된 Google 지도 소스를 포함해야 합니다.
- Google 지도 소스는 해당 소스를 뒷받침하는 생성된 콘텐츠 직후에 따라와야 합니다.
- Google 지도 소스는 단일 사용자 상호작용 내에서 확인 가능해야 합니다.
의견 공유
지도 에이전트 UI 툴킷에 관한 의견을 공유하려면 다음 양식을 사용하세요.