Cloudflare Vectorize icon

Cloudflare Vectorize

Execute operations against Cloudflare Vectorize vector databases. Supports vector operations (insert, upsert, query), index management, metadata filtering, and can be used as a tool by AI Agents for semantic search and RAG applications.

Actions16

Index → Info

AI-generated

Overview

This node integrates with Cloudflare Vectorize, a vector database service designed for managing and querying vector data. It supports operations on vector indexes, vectors themselves, metadata filtering, and utility functions useful for administration and debugging.

The Info operation under the Index resource retrieves statistics and metadata about a specific vector index, such as vector count and last update time. This is useful for monitoring the status and health of your vector indexes.

Practical scenarios include:

  • Checking the current size and usage stats of a vector index before performing large insertions or queries.
  • Monitoring index metadata to optimize vector search performance.
  • Integrating index info retrieval into workflows that automate vector database maintenance.

Properties

Name Meaning
Index Name The name of the vector index to retrieve information about. Must be unique, lowercase, and contain only letters, numbers, and hyphens.

Output

The output JSON contains an info field with statistics and metadata about the specified vector index. This typically includes details like the number of vectors stored, last update timestamps, and other relevant index metadata.

Example output structure (conceptual):

{
  "info": {
    "vectorCount": 12345,
    "lastUpdate": "2024-06-01T12:34:56Z",
    "indexName": "example-index",
    "otherMetadata": { ... }
  }
}

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Cloudflare Vectorize service.
  • The node depends on the external Cloudflare Vectorize API endpoints to perform index info retrieval.
  • Proper configuration of the API credentials in n8n is necessary for successful execution.

Troubleshooting

  • Common issues:

    • Invalid or missing index name: Ensure the index name is provided, lowercase, and contains only allowed characters.
    • Authentication errors: Verify that the API key credential is correctly configured and has sufficient permissions.
    • Network or API availability issues: Check connectivity to Cloudflare Vectorize services.

  • Error messages:

    • "Unknown index operation: info": Indicates the operation parameter was not set to "info" when using the index resource.
    • "Unknown resource: index": Means the resource parameter was not set to "index".
    • API errors from Cloudflare Vectorize will be passed through; check the error message for details such as rate limits or invalid requests.

Resolving these usually involves verifying input parameters, credentials, and network access.

Links and References

Discussion