개요
Maps Platform 에이전트 UI 툴킷은 대화형 AI 시대를 위해 특별히 설계된 개발자 툴킷입니다. 대규모 언어 모델 (LLM)과 AI 에이전트가 지리 공간 데이터에 대한 실시간 대화형 시각적 응답을 빌드하는 데 도움이 되는 LLM 시스템 안내와 UI 구성요소 라이브러리를 제공합니다.
시각적 요소를 하드 코딩하는 대신 이 도구 키트를 사용하여 LLM의 '의도 기반 안내'를 동적이고 컨텍스트를 인식하는 지도 및 장소 디스플레이로 변환하여 사용자가 채팅 환경에 계속 참여하도록 할 수 있습니다.
일반적인 사용 사례는 다음과 같습니다.
- AI 어시스턴트: 호텔, 레스토랑과 같은 지역 검색어에 대한 시각적 컨텍스트로 텍스트 응답을 보강합니다.
- 여행 계획 도우미: 지도, 경로, 장소 세부정보를 인라인으로 표시합니다.
- 로우 코드 개발: 웹 및 모바일 터치 포인트에서 여러 지도 API를 수동으로 조정하는 번거로움을 줄입니다.
주요 개념
1. 에이전트 지원 UI
실시간 LLM 기반 환경을 위해 특별히 설계된 장소 카드, 몰입형 지도 뷰, 경로 미리보기와 같은 확장 가능한 고품질 시각 자료를 만드세요.
2. 맥락이 풍부한 환경
사용자가 채팅을 나가지 않고도 정보를 탐색하고 결정을 내릴 수 있도록 지원하세요. 사진 갤러리, 평점, 경로 옵션과 같은 풍부한 인라인 지도 컨텍스트를 제공하여 사용자의 참여를 유도하고 사용자가 자신 있게 조치를 취할 수 있도록 합니다.
3. 지능형 구성요소
에이전트 UI 툴킷은 복잡한 지리 공간 로직을 자동으로 처리하여 사용자 의도에 맞게 컨텍스트와 레이아웃을 즉시 조정하는 동시에 모든 상호작용이 브랜드와 연결된 느낌을 주도록 스타일을 지정합니다.
4. LLM 독립적
에이전트 UI 툴킷은 AI 스택에 구애받지 않는 모델입니다. Gemini, OpenAI 또는 Anthropic의 모델을 사용하는지 여부와 그라운딩된 데이터 소스에 관계없이 이 도구 키트는 위치 데이터를 시각화하는 전용 프레젠테이션 레이어를 제공합니다.
5. 서버 측 템플릿 아키텍처
서버 측 템플릿 아키텍처는 서버 측에서 템플릿 확장 및 매개변수 확인을 수행하여 구성요소 렌더링 속도를 높입니다. 이렇게 하면 실시간 대화 환경의 지연 시간이 개선됩니다.
시작하기
에이전트 UI 도구 키트를 사용하려면 Google Gemini API 키와 Google Maps Platform API 키로 초기화해야 합니다.
자세한 내용은 시작하기를 참고하세요.
UI 결과
에이전트 UI 도구 키트는 즉시 사용할 수 있는 포괄적인 전문 UI 기능 모음을 제공합니다. 이러한 구성요소는 웹, Android, iOS에서 사용할 수 있습니다.
- 장소 세부정보, 압축: 압축 카드에 표시되는 특정 관심 장소 (POI) 정보
- 인라인 지도: 지점 또는 지역 검색기
- 인라인 지도 + 경로: 내비게이션 또는 여정 미리보기
- 인라인 지도 세부정보: 풍부한 이미지를 사용한 위치 세부정보 또는 컨텍스트
시스템 안내
에이전트 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 지도 소스의 저작자 표시 요구사항
에이전트 UI 도구 키트의 각 도구 응답에는 소스가 포함됩니다. 툴킷에서 제공하는 도구를 사용하는 결과를 표시할 때는 다음 요구사항을 충족하는 방식으로 연결된 Google 지도 소스를 포함해야 합니다.
- Google 지도 소스는 해당 소스를 뒷받침하는 생성된 콘텐츠 직후에 따라와야 합니다.
- Google 지도 소스는 단일 사용자 상호작용 내에서 확인 가능해야 합니다.
의견 공유
지도 에이전트 UI 툴킷에 관한 의견을 공유하려면 다음 양식을 사용하세요.