Skip to main content
Server path: /pinecone | Type: Application | PCID required: Yes

Tools

ToolDescription
pinecone_configure_indexConfigure an index
pinecone_create_backupCreate a backup of an index
pinecone_create_collectionCreate a collection
pinecone_create_indexCreate an index
pinecone_create_index_for_modelCreate an index with integrated embedding
pinecone_create_index_from_backup_operationCreate an index from a backup
pinecone_delete_backupDelete a backup
pinecone_delete_collectionDelete a collection
pinecone_delete_indexDelete an index
pinecone_describe_backupDescribe a backup
pinecone_describe_collectionDescribe a collection
pinecone_describe_indexDescribe an index
pinecone_describe_restore_jobDescribe a restore job
pinecone_embedGenerate vectors
pinecone_get_modelDescribe a model
pinecone_list_collectionsList collections
pinecone_list_index_backupsList backups for an index
pinecone_list_indexesList indexes
pinecone_list_modelsList available models
pinecone_list_project_backupsList backups for all indexes in a project
pinecone_list_restore_jobsList restore jobs
pinecone_rerankRerank results

pinecone_configure_index

Configure an index Parameters:
ParameterTypeRequiredDefaultDescription
index_namestringYesThe name of the index to configure.
deletion_protectionstringNoWhether deletion protection is enabled/disabled for the index. Possible values: disabled or enabled.
embedobjectNoConfigure the integrated inference embedding settings for this index. You can convert an existing index to an integrated index by specifying the embedding model and field_map. The index vector type and dimension must match the model vector type and dimension, and the index similarity metric must be supported by the model. Refer to the model guide for available models and model details. You can later change the embedding configuration to update the field map, read parameters, or write parameters. Once set, the model cannot be changed.
specobjectNoThe spec object defines how the index should be deployed. Only some attributes of an index’s spec may be updated. In general, you can modify settings related to scaling and configuration but you cannot change the cloud or region where the index is hosted.
tagsobjectNoCustom user tags added to an index. Keys must be 80 characters or less. Values must be 120 characters or less. Keys must be alphanumeric, '', or ’-’. Values must be alphanumeric, ’;’, ’@’, '', ’-’, ’.’, ’+’, or ’ ’. To unset a key, set the value to be an empty string.

pinecone_create_backup

Create a backup of an index Parameters:
ParameterTypeRequiredDefaultDescription
index_namestringYesName of the index to backup
descriptionstringNoA description of the backup.
namestringNoThe name of the backup.

pinecone_create_collection

Create a collection Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesThe name of the collection to be created. Resource name must be 1-45 characters long, start and end with an alphanumeric character, and consist only of lower case alphanumeric characters or ’-’.
sourcestringYesThe name of the index to be used as the source for the collection.

pinecone_create_index

Create an index Parameters:
ParameterTypeRequiredDefaultDescription
deletion_protectionstringNoWhether deletion protection is enabled/disabled for the index. Possible values: disabled or enabled.
dimensionintegerNoThe dimensions of the vectors to be inserted in the index.
metricstringNoThe distance metric to be used for similarity search. You can use ‘euclidean’, ‘cosine’, or ‘dotproduct’. If the ‘vector_type’ is ‘sparse’, the metric must be ‘dotproduct’. If the vector_type is dense, the metric defaults to ‘cosine’. Possible values: cosine, euclidean, or dotproduct.
namestringYesThe name of the index. Resource name must be 1-45 characters long, start and end with an alphanumeric character, and consist only of lower case alphanumeric characters or ’-’.
specobjectYesThe spec object defines how the index should be deployed. For serverless indexes, you define only the cloud and region where the index should be hosted. For pod-based indexes, you define the environment where the index should be hosted, the pod type and size to use, and other index characteristics.
tagsobjectNoCustom user tags added to an index. Keys must be 80 characters or less. Values must be 120 characters or less. Keys must be alphanumeric, '', or ’-’. Values must be alphanumeric, ’;’, ’@’, '', ’-’, ’.’, ’+’, or ’ ’. To unset a key, set the value to be an empty string.
vector_typestringNoThe index vector type. You can use ‘dense’ or ‘sparse’. If ‘dense’, the vector dimension must be specified. If ‘sparse’, the vector dimension should not be specified.

pinecone_create_index_for_model

