Skip to main content
Glama
Redevil15

car-detailing-voice-agent

by Redevil15

Agente de Voz para Car Detailing — MCP + LangGraph

Agente conversacional por voz que permite a los clientes de un negocio real de car detailing consultar precios, revisar disponibilidad y agendar servicios hablando, sin usar la plataforma web.

El problema

El negocio tiene una plataforma digital funcional, pero un segmento importante de su clientela —clientes de mayor edad— no la usa con soltura. La barrera no es el servicio, es la interfaz. Una llamada telefónica sí es una interfaz que ya dominan.

Related MCP server: Garage-on-the-Go MCP Server

Arquitectura

graph TD;
	__start__([<p>__start__</p>]):::first
	agente(agente)
	herramientas(herramientas)
	clarificar(clarificar)
	manejar_error(manejar_error)
	confirmar(confirmar)
	responder_dato(responder_dato)
	ejecutar_registro(ejecutar_registro)
	__end__([<p>__end__</p>]):::last
	__start__ -.-> agente;
	__start__ -.-> ejecutar_registro;
	agente -. &nbsp;fin&nbsp; .-> __end__;
	agente -.-> herramientas;
	agente -.-> manejar_error;
	ejecutar_registro -. &nbsp;fin&nbsp; .-> __end__;
	ejecutar_registro -.-> manejar_error;
	herramientas -.-> agente;
	herramientas -.-> clarificar;
	herramientas -.-> confirmar;
	herramientas -.-> manejar_error;
	herramientas -.-> responder_dato;
	clarificar --> __end__;
	confirmar --> __end__;
	manejar_error --> __end__;
	responder_dato --> __end__;
	classDef default fill:#f2f0ff,line-height:1.2
	classDef first fill-opacity:0
	classDef last fill:#bfb6fc

Diagrama generado desde el código con draw_mermaid(). Se actualiza en cada fase; incluye la ruta determinista de clarificación y el manejo de errores.

Dos switches independientes

Switch

Qué controla

Valores

A — Infraestructura

Dónde corre la app completa

AWS ECS Fargate / homelab con Cloudflare Tunnel

B — Proveedor de voz

Qué implementación de VoiceProvider se usa

cloud (Azure Speech / Groq Whisper) / local (Faster-Whisper + Piper sobre ROCm)

Son ortogonales: la app en AWS puede usar voz local y viceversa. El switch B es un patrón Strategy detrás de la interfaz VoiceProvider.

Stack

Python 3.12 · LangGraph · MCP (Streamable HTTP) · FastAPI · SQLite · Docker · Langfuse · AWS ECS Fargate · Cloudflare Tunnel

Estado

  • Fase 0 — Fundamentos y entorno

  • Fase 1 — Servidor MCP con las herramientas del negocio

  • Fase 2 — Orquestador LangGraph

  • Fase 3 — Capa de voz local (el proveedor de nube llega en Fase 4)

  • Fase 4 — Despliegue dual (AWS + homelab)

  • Fase 5 — Observabilidad, evaluación y documentación

Cómo correr

uv sync
cp .env.example .env   # y llenar las claves
uv run agent/hello_graph.py

Decisiones de arquitectura

Cada decisión técnica, con sus alternativas descartadas y por qué, está en docs/decision-log.md.

Nota sobre los datos

Todos los datos de este repositorio son sintéticos. No se usa información real de clientes del negocio.

Diagramas

Diagramas interactivos de contenedores y despliegue: docs/arquitectura.html

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides 25 interactive automotive intelligence tools for real-time market data, including VIN decoding, price predictions, and inventory analytics. It enables AI assistants to perform car searches, trade-in estimations, and market trend analysis using the Model Context Protocol.
    2
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to decode VINs, check stolen vehicle databases, and retrieve market valuations through natural language.
    2
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    Exposes SMB business data as tools for AI agents, enabling retrieval of business profiles, services, availability, and reviews.
    -