Document

Document es el componente de MongoDB para trabajar con los documentos de una colección: buscarlos, añadir nuevos, cambiarlos, sustituirlos, borrarlos o contarlos.

Cuándo usarlo

• Guardar en MongoDB los datos que llegan por un formulario o una API.
• Dar a un agente acceso a consultar pedidos o clientes guardados en MongoDB.
• Marcar como procesados los documentos que ya ha tratado un flujo.
• Contar cuántos documentos cumplen una condición para un informe.

Configuración

El campo Operation decide qué hace el componente: Find (por defecto), Insert, Update, Delete, Count o Replace. Las condiciones y los datos se escriben en formato de MongoDB, por ejemplo {"estado": "activo"}.

Necesitas una credencial MongoDB Connection con los datos de tu clúster de MongoDB. Consulta Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial MongoDB Connection.
Database Name (obligatorio)	La base de datos donde está la colección.
Collection Name (obligatorio)	La colección con la que se trabaja.
Operation (obligatorio)	Qué hace el componente.
Filter (obligatorio)	Qué documentos se cambian, sustituyen o borran. Por ejemplo, {"estado": "activo", "edad": {"$gt": 18}}. Usa {} para todos con Update y Replace; Delete rechaza {} para que nunca se vacíe una colección por error.
Query Filter	Con Find y Count, qué documentos se buscan o se cuentan. Vacío o {}, todos.
Document (obligatorio)	Con Insert y Replace, el documento que se añade o que sustituye al existente, por ejemplo {"nombre": "Ana", "email": "ana@ejemplo.com"}. Puede llegar de otro componente; con Insert, una lista de datos añade un documento por elemento.
Update Data (obligatorio)	Con Update, qué se cambia, con los operadores de MongoDB: {"$set": {"estado": "activo"}} cambia un valor y {"$inc": {"visitas": 1}} suma uno.

Opciones avanzadas

Campo	Qué hace
Upsert	Crea un documento nuevo si ninguno cumple el filtro. Desactivado por defecto.
Multiple Documents	Activado (por defecto), los cambios se aplican a todos los documentos que cumplen el filtro; desactivado, solo al primero.
Limit	Cuántos documentos devuelve Find como máximo. Por defecto, 100.
Skip	Cuántos resultados se saltan, para leer por páginas. Por defecto, 0.
Sort	El orden de los resultados: 1 ascendente y -1 descendente, por ejemplo {"fecha": -1} para los más recientes primero.
Return ID	Incluye el identificador de MongoDB de cada documento. Activado por defecto.

Resultado

La salida Data trae los documentos encontrados, el número contado o el resultado del cambio.

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

Ejemplo

Una tienda online quiere marcar como enviados los pedidos que ya tienen número de seguimiento.

1. Añade Document con la credencial MongoDB Connection, la base tienda y la colección pedidos.
2. Elige Update.
3. En Filter escribe {"numero": "A-1043"} y en Update Data {"$set": {"estado": "enviado"}}.

Buenas prácticas

• Prueba el filtro con Find antes de usarlo con Update o Delete, y desactiva Multiple Documents si solo quieres tocar uno.

Componentes relacionados

• Search Index: gestiona los índices de búsqueda de una colección.
• MongoDB Vector Store: búsqueda por significado en MongoDB Atlas.