Construí un agente de IA que maneja pedidos, reembolsos y soporte sin LangChain

La inteligencia artificial aplicada al servicio al cliente ha evolucionado mucho más allá de los simples chatbots con reglas condicionales. Muchos equipos técnicos se enfrentan a una disyuntiva: o recurren a frameworks como LangChain que esconden los detalles críticos del funcionamiento, o construyen asistentes tan básicos que apenas superan un if-else encubierto. Pero ¿y si pudiéramos construir un agente de IA real, capaz de manejar pedidos, reembolsos y soporte, sin depender de capas de abstracción innecesarias? La respuesta está en un bucle infinito bien diseñado: el while(true). El principio es sorprendentemente simple: el modelo de lenguaje (LLM) recibe un mensaje, decide si necesita llamar a una herramienta (como buscar productos o crear un ticket) y, si lo hace, ejecuta la herramienta, alimenta el resultado de vuelta y repite el ciclo hasta que el LLM responde directamente. Eso es todo. La magia no está en el bucle, sino en cómo se estructuran las herramientas y los datos alrededor de él.

Cuando trabajamos en proyectos de aplicaciones a medida para comercio electrónico, uno de los patrones que más valor aporta es separar limpiamente las operaciones de lectura y escritura. En un agente de soporte, las herramientas de consulta —como verificar el estado de un pedido o consultar la política de devoluciones— son lecturas que acceden a una fuente de datos inmutable. En cambio, acciones como crear un ticket de soporte son escrituras que requieren validación, idempotencia y registro de auditoría. Esta división natural es lo que en arquitectura de software se conoce como CQRS (Command Query Responsibility Segregation), y ya aparece espontáneamente cuando el agente se construye de forma ordenada. No es necesario un framework pesado; basta con tener un registro de herramientas donde cada una sea un archivo independiente, y el bucle del agente nunca toque directamente las implementaciones.

En Q2BSTUDIO aplicamos estos principios en los proyectos de ia para empresas que desarrollamos. Combinamos la potencia de la inteligencia artificial con buenas prácticas de ingeniería: patrones como Factory, Repository y Command aparecen de manera natural cuando el código está bien organizado. Por ejemplo, el registro de herramientas actúa como una fábrica: el agente busca por nombre y ejecuta sin saber qué herramienta concreta está usando. Esto permite cambiar un motor de LLM (de Anthropic a OpenAI) con solo modificar un parámetro en el constructor. La misma flexibilidad se aplica a los datos: hoy una simulación con arrays en memoria, mañana una base de datos vectorial como PostgreSQL con pgvector para búsqueda semántica real. Esa transición es limpia porque la capa de datos está aislada mediante el patrón Repositorio.

Un aspecto crucial que suele omitirse en los tutoriales es cómo el LLM devuelve las llamadas a herramientas. Cuando enviamos la lista de herramientas al método messages.create() de la SDK de Anthropic, la respuesta no es un texto plano, sino un array de bloques de contenido, cada uno con su tipo (text o tool_use). El código debe filtrar esos bloques, identificar los que son llamadas a herramientas y ejecutarlos. TypeScript ayuda con guardias de tipo para asegurar que el tipado sea correcto. Si no hay llamadas, el bucle termina y se devuelve la respuesta textual. Este mecanismo es la base de cualquier agente que realmente decida qué hacer, sin necesidad de escribir nunca un if (mensaje.includes('pedido')).

Desde el punto de vista de despliegue, una pregunta frecuente es si se necesita WebSockets o Server-Sent Events (SSE) para que el agente funcione. La respuesta es no. El bucle completo —varias llamadas al LLM, ejecución de herramientas, retroalimentación— ocurre en el servidor dentro de una única función asíncrona. El cliente envía una solicitud y recibe una respuesta al final. SSE es una mejora de experiencia de usuario para mostrar tokens en tiempo real, pero no un requisito técnico. Un agente perfectamente funcional puede operar con el modelo clásico petición-respuesta.

¿Y cómo se escala esto a producción? La ciberseguridad es un factor diferencial: cuando las herramientas ejecutan escrituras, cada operación debe ser validada y registrada. En Q2BSTUDIO integramos servicios cloud aws y azure para garantizar disponibilidad, escalabilidad y trazabilidad. Además, combinamos la lógica del agente con servicios inteligencia de negocio como Power BI para monitorizar en tiempo real las consultas y reacciones del asistente, permitiendo a los equipos de producto ajustar el comportamiento sin tocar el código base.

En definitiva, construir un agente de IA desde cero no es solo un ejercicio académico; es una estrategia que da control total sobre el comportamiento, el rendimiento y la seguridad. Al evitar frameworks que ocultan la lógica, el equipo adquiere un entendimiento profundo del sistema y puede escalarlo con patrones probados. En Q2BSTUDIO ayudamos a empresas a diseñar e implementar estos agentes IA personalizados, combinando software a medida, infraestructura cloud y buenas prácticas de seguridad. El resultado es un asistente que no solo responde preguntas, sino que ejecuta acciones de forma autónoma, con la misma solidez que un sistema enterprise.