HeartBeatAgents

Proveedor de embeddings

Ver como Markdown

Activa la búsqueda semántica real para la memoria y las habilidades conectando un proveedor de embeddings, o prescinde de ello y usa coincidencia de texto gratuita.

Búsqueda vectorial frente a solo texto

Configura esto desde Configuración → Embeddings. Por defecto, las búsquedas de memoria y habilidades usan coincidencia de texto (por palabras clave), sin coste adicional. Conectar un proveedor de embeddings activa en su lugar la búsqueda vectorial, de modo que una búsqueda coincide por significado en lugar de por palabras exactas. Un interruptor en la parte superior de la página alterna entre Búsqueda vectorial y Búsqueda solo de texto.

Proveedores admitidos

Siete proveedores, cada uno con su propio modelo de embeddings:

  • OpenAI
  • Voyage AI
  • Cohere
  • Mistral
  • Google Gemini
  • Hugging Face
  • Ollama (local): la única opción que no necesita clave de API. Apunta a una instalación local de Ollama y usa Descubrir para incorporar los modelos que ya tengas ahí.

La mayoría de los proveedores muestran un menú desplegable de modelos con las dimensiones y el coste por token de cada opción; Ollama y Hugging Face usan en su lugar un nombre de modelo en texto libre.

Prueba antes de guardar

Usa Probar conexión antes de guardar un proveedor nuevo o modificado. Devuelve las dimensiones y la latencia del vector resultante, para que sepas que la conexión realmente funciona antes de que la búsqueda de memoria y habilidades dependa de ella.

Cambiar de proveedor más adelante

Los embeddings de las habilidades se reconstruyen automáticamente en segundo plano si cambias de proveedor o de modelo; las habilidades existentes siguen funcionando con sus vectores anteriores hasta que termina la reconstrucción, para que la búsqueda no deje de funcionar mientras tanto. La memoria no se reconstruye de la misma manera: cambiar de proveedor cambia con qué se comparan las memorias nuevas, sin reconstruir retroactivamente las antiguas. Trata un cambio de proveedor como una decisión que tomar pronto, no algo que cambiar sin más una vez que un agente ha acumulado memoria significativa.

Si no está configurado o falla

No tener un proveedor de embeddings configurado, o tener uno inalcanzable, no rompe la búsqueda de memoria ni de habilidades: HeartBeatAgents recurre a la coincidencia de solo texto para esa búsqueda en lugar de dar un error. Consulta Un agente no recuerda la memoria correctamente si ves que ese respaldo ocurre de forma inesperada.

Relacionado