Configura un proveedor compatible con OpenAI en Cline para responder preguntas sobre documentos con fuentes

Configura Cline para responder preguntas sobre documentos, no solo para acceder a modelos

Si quieres que un agente de programación responda preguntas sobre los documentos de un proyecto e indique de dónde procede cada respuesta, hay dos tareas distintas: conectar Cline a un endpoint de modelo y crear un flujo de recuperación y atribución de fuentes en torno a esa conexión. La documentación del SDK de Cline explica las credenciales del proveedor, los ID de modelo y la pasarela LLM. No documenta una función integrada de búsqueda de documentos ni de citas. Consulta la documentación de proveedores de modelos de Cline.

La siguiente configuración está dirigida a desarrolladores que utilizan el SDK de Cline. No es una guía paso a paso para configurar la extensión de escritorio de Cline ni otra interfaz; la fuente proporcionada no confirma esos ajustes. Para el SDK, Cline documenta un proveedor openai-compatible que utiliza una clave de API, una URL base y un ID de modelo. OneMux puede ser una opción práctica para acceder a modelos mediante una API compatible con OpenAI, pero la compatibilidad con un flujo de trabajo concreto de Cline depende del endpoint y de las funciones de solicitud que utilices.

Requisitos previos

Antes de configurar el agente, reúne lo siguiente:

• Un proyecto del SDK de Cline que utilice los paquetes pertinentes @cline/agents y del proveedor. Cline indica que @cline/agents y @cline/core utilizan internamente su capa LLM; consulta la documentación de los paquetes para conocer las importaciones exactas y la estructura del constructor de tu versión.
• Una clave de API del proveedor que vayas a utilizar, guardada fuera del control de versiones.
• La URL base compatible con OpenAI del proveedor y el ID de modelo exacto que acepta.
• Documentos disponibles para tu aplicación, además de un método de recuperación que encuentre los fragmentos pertinentes y conserve sus metadatos de origen.

Para configurar la cuenta y la API de OneMux, consulta la guía de inicio rápido de OneMux y la documentación de la API. Antes de utilizarlos, comprueba en la documentación el endpoint y el identificador de modelo actuales: este artículo no afirma que se haya probado un modelo, endpoint o integración concretos con Cline.

Configura el proveedor compatible con OpenAI

El patrón de configuración de proveedor documentado por Cline es:

const agent = new Agent({
  providerId: "openai-compatible",
  modelId: process.env.MODEL_ID,
  apiKey: process.env.PROVIDER_API_KEY,
  baseUrl: process.env.PROVIDER_BASE_URL,
})

Se omiten el símbolo Agent y las importaciones del paquete porque la referencia proporcionada para el proveedor no los especifica. Consulta la documentación de la versión instalada en tu proyecto para saber qué importaciones y opciones adicionales necesitas. Define MODEL_ID, PROVIDER_API_KEY y PROVIDER_BASE_URL en tu entorno local o gestor de secretos; son nombres de variables de entorno de ejemplo para la aplicación, no nombres de variables requeridos por Cline. Las variables comunes documentadas por Cline para OpenAI y otros proveedores específicos no establecen un nombre de variable estándar para todos los servicios compatibles con OpenAI.

Para configurar OneMux, consulta la documentación de la API de OneMux y obtén la URL base, la clave y el ID de modelo actuales. Después, introduce esos valores en los campos correspondientes. No des por sentado que todos los endpoints compatibles con OpenAI admiten todos los parámetros o funciones opcionales. Confirma el formato de solicitud, el método de autenticación y la disponibilidad del modelo que documenta el endpoint. En particular, la compatibilidad depende de que el proveedor admita los parámetros que envía tu agente.

Añade atribución de fuentes a las respuestas sobre documentos

Conectar un modelo no hace que busque en tus archivos ni que los cite. Implementa ese comportamiento en la capa de la aplicación:

1. Indexa los documentos con identificadores estables. Guarda un ID de fuente, el título del documento y la página, sección u otra ubicación de cada fragmento recuperable. Conserva esos metadatos junto con el texto.
2. Recupera información antes de preguntar. Busca fragmentos pertinentes para la pregunta del usuario y, después, incluye un conjunto reducido como contexto. La implementación de la búsqueda y el almacén de documentos quedan fuera de la configuración del proveedor descrita por la fuente de Cline.
3. Solicita referencias en la respuesta. Pide al modelo que responda únicamente con la información de los fragmentos proporcionados y que devuelva referencias usando los ID y las ubicaciones que le diste. Por ejemplo, solicita una respuesta concisa y una lista de ID de citas.
4. Valida las citas en el código. Comprueba que cada ID devuelto exista en el conjunto recuperado y genera los enlaces o las etiquetas a partir de tus propios metadatos. Si ningún fragmento respalda una respuesta, haz que el flujo indique que los documentos no permiten establecerla, en lugar de presentar una afirmación sin citar.

