Genel Bakış
Haritalar Platformu Agentic UI Toolkit, özel olarak etkileşimli yapay zeka dönemine uygun şekilde tasarlanmış bir geliştirici araç setidir. Büyük dil modelleri (LLM'ler) ve yapay zeka ajanlarının coğrafi veriler için gerçek zamanlı, etkileşimli görsel yanıtlar oluşturmasına yardımcı olan bir dizi LLM sistem talimatı ve kullanıcı arayüzü bileşenleri kitaplığı sağlar.
Geliştiriciler, görsel öğeleri sabit kodlamak yerine araç kitini kullanarak LLM'den gelen "amaca dayalı talimatları" dinamik ve bağlama duyarlı haritalara ve yer gösterimlerine çevirebilir. Böylece kullanıcılar, sohbet deneyimi içinde etkileşimde kalır.
Yaygın kullanım alanları:
- Yapay Zeka Asistanları: Yerel sorgular (ör. oteller, restoranlar) için metin yanıtlarını görsel bağlamla zenginleştirme.
- Seyahat planlayıcılar: Haritaları, rotaları ve yer ayrıntılarını satır içi olarak gösterir.
- Neredeyse Hiç Kodlama Gerektirmeyen Geliştirme: Web ve mobil temas noktalarında birden fazla Haritalar API'sinin manuel olarak düzenlenmesiyle ilgili zorlukları azaltır.
Temel kavramlar
1. Ajan tabanlı kullanıcı arayüzü
Özellikle anlık LLM destekli deneyimler için tasarlanmış, ölçeklenebilir ve yüksek kaliteli görseller (ör. yer kartları, Immersive View'daki harita görünümleri ve rota önizlemeleri) sunun.
2. Bağlam açısından zengin deneyimler
Kullanıcıların sohbetten ayrılmadan keşif yapmasına ve karar vermesine olanak tanıyın. Fotoğraf galerileri, puanlar veya rota seçenekleri gibi zengin satır içi harita bağlamı sunmak kullanıcıların ilgisini canlı tutar ve onlara harekete geçme konusunda güven verir.
3. Akıllı bileşenler
Agentic UI araç seti, karmaşık coğrafi uzamsal mantığı otomatik olarak işler. Bağlamı ve düzeni anında kullanıcı niyeti'ne göre uyarlarken her etkileşimin markanızla bağlantılı olmasını sağlamak için stil oluşturur.
4. LLM'den bağımsız
Ajan tabanlı kullanıcı arayüzü araç seti, yapay zeka araç koleksiyonunuzdan bağımsızdır. Gemini'ı veya OpenAI ya da Anthropic'in modellerini kullanıyor olmanız ve temellendirilmiş veri kaynağınızdan bağımsız olarak Agentic UI araç seti, konum verilerini görselleştirmek için özel sunum katmanı sağlar.
Başlarken
Agentic UI araç setini kullanmaya başlamak için Google Gemini API anahtarı ve Google Haritalar Platformu API anahtarıyla başlatmanız gerekir.
Ayrıntılı talimatlar için Başlangıç Kılavuzu'na bakın.
Kullanıcı arayüzü sonuçları
Ajan tabanlı kullanıcı arayüzü araç seti, kutudan çıktığı haliyle kapsamlı bir özel kullanıcı arayüzü yetenekleri paketi sunar. Bu bileşenler web, Android ve iOS'te kullanılabilir.
- Yer Ayrıntıları (Kompakt): Kompakt bir kartta belirli ÖY bilgileri.
- Satır içi haritalar: Nokta veya alan bulucu.
- Satır İçi Harita + Rota: Navigasyon veya yolculuk önizlemeleri.
- Satır İçi Harita Ayrıntısı: Zengin görüntüler kullanarak konumun atmosferi veya bağlamı.
Sistem talimatları
Agentic UI araç seti, kullanıcı arayüzünün ne zaman ve nasıl oluşturulacağı konusunda ana LLM'ye yol göstermek için "sistem talimatları" sağlar.
Yönergeler
Ana makine modeli şunları anlamalıdır:
Hangi bileşenin hangi kullanıcı niyetine uygun olduğu (ör. yönlendirme sorguları için satır içi harita kullanma).
Parametrelerin doğal dilden şemaya eşlenmesi (ör. kullanıcı "manzaralı" istediğinde harita modu uydu olarak ayarlanır).
Araç kullanım şeması
Agentic UI araç seti, standart LLM araç kullanımı şemasıyla (ör. işlev çağrısı) uyumlu bir tanım kataloğu sunar.
Politikalar ve Hizmet Şartları
Bu kitaplık, Google Haritalar Platformu hizmetlerini kullanır. Bu kitaplık aracılığıyla Google Haritalar Platformu hizmetlerinin kullanımı, Google Haritalar Platformu Hizmet Şartları'na tabidir. Grounding Lite ve Google Haritalar ile Grounding gibi bazı API'ler ve arka uç hizmetleri için ek Hizmet Şartları koşulları geçerlidir. Bu koşulların da karşılanması gerekir.
Bu kitaplık, Google Haritalar Platformu Temel Hizmeti değildir. Bu nedenle, Google Haritalar Platformu Hizmet Şartları (ör. Teknik Destek Hizmetleri, Hizmet Düzeyi Sözleşmeleri ve Kullanımdan Kaldırma Politikası) bu kitaplıktaki kod için geçerli değildir.
Destek
Bu kitaplık, açık kaynak lisansı ile sunulur. Google Haritalar Platformu Destek Teknik Destek Hizmetleri Yönergeleri, SLA veya Kullanımdan Kaldırma Politikası kapsamında değildir. Ancak kitaplık tarafından kullanılan tüm Google Haritalar Platformu hizmetleri, Google Haritalar Platformu Hizmet Şartları'na tabi olmaya devam eder.
Google Haritalar kaynakları için atıf şartları
Agentic UI araç setinden gelen her araç yanıtında kaynaklar yer alır. Araç setinin sağladığı araçları kullanan sonuçları sunarken, ilişkili Google Haritalar kaynaklarını aşağıdaki koşulları karşılayacak şekilde eklemeniz gerekir:
- Google Haritalar kaynakları, kaynakların desteklediği oluşturulmuş içeriği hemen takip etmelidir.
- Google Haritalar kaynakları, tek bir kullanıcı etkileşimi içinde görüntülenebilmelidir.
Geri bildirim paylaşma
Haritalar ajan tabanlı kullanıcı arayüzü araç setiyle ilgili geri bildirimlerinizi paylaşmak için aşağıdaki formları kullanın: