Usa esta guía para conectar Flowise a CometAPI configurando la URL base, la clave API y las opciones de model o provider.
FlowiseAI es una plataforma low-code para crear aplicaciones LLM de forma visual. Usa el nodo nativo ChatCometAPI para conectar CometAPI a chatflows, sistemas de preguntas y respuestas, y flujos de trabajo RAG que llaman modelos de chat de texto.
Esta guía cubre flujos de trabajo de chat de texto y RAG. No cubre flujos de trabajo de generación de imágenes.
Inicia sesión en la consola de CometAPI. Haz clic en Add API Key y copia tu clave API de CometAPI.
2
Añade el nodo ChatCometAPI
En el lienzo de chatflow de FlowiseAI, haz clic en Add New.
Busca cometapi y selecciona el nodo ChatCometAPI.
Arrástralo al lienzo.
3
Crea la credencial de CometAPI
En el nodo ChatCometAPI, abre Connect Credential, selecciona Create New, pega tu clave API de CometAPI y guarda la credencial.
4
Configura la ruta base de CometAPI
Expande Additional Parameters en el nodo ChatCometAPI.Si tu compilación de Flowise muestra un campo Base Path, configúralo en:
https://api.cometapi.com/v1/
Si en su lugar muestra Base Options, añade una entrada basePath:
{ "basePath": "https://api.cometapi.com/v1/"}
Configura Model Name con el model ID exacto del modelo de texto que quieras llamar, por ejemplo your-model-id, y ajusta Temperature solo si tu flujo de trabajo necesita más o menos variación.
Agrega un nodo Prompt Template y define el prompt que tu chatflow enviará al modelo.
Question: {question}Answer clearly and concisely.
2
Agregar una LLM Chain
Agrega un nodo LLM Chain. Conecta el nodo ChatCometAPI a la entrada Language Model de la cadena y luego conecta el nodo Prompt Template a la entrada Prompt de la cadena.
3
Guardar y probar el flujo
Guarda el chatflow, abre la vista previa del chat y envía una pregunta breve de prueba. Una configuración correcta devuelve una respuesta de texto normal del modelo CometAPI seleccionado.
Para cambiar de modelo, mantén la misma credencial de CometAPI y la misma ruta base, y luego cambia únicamente el campo de model ID de ChatCometAPI.Usa los model IDs exactos de la página de modelos de CometAPI. Evita copiar nombres para mostrar, nombres de proveedores o espacios adicionales.
Caso de uso
Valor de model ID
Familia de modelos de chat general
your-chat-model-id
Familia de modelos de razonamiento
your-reasoning-model-id
Familia de modelos de código
your-coding-model-id
Después de cambiar el model ID, guarda el chatflow y ejecuta un prompt de prueba breve. Si mantienes varios flujos de producción, primero duplica el chatflow y dale a cada copia un nombre que refleje la familia del modelo.
Flowise RAG tiene dos partes: primero prepara e inserta documentos en Document Stores, luego conecta el retriever preparado a un chatflow. ChatCometAPI es el modelo de chat que redacta la respuesta final; el Document Store aún necesita un proveedor de Embeddings compatible con Flowise y un vector store.
1
Crear y procesar un Document Store
En Flowise, abre Document Stores y crea un nuevo store. Agrega un cargador de documentos, como File Loader, PDF Loader, Web Scraper, u otro loader que coincida con tu fuente. Agrega un divisor de texto cuando el documento sea lo suficientemente largo como para necesitar fragmentación, luego haz clic en Process para previsualizar los fragmentos generados.
2
Configurar Embeddings y almacenamiento vectorial
Haz clic en Upsert o Upsert All Chunks. Selecciona:
Embeddings: un nodo de Embeddings de Flowise compatible con tus datos y tu vector store.
Vector Store: la base de datos vectorial donde Flowise debe almacenar los Embeddings de los documentos.
Record Manager: opcional. Úsalo cuando quieras que los upserts repetidos eviten registros duplicados.
Mantén alineada la dimensión del modelo de embedding con la dimensión del índice del vector store. Después de que finalice el upsert, usa la prueba de consulta de recuperación del Document Store para confirmar que se devuelven fragmentos relevantes antes de construir el chatflow.
3
Crear el chatflow de recuperación
En un chatflow, agrega un nodo Document Store (Vector) o Document Store Retriever y selecciona el Document Store procesado. Establece Top K en la cantidad de fragmentos que quieres que Flowise recupere para cada pregunta.
4
Conectar Conversational Retrieval QA Chain
Agrega Conversational Retrieval QA Chain y conecta:
La entrada Language Model desde ChatCometAPI.
La entrada Vector Store Retriever desde el retriever del Document Store.
Memory solo si tu chatflow necesita historial de conversación.
Activa Return Source Documents cuando quieras que la respuesta incluya citas o fragmentos fuente recuperados. Guarda el flujo y haz una pregunta cuya respuesta exista solo en el documento cargado.
Confirma que tu versión de Flowise incluya la integración del modelo de chat ChatCometAPI. En implementaciones de Flowise antiguas o personalizadas, actualiza Flowise o comprueba si el administrador ha deshabilitado la integración.
Las solicitudes fallan porque la ruta base es incorrecta
Establece la ruta base de CometAPI en https://api.cometapi.com/v1/. En algunas compilaciones de Flowise esto es un campo Base Path. En otras, agrega basePath dentro de Base Options.No uses https://api.cometapi.com para el chatflow de ChatCometAPI, porque el nodo de chat llama a rutas /chat/completions compatibles con OpenAI bajo /v1.
La API key o la credencial fallan
Vuelve a copiar la clave desde la consola de CometAPI, crea una credencial nueva de Flowise y asegúrate de que el chatflow use esa credencial. Si la misma clave funciona en llamadas directas a la API pero falla en Flowise, comprueba que Flowise no siga usando una credencial antigua asociada al nodo.
El model ID falla
Reemplaza el valor de model ID en el nodo ChatCometAPI por un model ID de texto actual y exacto de la página de modelos de CometAPI. El valor no debe incluir comillas, un prefijo de proveedor, una etiqueta visible ni espacios finales.
El flujo de trabajo intenta generar imágenes
ChatCometAPI es un nodo de modelo de chat para flujos de trabajo de texto. Úsalo para chat, chains, agents y generación de respuestas RAG. No uses esta configuración de Flowise para nodos de generación de imágenes ni para flujos de trabajo solo de imágenes.
RAG no devuelve fuentes o da respuestas débiles
Primero prueba la consulta de recuperación de Document Store antes de probar el chatflow completo. Si la recuperación es débil, ajusta el divisor de texto, el tamaño de chunk, la superposición de chunk, los filtros de metadatos y Top K. Si faltan citas, habilita Return Source Documents en Conversational Retrieval QA Chain.
La configuración de upsert o del vector store falla
Comprueba que el proveedor de embeddings, el vector store y las dimensiones del vector coincidan. Los vector stores de Flowise Cloud suelen requerir su propia URL de servicio accesible y credenciales; una URL de vector store solo local como localhost no será accesible desde Flowise Cloud. Record Manager es opcional, pero si lo habilitas, configura su conexión a la base de datos por separado.
La solicitud agota el tiempo de espera o está limitada por tasa
Reduce Top K de recuperación, disminuye el tamaño del prompt, usa chunks más pequeños o elige un model ID más rápido para el nodo ChatCometAPI. Para límites de tasa, espera y vuelve a intentarlo con menor concurrencia, y luego revisa el uso y los límites de la cuenta en la consola de CometAPI.