step
pinecone
Execute Pinecone vector database operations.
Overview
Execute Pinecone vector database operations.
Supports operations: - upsert: Insert or update vectors - query: Find similar vectors - delete: Delete vectors by ID - fetch: Retrieve vectors by ID - update: Update vector metadata or values
Setup: 1. Create a Pinecone account at https://www.pinecone.io/ 2. Create a project and index in the Pinecone console 3. Get your API key from the API Keys section 4. Note your environment (e.g., us-west1-gcp) from the console 5. Store credentials securely (e.g., environment variables: PINECONE_API_KEY, PINECONE_ENVIRONMENT)
API Key: Required. Get from Pinecone console > API Keys
Configuration
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | No | Step type identifier
Default: "pinecone" |
api_key | string | Yes | Pinecone API key for authentication |
environment | string | Yes | Pinecone environment/region identifier (e.g., us-west1-gcp, us-east-1-aws) |
index_name | string | Yes | Name of the Pinecone index to operate on |
operation | string | Yes | Operation to perform: upsert (insert/update vectors), query (similarity search), delete (remove vectors), fetch (get by ID), or update (modify metadata)
Options: upsert, query, delete, fetch, update |
vectors | string | No | List of vector objects to upsert, each with id, values (array of floats), and optional metadata |
vector_ids | string | No | List of vector IDs for delete or fetch operations |
query_vector | string | No | Query vector values for similarity search (required for query operation) |
top_k | integer | No | Number of most similar results to return (for query operation)
Default: 10 |
filter | string | No | Metadata filter to apply to query results (Pinecone filter syntax) |
include_metadata | boolean | No | Whether to include metadata in query/fetch results
Default: true |
include_values | boolean | No | Whether to include vector values in query/fetch results
Default: false |
namespace | string | No | Namespace to use for operations (for data isolation within an index) |
timeout | integer | No | HTTP request timeout in seconds
Default: 30 |
output_to | string | No | Key name where results will be stored in the event
Default: "pinecone" |
Base Configuration
These configuration options are available on all steps:
| Parameter | Type | Default | Description |
|---|---|---|---|
name | | null | Optional name for this step (for documentation and debugging) |
description | | null | Optional description of what this step does |
retries | integer | 0 | Number of retry attempts (0-10) |
backoff_seconds | number | 0 | Backoff (seconds) applied between retry attempts |
retry_propagate | boolean | false | If True, raise last exception after exhausting retries; otherwise swallow. |