Un prompt para el paso de recuperación podría ser:

Answer the question using only the supplied document passages.
For each factual claim, cite the passage ID and location in brackets.
If the passages do not support an answer, say so.

Question: {{question}}
Passages:
{{retrieved_passages_with_ids_and_locations}}

Este es un patrón para la capa de la aplicación, no una API de citas documentada por Cline. El modelo puede generar una referencia que parezca verosímil pero sea incorrecta, así que valídala frente a los metadatos recuperados y, cuando sea necesario, frente al texto citado. Para respuestas de alto impacto, pide a una persona que revise la respuesta y el fragmento que la respalda.

Qué verificar y cómo solucionar problemas

Falla la autenticación: Comprueba que la clave esté disponible en el entorno del proceso, que pertenezca al servicio configurado y que el endpoint espere el método de autenticación utilizado por el cliente. Evita imprimir secretos en los registros.

No se encuentra el modelo: Confirma con el proveedor el ID de modelo exacto. La referencia de Cline utiliza un ID de modelo específico del proveedor; no garantiza que un ID determinado esté disponible en todos los servicios compatibles.

Las solicitudes fallan pese a que el endpoint se describe como compatible con OpenAI: Verifica la URL base, incluido si el proveedor requiere una ruta de versión como /v1. Después, compara los parámetros de solicitud y el formato de respuesta utilizados por la versión instalada de Cline con los que admite el endpoint según su documentación. La fuente de Cline proporcionada no enumera un conjunto universal de parámetros admitidos por endpoints de terceros.

Las respuestas no incluyen fuentes fiables: Comprueba que la recuperación haya devuelto fragmentos pertinentes, que cada fragmento tenga un identificador y una ubicación estables, y que tu aplicación valide las referencias devueltas. La configuración del proveedor por sí sola no puede corregir metadatos de recuperación ausentes o incorrectos.

La capa de proveedores de modelos de Cline también expone una pasarela y metadatos del modelo, incluidos campos como la ventana de contexto, los tokens máximos, los precios y las capacidades. La fuente señala que el uso de tokens y el costo pueden aparecer en los resultados del agente y en los eventos de uso, pero no establece que todos los proveedores compatibles expongan todos los campos de metadatos. Consulta la referencia de proveedores de Cline para ver los detalles documentados de la pasarela.

¿Es esta la configuración adecuada?

Usa este enfoque si tu agente de programación necesita consultar la documentación de un proyecto y puedes implementar la recuperación y las comprobaciones de citas en tu propia aplicación. Así separas el acceso al modelo de las funciones que hacen que las respuestas sean auditables. No es una función lista para usar de preguntas y respuestas sobre documentos, y la página citada de Cline no verifica una integración específica con OneMux ni un comportamiento de cita de documentos.

Como siguiente paso práctico, configura el endpoint con los valores indicados en la documentación del proveedor, prueba una solicitud sencilla y, después, añade la recuperación y la validación de citas como etapas separadas. Puedes consultar las opciones disponibles en la página de modelos de OneMux y los precios de OneMux para conocer los costos actuales de la cuenta; este tutorial no compara precios ni rendimiento.

Preguntas frecuentes

¿El proveedor compatible con OpenAI de Cline cita documentos automáticamente?

La documentación proporcionada de proveedores de Cline no confirma que exista esa función. Describe la configuración del proveedor y las capacidades de la pasarela. Tu aplicación debe recuperar documentos, proporcionar metadatos de las fuentes, solicitar referencias y validarlas.

¿Puedo usar OneMux con Cline?

La documentación del SDK de Cline describe un proveedor openai-compatible. OneMux permite acceder a modelos mediante una API compatible con OpenAI. Que una configuración concreta funcione depende del endpoint actual, el ID de modelo, la autenticación y los parámetros de solicitud; este artículo no afirma que se haya probado una integración.

¿Esta configuración es para la extensión del editor Cline?

La fuente citada trata sobre los proveedores de modelos del SDK de Cline. No explica cómo configurar un proveedor en la extensión del editor Cline ni en otras interfaces. Sigue la documentación del producto y la versión de Cline que utilices.

¿Cómo debe responder un agente cuando ninguna fuente respalda una respuesta?

Indícale que diga que los documentos proporcionados no permiten establecer la respuesta y valida las citas frente a los fragmentos recuperados por tu aplicación. No consideres que una cita generada por el modelo demuestra que el material referido respalda la afirmación.

Fuentes

• SDK de Cline: proveedores de modelos: configuración de proveedores, configuración compatible con OpenAI, pasarela, metadatos de modelos e información de uso.