NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Pinecone

pinecone

Long-term Memory for AI. The Pinecone vector database makes it easy to build high-performance vector search applications. Developer-friendly, fully managed, and easily scalable without infrastructure hassles.

Artificial IntelligenceDatabasesWeb del proveedor
Acciones
30
Triggers
0
Autenticación
—
OAuth gestionado
No
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (30)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Cancel Bulk ImportPINECONE_CANCEL_BULK_IMPORTAcción

Tool to cancel a bulk import operation in Pinecone. Use when you need to stop an ongoing import operation that is not yet finished.

Parámetros de entrada

  • idstringObligatorio

    Unique identifier of the import operation to cancel

  • index_hoststringObligatorio

    The host URL of the index where the bulk import is running. Get this from the list indexes API or Pinecone console (e.g., 'your-index-epf46k1.svc.aped-4627-b74a.pinecone.io')

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Configure IndexPINECONE_CONFIGURE_INDEXAcción

Tool to configure an existing Pinecone index, including pod type, replicas, deletion protection, and tags. Use when you need to scale an index vertically or horizontally, enable/disable deletion protection, or update tags. The change is asynchronous; check index status for completion.

Parámetros de entrada

  • specany

    The desired pod size and replica configuration for the index. For serverless indexes, configure read capacity mode.

  • tagsany

    Updates custom tags as key-value pairs. Set value to empty string to delete a tag. Keys max 80 chars, values max 120 chars.

  • index_namestringObligatorio

    The name of the index to configure.

  • api_versionstring

    Required date-based version header for the Pinecone API.

  • deletion_protectionany

    Sets deletion protection for the index. Use 'enabled' to prevent accidental deletion or 'disabled' to allow deletion.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create BackupPINECONE_CREATE_BACKUPAcción

Tool to create a backup of a Pinecone index for disaster recovery and version control. Use when you need to preserve the current state of an index including vectors, metadata, and configuration.

Parámetros de entrada

  • nameany

    User-defined identifier for the backup.

  • index_namestringObligatorio

    Name of the index to backup.

  • descriptionany

    Contextual information about the backup purpose.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create IndexPINECONE_CREATE_INDEXAcción

Tool to create a Pinecone index with specified configuration. Use when you need to initialize a new vector database index for storing and querying embeddings.

Parámetros de entrada

  • namestringObligatorio

    Index identifier (1-45 chars, lowercase alphanumeric or hyphens, must start/end with alphanumeric).

  • specobjectObligatorio

    Deployment configuration. Must provide either serverless or pod specification.

  • metricstringObligatorioenum

    Similarity measure. Must be 'dotproduct' for sparse vectors.

    cosineeuclideandotproduct
  • dimensionany

    Vector dimensions (1-20,000). Required for dense vectors; omit for sparse vectors.

  • vector_typeany

    Vector type: 'dense' (default) or 'sparse'.

  • deletion_protectionany

    Set to 'enabled' to prevent accidental deletion.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Index with Embedding ModelPINECONE_CREATE_INDEX_FOR_MODELAcción

Tool to create a Pinecone index with integrated embedding model for automatic vectorization. Use when you need to set up a new index that automatically converts text to vectors using a pre-configured embedding model.

Parámetros de entrada

  • namestringObligatorio

    Index identifier. Must be 1-45 characters, alphanumeric and hyphens only, must start and end with alphanumeric character.

  • tagsany

    Custom metadata labels. Keys max 80 characters, values max 120 characters.

  • cloudstringObligatorioenum

    Cloud provider for hosting the index.

    gcpawsazure
  • embedobjectObligatorio

    Embedding model configuration for automatic vectorization.

  • regionstringObligatorio

    Deployment region. Must be valid for the chosen cloud provider (e.g., 'us-east-1' for AWS).

  • deletion_protectionany

    Protection against accidental deletion. Defaults to 'disabled' if not specified.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create Index from BackupPINECONE_CREATE_INDEX_FROM_BACKUPAcción

Tool to create an index from a backup. Use when you need to restore or duplicate index data from a previously saved backup.

Parámetros de entrada

  • namestringObligatorio

    Index name, 1-45 characters, alphanumeric lowercase or hyphens only.

  • tagsany

    Custom key-value pairs for organization.

  • backup_idstringObligatorio

    The ID of the backup to create an index from.

  • deletion_protectionany

    Enable or disable deletion safeguards.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create NamespacePINECONE_CREATE_NAMESPACEAcción

Tool to create a namespace within a serverless Pinecone index. Use when you need to organize vectors into isolated partitions.

