Saltearse al contenido
Nappai Documentation

Couchbase

Couchbase guarda documentos en una colección de Couchbase y busca en ella por significado con un índice de búsqueda.

Una base de datos vectorial guarda textos de forma que se pueden buscar por su significado, no solo por palabras exactas. Así, un agente puede encontrar el párrafo de un manual que responde a una pregunta aunque esté escrito con otras palabras.

Cuándo usarlo

  • Tu aplicación ya usa Couchbase y quieres añadirle búsqueda por significado.
  • Quieres que un agente consulte documentos guardados en Couchbase.

Configuración

El campo Operation decide qué hace el componente, y según lo que elijas cambian los campos y las salidas:

  • Add (por defecto): guarda en la base los documentos que recibe en Ingest Data.
  • Search: busca los documentos más parecidos al texto de Search Query.
  • Retriever: ofrece la base como buscador para que la use otro componente, por ejemplo un agente o una cadena de preguntas y respuestas.

Necesitas una credencial Couchbase API con la cadena de conexión, el usuario y la contraseña. Consulta Credenciales.

CampoQué hace
Credential (obligatorio)La credencial Couchbase API con los datos de conexión.
OperationQué hace el componente: Add, Search o Retriever.
Ingest Data (obligatorio)Con Add. Los documentos que se guardan, normalmente los que salen de un divisor de textos o de un cargador de archivos.
Search QueryCon Search. El texto que se busca. Si lo dejas vacío no se devuelve nada.
EmbeddingEl conector donde enchufas el componente que convierte los textos en números para compararlos por significado, como OpenAI Embeddings. Usa siempre el mismo para guardar y para buscar.
Bucket Name (obligatorio)El bucket de Couchbase.
Scope Name (obligatorio)El ámbito dentro del bucket.
Collection Name (obligatorio)La colección donde se guardan los documentos.
Index Name (obligatorio)El índice de búsqueda de esa colección.

Opciones avanzadas

CampoQué hace
Number Of ResultsCuántos documentos devuelve cada búsqueda. Por defecto, 4.

Resultado

Las salidas dependen de Operation:

  • Results: con Add y Search. Con Search, la lista de documentos encontrados, que puedes pasar a un prompt o a un agente.
  • Vector Store: con Add. La base de datos, para conectarla a componentes que trabajan con una base vectorial.
  • Retriever: con Retriever. El buscador, para conectarlo a componentes que piden un buscador.

En modo herramienta, un agente puede usar el componente para buscar por sí mismo. Consulta Tool Mode.

Ejemplo

Una agencia de viajes guarda las descripciones de sus paquetes en Couchbase.

  1. Añade Couchbase con Operation en Search y rellena bucket, ámbito, colección e índice.
  2. Conecta el componente de embeddings con que se guardaron.
  3. Ponlo en modo herramienta para que el agente busque viajes por lo que pide el cliente.

Componentes relacionados