Actions3
- Vector Actions
Overview
The node provides functionality to list vector files from a specified vector store. It is useful in scenarios where users want to retrieve metadata or details about stored vector data, such as embeddings or indexed documents, managed within a vector database or service. For example, this node can be used to fetch all available vector files for further processing, analysis, or querying in workflows involving AI-powered search or recommendation systems.
Properties
| Name | Meaning |
|---|---|
| Vector Store | Select the vector store from which to list vector files. You can choose from a list of existing vector stores or specify an ID directly. |
| Simplify Output | Whether to return a simplified version of the response instead of the raw detailed data. When enabled, the output will be easier to consume but less verbose. |
| Options | Additional optional settings: • Base URL: Override the default API base URL (default is https://api.openai.com/v1).• Max Retries: Maximum number of retry attempts for requests. • Timeout: Max request duration in milliseconds. • Preserve Original Tools: Whether to keep the assistant's original tools after execution (default true). |
Output
The node outputs JSON data representing the list of vector files retrieved from the selected vector store. The structure typically includes metadata about each vector file, such as identifiers, names, creation dates, and possibly size or status information. If "Simplify Output" is enabled, the output is a condensed version focusing on key attributes for easier consumption.
No binary data output is indicated for this operation.
Dependencies
- Requires access to a vector store service configured in n8n.
- Needs an API authentication token or key to communicate with the vector store backend.
- Optional configuration of API base URL, retries, and timeout can be set via node properties.
Troubleshooting
Common Issues:
- Invalid or missing vector store ID may cause failure to retrieve files.
- Network timeouts or API rate limits could interrupt the listing process.
- Insufficient permissions or expired API keys might result in authorization errors.
Error Messages:
- "Vector store not found": Verify the vector store selection or ID.
- "Request timed out": Increase the timeout setting or check network connectivity.
- "Unauthorized" or "Access denied": Ensure valid API credentials are configured.
Links and References
- OpenAI Playground — For managing assistants related to vector stores.
- Documentation for the vector store service API (not provided here, but typically linked in node documentation).