Asset Library Search
Tool name: eagle_search
Filter across multiple dimensions within an already-indexed asset library. This is the tool you'll reach for most often when browsing your own collection day to day.
When to Use It
- Digging through your own collection for a specific kind of asset
- Filtering precisely by tag combinations, such as "weapon AND 4 stars"
- Viewing the full metadata of a single asset (via item_id)
How to Use It
Through Agent Conversation
- "Search for images tagged 'weapon'"
- "Find all illustrations rated 4 stars or higher"
- "Show me the PNGs in the 'character reference' folder"
- "Give me the full details of this image" (pass item_id to return a single metadata record directly)
The Agent automatically combines multiple parameters for precise filtering. For example, if you say "find JPGs rated 4 stars or higher tagged mecha," it will pass star=4, tags=["mecha"], and ext="jpg" all at once.
Manually Through the Toolbox
The toolbox has an "Asset Library Search" entry where you can manually set keyword, tags, star rating, and other conditions before running the search.
How It Works
Nephele searches by reading the asset library's metadata.json and .library/ filesystem directly, without relying on any external software's API. As long as you've configured a library path, you can search, and results come back in real time.
提示
Nephele's relationship with Eagle is filesystem-level compatibility, not a runtime dependency. Nephele's operation and asset management do not depend on Eagle at all. See Eagle Compatibility and Independence for details.
Search Parameters
| Parameter | Type | Description |
|---|---|---|
| keyword | String | Searches text in titles, tags, and notes |
| ext | String | Extension filter, e.g. png, jpg, psd |
| tags | String array | Tag filter; an asset must contain all specified tags |
| star | Integer (1-5) | Minimum rating threshold |
| folders | String array | Folder ID filter |
| limit | Integer | Maximum number of results, default 20 |
| item_id | String | When passed, no search is performed; returns a single complete metadata record directly |
Reading the Results
Each returned asset includes the following information:
| Field | Description |
|---|---|
| id | Asset item ID |
| name | File name |
| ext | Extension |
| star | Rating (1-5) |
| tags | Tag list (truncated beyond 5) |
| tag_count | Total number of tags |
| importedAt | Import time; results are sorted by it in descending order by default (most recent first) |
| filePath | Local original-image path |
When you pass item_id to look up a single asset, the returned fields are the most complete, additionally including dimensions (width / height), file size, notes, color palette, thumbnail path, the name of the folder it lives in, and other full metadata.
提示
Filtering by tags and star rating requires the asset library to have completed Library Indexing. If it hasn't been indexed yet, these filter conditions will return no results.
Limitations and Notes
- Tag and star-rating search depends on the index. If you've added many files to the library but haven't re-indexed, search results will lag behind.
- The
item_idmode is for querying a single asset's full information; it performs no filtering and returns the most complete set of fields.