Skip to content
Nappai Documentation

Gemini File Search Store

Gemini File Search Store keeps your documents in a Google Gemini search store and lets you ask questions about them. Gemini prepares the documents for searching; you only upload the files and ask. Each answer says which documents it comes from.

One component handles every task on stores: creating them, uploading documents, searching, listing them, checking their status and deleting them. You pick the task in Operation and the component shows only the fields it needs.

It can also be a tool for an agent: connect its Tool output to the agent’s Tools input and the agent will run the chosen operation when it needs to, for example searching your documents to answer.

When to use it

  • You want an assistant that answers questions about your manuals, contracts or internal policies, citing the document.
  • You have many PDFs and need specific answers from them without reading them.
  • You want to keep a knowledge base up to date by uploading new documents from a flow.
  • You already work with Google Gemini and prefer your documents to stay in your own account.

Configuration

You need a Google Gemini credential with your Google AI Studio key. See Credentials.

FieldWhat it does
Google API Key (required)Your Google Gemini account key.
OperationThe task the component performs: Create Store, Upload Document, Search, List Stores, Delete Store or Get Store Info. Default: Create Store.
Store Display NameOnly for Create Store. The new store’s name, for example Product manuals. Default: My Knowledge Base.
Select StoreFor every operation except Create Store and List Stores. The store you work on. The list shows the stores in your Google account.
DocumentsOnly for Upload Document. The files or texts you want to upload. You can connect one or several.
Search QueryOnly for Search. The question you want your documents to answer.
Metadata FilterOnly for Search. An optional filter to search only part of the documents, for example author="Ana" AND year>2023.

Advanced options

FieldWhat it does
Max Tokens Per ChunkOnly for Upload Document. The size of the pieces each document is split into for searching. Small pieces give more precise answers; large ones keep more context. Default: 255.
Max Overlap TokensOnly for Upload Document. How much text two consecutive pieces share, so ideas aren’t cut in half. Default: 100.
Model NameThe Gemini model that writes the answer in Search. The list shows the models in your account.
Show CitationsOnly for Search. When on, the answer includes the document passages it comes from. On by default.
Top K ResultsOnly for Search. The maximum number of passages consulted to answer. Default: 7.
Operation Timeout (seconds)The maximum time to wait for Google to finish an operation, such as uploading documents. Default: 300.

Use as a tool

FieldWhat it does
Tool NameThe name the agent sees for the tool. It changes automatically with the chosen operation, for example store_search for Search.
Tool DescriptionWhat the agent reads to know when to use the tool. It is also filled in according to the operation.
Tool response modeHow the result is handed to the agent. Leave Standard.

Output

  • Data: the operation’s result. For Search, the answer and, when Show Citations is on, the list of citations with the document name and the passage used. For List Stores and Get Store Info, each store’s name, how many documents are active, pending or failed, its size and creation date. For the rest, a message confirming what was done.
  • Tool: the operation ready for an agent. Connect it to the agent’s Tools input.

Example

A home appliance company wants its support team to look things up in the technical manuals.

  1. Create a flow with Gemini File Search Store set to Create Store and Store Display Name Technical manuals. Run it once.
  2. In another flow, use Upload Document, choose Technical manuals in Select Store and connect the manual PDFs to Documents.
  3. In the assistant’s flow, add another Gemini File Search Store set to Search with the same store, and connect its Tool output to the agent’s Tools input.
  4. When a technician asks how to reset a washing machine model, the agent searches the manuals and answers, saying which manual the answer comes from.

Good practices

  • Use one component per operation: one to upload documents and another to search.
  • After uploading documents, check with Get Store Info that none are pending or failed.
  • Delete Store deletes the store with all its documents and can’t be undone.