Parámetros de entrada

  • namestringObligatorio

    The name of the namespace to create.

  • schemaany

    Optional schema configuration for metadata indexing behavior. Defines which fields are filterable.

  • index_hoststringObligatorio

    The host URL of the serverless index (e.g., 'index-name-xxxxx.svc.aped-xxxx-xxxx.pinecone.io').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete IndexPINECONE_DELETE_INDEXAcción

Tool to permanently delete a Pinecone index. Use when you need to remove an index from your project. Note: Deletion protection and pending collections can prevent deletion.

Parámetros de entrada

  • index_namestringObligatorio

    The name of the index to delete. Example: 'test-index'

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete NamespacePINECONE_DELETE_NAMESPACEAcción

Tool to permanently delete a namespace from a serverless index. Use when you need to remove an entire namespace and all its data. This operation is irreversible and only supported on serverless indexes.

Parámetros de entrada

  • namespacestringObligatorio

    The namespace identifier to be deleted. This operation is irreversible and will destroy all vectors in the namespace.

  • index_hoststringObligatorio

    The host URL of the serverless index containing the namespace. Can be obtained from the list indexes operation.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Describe BackupPINECONE_DESCRIBE_BACKUPAcción

Tool to retrieve detailed information about a specific backup. Use when you need to check backup status, configuration, or metadata.

Parámetros de entrada

  • backup_idstringObligatorio

    The unique identifier of the backup to retrieve

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Describe Bulk ImportPINECONE_DESCRIBE_BULK_IMPORTAcción

Tool to describe a specific bulk import operation in Pinecone. Use when you need to retrieve detailed information about an import's status, progress, timing, and any errors.

Parámetros de entrada

  • idstringObligatorio

    Unique identifier for the import operation to describe.

  • index_hoststringObligatorio

    The host URL of the Pinecone index where the bulk import is being performed. This is the data plane URL (e.g., 'my-index-abc123.svc.us-east1-gcp.pinecone.io').

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Describe Index StatsPINECONE_DESCRIBE_INDEX_STATSAcción

Tool to get index statistics including vector count per namespace, dimensions, and fullness. Use when you need to understand the contents and status of an index.

Parámetros de entrada

  • filterany

    Metadata filter to return statistics only for vectors matching the filter. Note: Not supported on serverless indexes.

  • index_hoststringObligatorio

    The host URL of the index to get stats for (e.g., 'index-name-xxx.svc.region.pinecone.io'). Get this from the list_indexes response.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Describe Restore JobPINECONE_DESCRIBE_RESTORE_JOBAcción

Tool to get detailed information about a specific restore job in Pinecone. Use when you need to check the status, progress, or metadata of a restore operation.

Parámetros de entrada

  • job_idstringObligatorio

    The ID of the restore job to describe.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Generate EmbeddingsPINECONE_EMBEDAcción

Tool to generate vector embeddings for input text using Pinecone's hosted embedding models. Use when you need to convert text into vector representations for semantic search or similarity matching.

Parámetros de entrada

  • modelstringObligatorio

    The embedding model to use (e.g., 'multilingual-e5-large').

  • inputsobject[]Obligatorio

    List of input objects to generate embeddings for. Each item contains a text field.

  • parametersany

    Additional model-specific parameters like input_type and truncate.

Parámetros de salida

  • dataarrayObligatorio

    Array of embedding objects (dense or sparse).

  • errorany

    Error if any occurred during the execution of the action

  • modelstringObligatorio

    The model used to generate embeddings.

  • usageobjectObligatorio

    Usage statistics including total tokens processed.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Model InformationPINECONE_GET_MODELAcción

Tool to retrieve detailed information about a specific model hosted by Pinecone. Use when you need to understand model capabilities for embedding and reranking operations.

Parámetros de entrada

  • model_namestringObligatorio

    The name of the model to look up.

  • api_versionstring

    Required date-based version header for the Pinecone API.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Bulk ImportsPINECONE_LIST_BULK_IMPORTSAcción

Tool to list all recent and ongoing bulk import operations in Pinecone. Use when you need to monitor or track the status of data import jobs. Supports pagination with a default limit of 100 imports per page.

Parámetros de entrada

  • limitany

    Max number of operations to return per page. Range: 1-100, default: 100

  • index_hoststringObligatorio

    The host URL of the index to list bulk imports for (e.g., 'index-name-abc123.svc.region.pinecone.io'). Get the host using the List Indexes action.

  • paginationTokenany

    Pagination token to continue a previous listing operation

Parámetros de salida

  • dataobject[]Obligatorio

    Collection of import operation objects

  • errorany

    Error if any occurred during the execution of the action

  • paginationany

    Pagination information

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List CollectionsPINECONE_LIST_COLLECTIONSAcción

Tool to list all collections in a Pinecone project (pod-based indexes only). Use when you need to view available collections.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Index BackupsPINECONE_LIST_INDEX_BACKUPSAcción

