Gemini File Search Store
Gemini File Search Store guarda tus documentos en un almacén de búsqueda de Google Gemini y te permite hacerle preguntas. Gemini se encarga de preparar los documentos para la búsqueda; tú solo subes los archivos y preguntas. Cada respuesta indica de qué documentos sale.
Un mismo componente hace todas las tareas sobre los almacenes: crearlos, subir documentos, buscar, listarlos, consultar su estado y borrarlos. Eliges la tarea en Operation y el componente muestra solo los campos que necesita.
También puede ser una herramienta de un agente: conecta su salida Tool al conector Tools del agente y el agente hará la operación elegida cuando la necesite, por ejemplo buscar en tus documentos para responder.
Cuándo usarlo
- Quieres un asistente que responda preguntas sobre tus manuales, contratos o políticas internas citando el documento.
- Tienes muchos PDF y necesitas encontrar en ellos respuestas concretas sin leerlos.
- Quieres mantener una base de conocimiento que se actualiza subiendo documentos nuevos desde un flujo.
- Ya trabajas con Google Gemini y prefieres que tus documentos estén en tu propia cuenta.
Configuración
Necesitas una credencial Google Gemini con la clave de tu cuenta de Google AI Studio. Consulta Credenciales.
| Campo | Qué hace |
|---|---|
| Google API Key (obligatorio) | La clave de tu cuenta de Google Gemini. |
| Operation | La tarea que hace el componente: Create Store (crear un almacén), Upload Document (subir documentos), Search (buscar), List Stores (listar los almacenes), Delete Store (borrar un almacén) o Get Store Info (ver el estado de un almacén). Por defecto, Create Store. |
| Store Display Name | Solo en Create Store. El nombre del almacén nuevo, por ejemplo Manuales de producto. Por defecto, My Knowledge Base. |
| Select Store | En todas las operaciones salvo Create Store y List Stores. El almacén sobre el que trabajas. La lista muestra los almacenes de tu cuenta de Google. |
| Documents | Solo en Upload Document. Los archivos o textos que quieres subir. Puedes conectar uno o varios. |
| Search Query | Solo en Search. La pregunta que quieres responder con tus documentos. |
| Metadata Filter | Solo en Search. Un filtro opcional para buscar solo en parte de los documentos, por ejemplo author="Ana" AND year>2023. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Max Tokens Per Chunk | Solo en Upload Document. Tamaño de los trozos en que se divide cada documento para la búsqueda. Trozos pequeños dan respuestas más precisas; trozos grandes conservan más contexto. Por defecto, 255. |
| Max Overlap Tokens | Solo en Upload Document. Cuánto texto comparten dos trozos seguidos, para no cortar ideas por la mitad. Por defecto, 100. |
| Model Name | El modelo de Gemini que redacta la respuesta en Search. La lista muestra los modelos de tu cuenta. |
| Show Citations | Solo en Search. Si está activado, la respuesta incluye los fragmentos de los documentos de donde sale. Activado por defecto. |
| Top K Results | Solo en Search. Cuántos fragmentos se consultan como máximo para responder. Por defecto, 7. |
| Operation Timeout (seconds) | Tiempo máximo que se espera a que Google termine una operación, como la subida de documentos. Por defecto, 300. |
Uso como herramienta
| Campo | Qué hace |
|---|---|
| Tool Name | El nombre con el que el agente ve la herramienta. Cambia automáticamente según la operación elegida, por ejemplo store_search para Search. |
| Tool Description | Lo que el agente lee para saber cuándo usar la herramienta. También se rellena según la operación. |
| Tool response mode | Cómo entrega el resultado al agente. Deja Standard. |
Resultado
- Data: el resultado de la operación. En Search, la respuesta y, si Show Citations está activado, la lista de citas con el nombre del documento y el fragmento usado. En List Stores y Get Store Info, el nombre de cada almacén, cuántos documentos tiene activos, pendientes o con error, su tamaño y su fecha de creación. En el resto, un mensaje que confirma lo que se ha hecho.
- Tool: la operación lista para un agente. Conéctala al conector Tools del agente.
Ejemplo
Una empresa de electrodomésticos quiere que su equipo de soporte consulte los manuales técnicos.
- Crea un flujo con Gemini File Search Store en Create Store y Store Display Name
Manuales técnicos. Ejecútalo una vez. - En otro flujo, usa Upload Document, elige
Manuales técnicosen Select Store y conecta los PDF de los manuales a Documents. - En el flujo del asistente, añade otro Gemini File Search Store en Search, con el mismo almacén, y conecta su salida Tool al conector Tools del agente.
- Cuando un técnico pregunta cómo reiniciar un modelo de lavadora, el agente busca en los manuales y responde indicando de qué manual sale.
Buenas prácticas
- Usa un componente para cada operación: uno para subir documentos y otro para buscar.
- Después de subir documentos, comprueba con Get Store Info que no quedan documentos pendientes o con error.
- Delete Store borra el almacén con todos sus documentos y no se puede deshacer.
Componentes relacionados
- Gemini Built-in tools: búsqueda en Google y otras herramientas de Gemini.
- Retriever Tool: convierte una búsqueda en tus propios datos en una herramienta para un agente.