Saltar al contenido principal
Contenido actualizado: 2026-06-09
LangChain es uno de los marcos de desarrollo de aplicaciones LLM más utilizados, adecuado para encapsular interfaces de chat, cadenas de indicaciones, llamada de herramientas, RAG, flujos de trabajo tipo agente y orquestación a nivel de aplicación. Para conectar con Crazyrouter, la forma más estable es utilizar el componente compatible con OpenAI oficialmente soportado por LangChain.

Resumen

A través del componente OpenAI de LangChain, puedes enviar solicitudes a Crazyrouter:
  • Protocolo recomendado: OpenAI-compatible API
  • Base URL: https://api.crazyrouter.com/v1
  • Variable de autenticación: OPENAI_API_KEY
  • Paquete principal de Python: langchain-openai
  • Paquete principal de JavaScript / TypeScript: @langchain/openai
Si planeas integrar Crazyrouter en tu código de aplicación (no solo chatear en el cliente de escritorio), LangChain suele ser el camino de integración ingenieril más natural.

¿Para quién es?

  • Desarrolladores que quieren integrar Crazyrouter formalmente en proyectos de Python o Node.js
  • Personas que desean construir cadenas de indicaciones, RAG, llamadas de herramientas y orquestación de flujos de trabajo
  • Quienes buscan abstraer la lógica de llamado a modelos y no quieren escribir solicitudes HTTP de bajo nivel manualmente
  • Usuarios que desean mantener flexibilidad para cambiar modelos o proveedores en el futuro

Protocolo de uso

Protocolo recomendado: OpenAI-compatible API Configuración central de Crazyrouter relacionada:
La sintaxis habitual en LangChain sería:
  • Python: api_key + base_url
  • JavaScript / TypeScript: apiKey + configuration.baseURL

Requisitos del sistema y condiciones previas

Lista blanca inicial recomendada:
  • gpt-5.5
  • claude-opus-4-8
  • gemini-3.1-pro
  • text-embedding-3-large

Ruta completa de integración para proyectos Python

Camino recomendado para Windows

Si deseas ejecutar el ejemplo de FAISS, añade:

Camino recomendado para macOS / Linux

Si deseas ejecutar el ejemplo de FAISS, añade:

Ruta completa de integración para proyectos JavaScript / TypeScript

Windows PowerShell

macOS / Linux

Configuración completa desde cero

1

Paso 1: Crear un token dedicado para LangChain en Crazyrouter

Para la primera vez, solo se recomienda permitir:
  • gpt-5.5
  • claude-opus-4-8
  • text-embedding-3-large
Si luego necesitas más modelos, amplía según sea necesario, pero la primera vez mantén la lista blanca mínima.
2

Paso 2: Configura variables de entorno primero

Si planeas desarrollar a largo plazo, configura la persistencia:
3

Paso 3: Completa la verificación mínima del chat en Python

Crea un test_langchain_chat.py nuevo:
Ejecuta:
4

Paso 4: Modifica a la versión con variables de entorno

Una vez funcione, no se recomienda codificar la key directamente en el código:
5

Paso 5: Realiza la verificación mínima del chat en JavaScript / TypeScript

Crea un test-langchain-chat.mjs nuevo:
Ejecuta:
6

Paso 6: Agrega paso a paso Embeddings, Prompt, RAG

No se recomienda empezar directamente con cadenas complejas. Orden recomendado:
  1. Ejecutar primero chat de un solo turno
  2. Luego Prompt + Output Parser
  3. Después agregar Embeddings
  4. Finalmente implementar RAG o Agent

Ejemplo en Python

Ejemplo de chat mínimo

Ejemplo de Embeddings

Ejemplo de cadena Prompt

Ejemplo mínimo de RAG

Ejemplo en JavaScript / TypeScript

Ejemplo de chat mínimo

Configuración de modelos recomendada

Mejores prácticas para la configuración de tokens

Lista de verificación de validación

  • Entorno de ejecución Python o Node.js listo
  • OPENAI_API_KEY configurado correctamente
  • langchain-openai o @langchain/openai instalado
  • El modelo de chat configurado como base_url / baseURL a https://api.crazyrouter.com/v1
  • Primera solicitud Reply only OK con respuesta exitosa
  • Puedes ver la solicitud correspondiente en los logs de Crazyrouter
  • Si usas embeddings, el modelo de embedding también está permitido
  • Si usas RAG, valida primero con el conjunto mínimo de texto

Errores comunes y soluciones

FAQ

¿Qué protocolo hay que usar para conectar Crazyrouter a LangChain?

Prioriza el protocolo compatible con OpenAI.

¿Qué Base URL hay que poner?

Pon https://api.crazyrouter.com/v1.

¿Qué paquete hay que usar en Python?

Prioriza langchain-openai.

¿Qué paquete hay que usar en JavaScript / TypeScript?

Prioriza @langchain/openai.

¿Por qué no se recomienda iniciar directamente con Agent o RAG a gran escala?

Porque la complejidad de las cadenas en LangChain aumenta significativamente los costos de depuración. Es mejor validar primero el chat mínimo y luego agregar componentes gradualmente.
Si planeas integrar Crazyrouter formalmente en tu aplicación, LangChain sigue siendo una de las documentaciones de marco de desarrollo más prioritarias para completar.