Tool to list all backups for a specific Pinecone index. Use when you need to view available backups for an index. Supports pagination via limit and paginationToken parameters.

Parámetros de entrada

  • limitany

    The number of results to return per page. Must be between 1 and 100.

  • index_namestringObligatorio

    Name of the backed up index.

  • paginationTokenany

    The token to use to retrieve the next page of results.

Parámetros de salida

  • dataobject[]Obligatorio

    List of backup objects for the specified index.

  • errorany

    Error if any occurred during the execution of the action

  • paginationany

    Pagination information for navigating results.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List IndexesPINECONE_LIST_INDEXESAcción

Tool to list all indexes in a Pinecone project. Use when you need to retrieve all indexes with their configurations and status information.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Available ModelsPINECONE_LIST_MODELSAcción

Tool to list all available embedding and reranking models hosted by Pinecone. Use when you need to discover available models or filter by model type (embed/rerank) or vector type (dense/sparse).

Parámetros de entrada

  • typeany

    Filter models by type. Use 'embed' for embedding models or 'rerank' for reranking models.

  • vector_typeany

    Filter embedding models by vector type. Only relevant when type='embed'. Use 'dense' for dense vectors or 'sparse' for sparse vectors.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List NamespacesPINECONE_LIST_NAMESPACES_OPERATIONAcción

Tool to list all namespaces in a serverless Pinecone index. Use when you need to discover available namespaces for data organization. Returns up to 100 namespaces by default with pagination support.

Parámetros de entrada

  • limitany

    Maximum number of namespaces to return per page.

  • prefixany

    Prefix filter to return only namespaces that start with this prefix.

  • index_hoststringObligatorio

    The host URL of the index to list namespaces from. You can get this from the list indexes API.

  • api_versionstring

    Required date-based version header for the Pinecone API.

  • pagination_tokenany

    Token for continuing a previous listing operation.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Project BackupsPINECONE_LIST_PROJECT_BACKUPSAcción

Tool to list all backups for indexes in a Pinecone project. Use when you need to retrieve backup information across all project indexes. Supports pagination with limit and paginationToken parameters.

Parámetros de entrada

  • limitany

    Number of results per page. Must be between 1 and 100. Default: 10.

  • paginationTokenany

    Token for retrieving subsequent result pages. Obtained from the previous response.

Parámetros de salida

  • dataobject[]Obligatorio

    List of backup objects.

  • errorany

    Error if any occurred during the execution of the action

  • paginationany

    Pagination information.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Restore JobsPINECONE_LIST_RESTORE_JOBSAcción

Tool to list all restore jobs for a project with pagination support. Use when you need to view the status of restore operations or track restore progress.

Parámetros de entrada

  • limitany

    Number of results to return per page. Range: 1-100, Default: 10.

  • paginationTokenany

    Token for retrieving the next page of results.

Parámetros de salida

  • dataobject[]Obligatorio

    Array of RestoreJobModel objects.

  • errorany

    Error if any occurred during the execution of the action

  • paginationany

    Pagination information for the result set.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List VectorsPINECONE_LIST_VECTORSAcción

Tool to list vector IDs in a Pinecone serverless index. Use when you need to browse or retrieve vector identifiers from a namespace. Supports filtering by prefix and pagination for large result sets.

Parámetros de entrada

  • limitany

    Maximum number of vector IDs to return per page. Default is 100.

  • prefixany

    Filter vector IDs by prefix. Does not accept values containing spaces.

  • namespaceany

    The namespace to list vectors from. If not provided, the default namespace is used.

  • index_hoststringObligatorio

    The host URL of the Pinecone index to list vectors from. Get this from ListIndexes action.

  • paginationTokenany

    Pagination token to continue a previous listing operation.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Query VectorsPINECONE_QUERY_VECTORSAcción

Tool to perform semantic search within a Pinecone index using a query vector. Retrieves IDs and similarity scores of the most similar items, ordered from most to least similar. Either vector or id parameter must be provided.

Parámetros de entrada

  • idany

    Vector ID to use as query. Maximum length is 512 characters. Required if vector is not provided.

  • topKintegerObligatorio

    Number of results to return per query. Must be between 1 and 10,000.

  • filterany

    Metadata filtering criteria to constrain results. Example: {"genre": {"$in": ["comedy", "documentary"]}, "year": {"$eq": 2019}}

  • vectorany

    Query vector values matching index dimensionality. Length must be between 1 and 20,000. Required if id is not provided.

  • indexHoststringObligatorio

    The host URL of the Pinecone index to query. Get this from the list indexes operation.

  • namespaceany

    The namespace to search. If omitted, searches the default namespace.

  • sparseVectorany

    Sparse vector representation for hybrid search.

  • includeValuesany

    Whether to include vector data in the response. Default is false.

  • includeMetadataany

    Whether to include metadata in the response. Default is false.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Rerank DocumentsPINECONE_RERANKAcción

