92 lines
2.1 KiB
Markdown
92 lines
2.1 KiB
Markdown
# Google Gemini File Search CLI Scripts
|
|
|
|
This directory contains CLI tools for managing Google Gemini File Search stores and documents.
|
|
|
|
## Available Scripts
|
|
|
|
### ✅ create-store.ts
|
|
Create a new file search store.
|
|
|
|
**Usage:**
|
|
```bash
|
|
ts-node create-store.ts --name "My Knowledge Base" --project "customer-support" --environment "production"
|
|
```
|
|
|
|
**Status:** Complete
|
|
|
|
### 🚧 upload-batch.ts (TO BE IMPLEMENTED)
|
|
Batch upload documents to a file search store with progress tracking.
|
|
|
|
**Planned Features:**
|
|
- Concurrent uploads with configurable batch size
|
|
- Progress bar with ETA
|
|
- Automatic chunking configuration per file type
|
|
- Metadata extraction from file path/name
|
|
- Cost estimation before upload
|
|
- Operation polling until indexing complete
|
|
|
|
**Usage:**
|
|
```bash
|
|
ts-node upload-batch.ts --store "fileSearchStores/abc123" --directory "./docs" --concurrent 5
|
|
```
|
|
|
|
### 🚧 query-store.ts (TO BE IMPLEMENTED)
|
|
Interactive query tool with citation display.
|
|
|
|
**Planned Features:**
|
|
- Interactive REPL for queries
|
|
- Citation rendering with source links
|
|
- Metadata filtering options
|
|
- Model selection (Flash vs Pro)
|
|
- Export query results
|
|
|
|
**Usage:**
|
|
```bash
|
|
ts-node query-store.ts --store "fileSearchStores/abc123"
|
|
```
|
|
|
|
### 🚧 cleanup.ts (TO BE IMPLEMENTED)
|
|
Delete stores and documents (with safety prompts).
|
|
|
|
**Planned Features:**
|
|
- List all stores with document counts
|
|
- Delete specific store or all stores
|
|
- Force delete confirmation prompts
|
|
- Dry-run mode
|
|
|
|
**Usage:**
|
|
```bash
|
|
ts-node cleanup.ts --store "fileSearchStores/abc123" --force
|
|
ts-node cleanup.ts --all --dry-run
|
|
```
|
|
|
|
## Prerequisites
|
|
|
|
```bash
|
|
# Install dependencies
|
|
npm install @google/genai
|
|
|
|
# Set API key
|
|
export GOOGLE_API_KEY="your-api-key-here"
|
|
```
|
|
|
|
## Development Status
|
|
|
|
**Completed:** 1/4 scripts (25%)
|
|
|
|
**Next Steps:**
|
|
1. Implement upload-batch.ts
|
|
2. Implement query-store.ts
|
|
3. Implement cleanup.ts
|
|
4. Add package.json with dependencies and scripts
|
|
5. Test all scripts end-to-end
|
|
|
|
## Notes
|
|
|
|
These scripts demonstrate best practices from SKILL.md:
|
|
- Operation polling until done: true
|
|
- Storage quota calculation (3x multiplier)
|
|
- Recommended chunking configurations
|
|
- Metadata schema patterns
|
|
- Force delete for non-empty stores
|