AACFlow

Pinecone

Use Pinecone vector database

Usage Instructions

Integrate Pinecone into the workflow. Can generate embeddings, upsert text, search with text, fetch vectors, and search with vectors.

Tools

pinecone_generate_embeddings

Generate embeddings from text using Pinecone

Input

ParameterTypeRequiredDescription
modelstringYesNo description
inputsarrayYesNo description
apiKeystringYesNo description

Output

ParameterTypeDescription
dataarrayGenerated embeddings data with values and vector type
modelstringModel used for generating embeddings
vector_typestringType of vector generated (dense/sparse)
usageobjectUsage statistics for embeddings generation

pinecone_upsert_text

Input

ParameterTypeRequiredDescription
indexHoststringYesFull Pinecone index host URL (e.g., "https://my-index-abc123.svc.pinecone.io"\)
namespacestringYesNamespace to upsert records into (e.g., "documents", "embeddings")
recordsarrayYesRecord or array of records to upsert, each containing _id, text, and optional metadata
apiKeystringYesNo description

Output

ParameterTypeDescription
statusTextstringStatus of the upsert operation

pinecone_search_text

Input

ParameterTypeRequiredDescription
indexHoststringYesFull Pinecone index host URL (e.g., "https://my-index-abc123.svc.pinecone.io"\)
namespacestringNoNamespace to search in (e.g., "documents", "embeddings")
searchQuerystringYesNo description
topKstringNoNumber of results to return (e.g., "10", "25")
fieldsarrayNoNo description
filterobjectNoFilter to apply to the search (e.g., {"category": "tech", "year": {"$gte": 2020}})
rerankobjectNoNo description
apiKeystringYesNo description

Output

ParameterTypeDescription
matchesarraySearch results with ID, score, and metadata
idstringVector ID
scorenumberSimilarity score
metadataobjectAssociated metadata
usageobjectUsage statistics including tokens, read units, and rerank units
total_tokensnumberTotal tokens used for embedding
read_unitsnumberRead units consumed
rerank_unitsnumberRerank units used

pinecone_search_vector

Input

ParameterTypeRequiredDescription
indexHoststringYesFull Pinecone index host URL (e.g., "https://my-index-abc123.svc.pinecone.io"\)
namespacestringNoNamespace to search in (e.g., "documents", "embeddings")
vectorarrayYesNo description
topKnumberNoNo description
filterobjectNoFilter to apply to the search (e.g., {"category": "tech", "year": {"$gte": 2020}})
includeValuesbooleanNoNo description
includeMetadatabooleanNoNo description
apiKeystringYesNo description

Output

ParameterTypeDescription
matchesarrayVector search results with ID, score, values, and metadata
namespacestringNamespace where the search was performed

pinecone_fetch

Input

ParameterTypeRequiredDescription
indexHoststringYesFull Pinecone index host URL (e.g., "https://my-index-abc123.svc.pinecone.io"\)
idsarrayYesArray of vector IDs to fetch (e.g., ["vec-001", "vec-002"])
namespacestringNoNamespace to fetch vectors from (e.g., "documents", "embeddings")
apiKeystringYesNo description

Output

ParameterTypeDescription
matchesarrayFetched vectors with ID, values, metadata, and score
idstringVector ID
valuesarrayVector values
metadataobjectAssociated metadata
scorenumberMatch score (1.0 for exact matches)
dataarrayVector data with values and vector type
valuesarrayVector values
vector_typestringVector type (dense/sparse)
usageobjectUsage statistics including total read units
total_tokensnumberRead units consumed

On this page

Start building today
Trusted by over 100,000 builders.
The SaaS platform to build AI agents and run your agentic workforce.
Get started