Tool to rerank documents by semantic relevance to a query. Use when you need to order retrieved documents by their semantic relevance to a user's search query using Pinecone's hosted reranking models.

Parámetros de entrada

  • modelstringObligatorio

    The reranking model to apply (e.g., 'bge-reranker-v2-m3').

  • querystringObligatorio

    The search query against which documents are ranked.

  • top_nany

    Number of ranked results to return. Defaults to the total number of input documents if not specified.

  • documentsobject[]Obligatorio

    Array of document objects requiring reranking.

  • parametersany

    Additional model-specific options. Refer to model documentation for supported parameters.

  • rank_fieldsany

    Fields to consider for reranking. Defaults to ['text']. Model-specific limits may apply.

  • return_documentsany

    Include documents in response. Defaults to true.

Parámetros de salida

  • dataobject[]Obligatorio

    Array of reranked documents ordered by relevance score.

  • errorany

    Error if any occurred during the execution of the action

  • modelstringObligatorio

    The reranking model used.

  • usageobjectObligatorio

    Usage information for the rerank operation.

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Search Records in NamespacePINECONE_SEARCH_RECORDS_NAMESPACEAcción

Tool to search records within a Pinecone namespace using text, vector, or ID query. Use when you need to find similar records based on embeddings or record IDs. Results can optionally be reranked for relevance.

Parámetros de entrada

  • queryobjectObligatorio

    Query configuration including top_k and optional filters, vector, or ID

  • fieldsany

    Fields to include in results

  • rerankany

    Optional reranking configuration

  • namespacestringObligatorio

    The namespace to search within

  • index_hoststringObligatorio

    The host URL for the Pinecone index (e.g., 'my-index-abc123.svc.pinecone.io'). Get this from listing indexes.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Start Bulk ImportPINECONE_START_BULK_IMPORTAcción

Tool to start an asynchronous bulk import of vectors from object storage (S3, GCS, or Azure Blob Storage) into a Pinecone index. Use when you need to import large volumes of vectors from external storage. Returns an import ID to track the operation status.

Parámetros de entrada

  • uristringObligatorio

    The URI of the bucket/container and import directory containing data. Format: s3://BUCKET_NAME/IMPORT_DIR, gs://BUCKET_NAME/IMPORT_DIR, or Azure Blob Storage path.

  • errorModeany

    Error handling configuration for the import operation.

  • index_hoststringObligatorio

    The host URL of the Pinecone index to import into. Get this from the index details (e.g., 'my-index-abc123.svc.aped-4627-b74a.pinecone.io'). Use List Indexes to find available index hosts.

  • integrationIdany

    The identifier of the storage integration used to access the data.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update VectorPINECONE_UPDATE_VECTORAcción

Tool to update a vector in Pinecone by ID. Use to overwrite vector values and/or metadata. Supports bulk updates via metadata filters.

Parámetros de entrada

  • idstringObligatorio

    Vector's unique identifier. Length: 1-512 characters.

  • dryRunany

    If true, return the number of records matching the filter without executing the update. Default: false.

  • filterany

    Metadata filter expression for bulk updates. Example: {"genre": {"$in": ["comedy", "documentary"]}, "year": {"$eq": 2019}}

  • valuesany

    Vector data to update. Length: 1-20,000 elements. If provided, overwrites previous values.

  • namespaceany

    The namespace containing the vector to update. If not specified, uses the default namespace.

  • index_hoststringObligatorio

    The host URL of the index to update vectors in. Get this from the list_indexes response (e.g., 'my-index-abc123.svc.region.pinecone.io').

  • setMetadataany

    Metadata to set for the vector. Key-value pairs that will be added or overwrite previous metadata.

  • sparseValuesany

    Sparse vector representation to update.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Upsert Records to NamespacePINECONE_UPSERT_RECORDS_NAMESPACEAcción

Tool to upsert text records into a Pinecone namespace. Use when you need to add or update records with automatic text-to-vector conversion.

Parámetros de entrada

  • recordsobject[]Obligatorio

    List of records to upsert. Each record must have an '_id' field and can contain arbitrary additional fields like 'chunk_text' for text to be converted to vectors.

  • namespacestringObligatorio

    The namespace to upsert records into.

  • index_hoststringObligatorio

    The host URL of the index to upsert records into. Get this from ListIndexes action (e.g., 'test-embed-idx-99999-epf46k1.svc.aped-4627-b74a.pinecone.io').

  • api_versionstring

    Pinecone API version header.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorany

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not