Municipio de Guadalajara
Asistente Virtual con IA conversacional embebido en App City para servicios municipales ciudadanos, impulsado por Claude de Anthropic sobre microservicios en AWS.
Data & IA · Amazon Web Services · Gobierno
El reto
El Municipio de Guadalajara, a través de su Dirección de Innovación y Servicios Digitales, es uno de los ayuntamientos más activos en transformación digital de México. Con más de 1.5 millones de habitantes y una agenda de gobierno digital ambiciosa, buscaba acercar los trámites y servicios municipales al ciudadano de forma rápida, segura y 24/7, sin filas ni desplazamientos.
El Municipio contaba con la app móvil App City como canal de interacción ciudadana, pero la atención a consultas sobre trámites, turismo, catastro y noticias dependía de canales presenciales o telefónicos con horario limitado. El reto era triple: integrar inteligencia artificial conversacional directamente dentro de App City para consultas en lenguaje natural en español; conectar en tiempo real con APIs municipales de trámites, turismo, catastro, noticias y convocatorias sin rediseñar los sistemas de backend existentes; y construir una plataforma segura, escalable y con capacidad de gestionar documentos —generación de PDFs, envío y recepción de archivos— directamente desde el chat. Adicionalmente, se requería un sistema de RAG (Retrieval-Augmented Generation) sobre documentos oficiales en PDF para responder consultas complejas con base en normativa y procedimientos vigentes.
La solución
iNBest diseñó y construyó el Asistente Virtual del Municipio de Guadalajara: un agente conversacional con IA de producción, desplegado en arquitectura de microservicios con Docker y orquestado con LangGraph para flujos agénticos complejos con tool-calling. El corazón del asistente es Claude API de Anthropic, seleccionado por su comprensión contextual en español, su precisión en razonamiento sobre documentos normativos (RAG sobre PDFs oficiales), su comportamiento predecible en producción ciudadana y el soporte nativo a Claude Code para acelerar el ciclo de desarrollo.
La arquitectura se compone de cuatro microservicios: Chat API (endpoint principal de conversación que conecta al ciudadano con el motor Claude vía LangGraph), Admin API (dashboard de administración para configuración del LLM, logs y monitoreo), LangGraph AI Engine (motor agéntico que orquesta tool-calling, gestión de contexto multi-sesión y flujos de trámites) y RAG Pipeline (recuperación sobre documentos PDF oficiales del municipio para respuestas normativas precisas).
Los módulos integrados incluyen API para consumo del asistente (REST + JWT/OAuth2), seguridad y autenticación (SSO + JWT integrado con App City), envío y recepción de documentos (PDF, imágenes, vídeos), gestión de PDFs con almacenamiento en Amazon S3 (URLs firmadas), monitoreo con sistema de logs y dashboard, y el módulo MCP de APIs municipales (Noticias/Convocatorias, Turismo y Catastro). Tecnologías clave: Claude API, Claude Code, LangGraph, Amazon S3, Docker, JWT/OAuth2, React Dashboard, Swagger/OpenAPI y LangSmith para observabilidad. El proyecto se ejecutó bajo metodología Scrum con sprints certificados mediante firma electrónica avalada por CINCEL (NOM-151).