Asistente RAG para Google Maps
Soporte para desarrolladores con IA para Google Maps Platform. Cada respuesta tiene fundamento en la documentación oficial, con citas en línea y una suite de evaluaciones versionada.
Sobre este proyecto
Un asistente RAG (Retrieval-Augmented Generation) de nivel productivo que responde preguntas de desarrolladores sobre la Maps JavaScript API, Places, Routes, facturación y troubleshooting. Construido con Claude Sonnet 4.6, embeddings voyage-code-3, Neon pgvector y el Vercel AI SDK. Incluye una suite de 12 preguntas evaluada con LLM-as-judge — el historial de git muestra el arco medido v1 → v2 → v3 hasta llegar a 12/12 en el set dorado. Cada respuesta emite citas en línea con puntajes de similitud coseno, para que cualquiera pueda verificar las fuentes. Está informado directamente por un año de soporte Tier 1 a Google Maps Platform en HCLTech.
Por qué importa
- RAG híbrido: corpus curado en Neon pgvector para las preguntas comunes y la herramienta web_search administrada de Anthropic para las preguntas de cola larga que no están en el corpus — en vivo contra developers.google.com
- Recuperación en dos etapas: bi-encoder voyage-code-3 para recall y cross-encoder rerank-2 para precisión, con fallback elegante a coseno cuando hay rate limit
- No alucina — preguntas adversariales (por ejemplo, 'precios de la Holographic API') se rechazan con razonamiento citado, no inventado
- Suite de evaluaciones versionada con calificación LLM-as-judge en 15 preguntas doradas. Cada corrida queda con timestamp en git, documentando el arco v1 → v2 → v4
- Las fuentes recuperadas se transmiten con sus puntajes de similitud como ciudadanos de primera clase en la UI — cualquiera puede verificar de dónde sale cada respuesta
- Construido con base en un año real de soporte Tier 1 a Google Maps Platform en HCLTech
Stack
- Next.js 16
- TypeScript
- Claude Sonnet 4.6
- Vercel AI SDK
- Voyage Embeddings
- Neon Postgres
- pgvector
- RAG
- LLM-as-Judge Evals
- Tailwind CSS
- shadcn/ui