Create an index with integrated embedding Parameters:
ParameterTypeRequiredDefaultDescription
cloudstringYesThe public cloud where you would like your index hosted. Possible values: gcp, aws, or azure.
deletion_protectionstringNoWhether deletion protection is enabled/disabled for the index. Possible values: disabled or enabled.
embedobjectYesSpecify the integrated inference embedding configuration for the index. Once set the model cannot be changed, but you can later update the embedding configuration for an integrated inference index including field map, read parameters, or write parameters. Refer to the model guide for available models and model details.
namestringYesThe name of the index. Resource name must be 1-45 characters long, start and end with an alphanumeric character, and consist only of lower case alphanumeric characters or ’-’.
read_capacityobjectNoBy default the index will be created with read capacity mode OnDemand. If you prefer to allocate dedicated read nodes for your workload, you must specify mode Dedicated and additional configurations for node_type and scaling.
regionstringYesThe region where you would like your index to be created.
schemaobjectNoSchema for the behavior of Pinecone’s internal metadata index. By default, all metadata is indexed; when schema is present, only fields which are present in the fields object with a filterable: true are indexed. Note that filterable: false is not currently supported.
tagsobjectNoCustom user tags added to an index. Keys must be 80 characters or less. Values must be 120 characters or less. Keys must be alphanumeric, '', or ’-’. Values must be alphanumeric, ’;’, ’@’, '', ’-’, ’.’, ’+’, or ’ ’. To unset a key, set the value to be an empty string.

pinecone_create_index_from_backup_operation

Create an index from a backup Parameters:
ParameterTypeRequiredDefaultDescription
backup_idstringYesThe ID of the backup to create an index from.
deletion_protectionstringNoWhether deletion protection is enabled/disabled for the index. Possible values: disabled or enabled.
namestringYesThe name of the index. Resource name must be 1-45 characters long, start and end with an alphanumeric character, and consist only of lower case alphanumeric characters or ’-’.
tagsobjectNoCustom user tags added to an index. Keys must be 80 characters or less. Values must be 120 characters or less. Keys must be alphanumeric, '', or ’-’. Values must be alphanumeric, ’;’, ’@’, '', ’-’, ’.’, ’+’, or ’ ’. To unset a key, set the value to be an empty string.

pinecone_delete_backup

Delete a backup Parameters:
ParameterTypeRequiredDefaultDescription
backup_idstringYesThe ID of the backup to delete.

pinecone_delete_collection

Delete a collection Parameters:
ParameterTypeRequiredDefaultDescription
collection_namestringYesThe name of the collection.

pinecone_delete_index

Delete an index Parameters:
ParameterTypeRequiredDefaultDescription
index_namestringYesThe name of the index to delete.

pinecone_describe_backup

Describe a backup Parameters:
ParameterTypeRequiredDefaultDescription
backup_idstringYesThe ID of the backup to describe.

pinecone_describe_collection

Describe a collection Parameters:
ParameterTypeRequiredDefaultDescription
collection_namestringYesThe name of the collection to be described.

pinecone_describe_index

Describe an index Parameters:
ParameterTypeRequiredDefaultDescription
index_namestringYesThe name of the index to be described.

pinecone_describe_restore_job

Describe a restore job Parameters:
ParameterTypeRequiredDefaultDescription
job_idstringYesThe ID of the restore job to describe.

pinecone_embed

Generate vectors Parameters:
ParameterTypeRequiredDefaultDescription
inputsobject[]YesList of inputs to generate embeddings for.
modelstringYesThe model to use for embedding generation.
parametersobjectNoAdditional model-specific parameters. Refer to the model guide for available model parameters.

pinecone_get_model

Describe a model Parameters:
ParameterTypeRequiredDefaultDescription
model_namestringYesThe name of the model to look up.

pinecone_list_collections

List collections

pinecone_list_index_backups

List backups for an index Parameters:
ParameterTypeRequiredDefaultDescription
index_namestringYesName of the backed up index
limitintegerNoThe number of results to return per page.
paginationTokenstringNoThe token to use to retrieve the next page of results.

pinecone_list_indexes

List indexes

pinecone_list_models

List available models Parameters:
ParameterTypeRequiredDefaultDescription
typestringNoFilter models by type (‘embed’ or ‘rerank’).
vector_typestringNoFilter embedding models by vector type (‘dense’ or ‘sparse’). Only relevant when type=embed.

pinecone_list_project_backups

List backups for all indexes in a project Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoThe number of results to return per page.
paginationTokenstringNoThe token to use to retrieve the next page of results.

pinecone_list_restore_jobs

List restore jobs Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoThe number of results to return per page.
paginationTokenstringNoThe token to use to retrieve the next page of results.

pinecone_rerank

Rerank results Parameters:
ParameterTypeRequiredDefaultDescription
documentsobject[]YesThe documents to rerank.
modelstringYesThe model to use for reranking.
parametersobjectNoAdditional model-specific parameters. Refer to the model guide for available model parameters.
querystringYesThe query to rerank documents against.
rank_fieldsstring[]NoThe field(s) to consider for reranking. If not provided, the default is ["text"]. The number of fields supported is model-specific.
return_documentsbooleanNoWhether to return the documents in the response.
top_nintegerNoThe number of results to return sorted by relevance. Defaults to the number of inputs.