개요
Maps Platform Agentic UI 툴킷 은 대화형 AI 시대를 위해 특별히 설계된 개발자 툴킷입니다. 대규모 언어 모델 (LLM)과 AI 에이전트가 지리 공간 데이터에 대한 실시간 대화형 시각적 응답을 빌드하는 데 도움이 되는 LLM 시스템 안내 및 UI 구성요소 라이브러리를 제공합니다.
개발자는 시각적 요소를 하드 코딩하는 대신 툴킷을 사용하여 LLM의 '의도 기반 안내'를 동적이고 컨텍스트를 인식하는 지도 및 장소 표시로 변환하여 사용자의 참여를 채팅 환경 내에서 유지할 수 있습니다.
일반적인 사용 사례는 다음과 같습니다.
- AI 어시스턴트: 지역 쿼리 (예: 호텔, 레스토랑)에 시각적 컨텍스트로 텍스트 응답을 보강합니다.
- 여행 플래너: 지도, 경로, 장소 세부정보를 인라인으로 표시합니다.
- 로우 코드 개발: 여러 지도 API를 수동으로 조정하는 데 따르는 어려움을 줄입니다.
주요 개념
1. 에이전트 지원 UI
실시간 LLM 기반 환경을 위해 특별히 설계된 확장 가능한 고품질 시각적 요소(예: 장소 카드, 몰입형 지도 뷰, 경로 미리보기)를 사용 설정합니다.
2. 컨텍스트가 풍부한 환경
사용자가 채팅을 종료하지 않고도 검색하고 결정할 수 있도록 지원합니다. 사진 갤러리, 평점, 경로 옵션과 같은 풍부한 인라인 지도 컨텍스트를 제공하면 사용자의 참여를 유도하고 사용자가 조치를 취할 수 있도록 지원합니다.
3. 지능형 구성요소
Agentic UI 툴킷은 복잡한 지리 공간 로직을 자동으로 처리하고 사용자 의도에 따라 컨텍스트와 레이아웃을 즉시 조정하며 모든 상호작용이 브랜드와 연결된 느낌을 주도록 스타일을 지정합니다.
4. LLM에 구애받지 않음
Agentic UI 툴킷은 AI 스택의 모델에 구애받지 않습니다. Gemini 또는 OpenAI 또는 Anthropic의 모델을 사용하든, 그라운딩된 데이터 소스와 관계없이 Agentic UI 툴킷은 위치 데이터를 시각화하는 전용 프레젠테이션 레이어를 제공합니다.
시작하기
Agentic UI 툴킷을 사용하려면 단일 API 키로 초기화해야 합니다. 이렇게 하면 기본 지도 서비스가 추상화되므로 별도의 API를 관리할 필요가 없습니다.
자세한 안내는 시작 가이드를 참고하세요.
UI 결과
Agentic UI 툴킷은 즉시 사용할 수 있는 포괄적인 특수 UI 기능을 제공합니다.
- 장소 세부정보 (간단): 간단한 카드에 특정 관심 장소 정보가 표시됩니다.
- 인라인 지도: 포인트 또는 영역 로케이터입니다.
- 인라인 지도 + 경로: 내비게이션 또는 여정 미리보기입니다.
- 인라인 지도 세부정보: 풍부한 이미지를 사용하여 위치 분위기 또는 컨텍스트를 표시합니다.
시스템 안내
Agentic UI 툴킷은 호스트 LLM이 UI를 구성하는 시점과 방법을 안내하는 '시스템 안내'를 제공합니다.
가이드라인
호스트 모델은 다음을 이해해야 합니다.
어떤 구성요소가 어떤 사용자 의도와 일치하는지 (예: 방향 쿼리에 인라인 지도 사용).
자연어에서 스키마로의 매개변수 매핑 (예: 사용자가 '경치 좋은'을 요청하는 경우 지도 모드를 위성으로 설정).
도구 사용 스키마
Agentic 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 지도 소스는 단일 사용자 상호작용 내에서 확인 가능해야 합니다.