iOQnddlZddlmZmZmZmZddlmZddlZddl m Z m Z ddl m Z ddlmZmZmZmZddlmZej*eZ erRdd l mZmZdd lmZmZdd lm Z dd l!m"Z"dd l#m$Z$m%Z%ddl&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.ddl/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5m6Z6m7Z7m8Z8m9Z9m:Z:Gddee Z;deZed?d@dAedBedCeddDfdEZ eddFddGdAeedHeedIeeddJfdKZ!ed/eddDfdLZ"ed/eddfdMZ#edFddNdHeedIeeddOfdPZ$edQeddRfdSZ%e&dTZ'e&dUZ(dddededdVfdWZ)deddXfdYZ*xZ+S)ePineconez6 A client for interacting with Pinecone APIs. Napi_keyhost proxy_url proxy_headers ssl_ca_certs ssl_verifyadditional_headers pool_threadsc VdD]} | | vstd| dtddtjd |||||||d| |_ t j |jfi| |_ |dtz|_ n||_ d|_ d|_ t |5y) a The ``Pinecone`` class is the main entry point for interacting with Pinecone via this Python SDK. Instances of the ``Pinecone`` class are used to manage and interact with Pinecone resources such as indexes, backups, and collections. When using the SDK, calls are made on your behalf to the API documented at `https://docs.pinecone.io `_. The class also holds inference functionality (embed, rerank) under the ``inference`` namespace. When you are ready to perform data operations on an index, you will need to instantiate an index client. Though the functionality of the index client is defined in a different class, it is instantiated through the ``Index()`` method in order for configurations to be shared between the two objects. :param api_key: The API key to use for authentication. If not passed via kwarg, the API key will be read from the environment variable ``PINECONE_API_KEY``. :type api_key: str, optional :param host: The control plane host. If unspecified, the host ``api.pinecone.io`` will be used. :type host: str, optional :param proxy_url: The URL of the proxy to use for the connection. :type proxy_url: str, optional :param proxy_headers: Additional headers to pass to the proxy. Use this if your proxy setup requires authentication. :type proxy_headers: Dict[str, str], optional :param ssl_ca_certs: The path to the SSL CA certificate bundle to use for the connection. This path should point to a file in PEM format. When not passed, the SDK will use the certificate bundle returned from ``certifi.where()``. :type ssl_ca_certs: str, optional :param ssl_verify: SSL verification is performed by default, but can be disabled using the boolean flag when testing with Pinecone Local or troubleshooting a proxy setup. You should never run with SSL verification disabled in production. :type ssl_verify: bool, optional :param additional_headers: Additional headers to pass to the API. This is mainly to support internal testing at Pinecone. End users should not need to use this unless following specific instructions to do so. :type additional_headers: Dict[str, str], optional :param pool_threads: The number of threads to use for the ThreadPool when using methods that support the ``async_req`` keyword argument. The default number of threads is 5 * the number of CPUs in your execution environment. :type pool_threads: int, optional **Configuration with environment variables** If you instantiate the Pinecone client with no arguments, it will attempt to read the API key from the environment variable ``PINECONE_API_KEY``. .. code-block:: python from pinecone import Pinecone pc = Pinecone() **Configuration with keyword arguments** If you prefer being more explicit in your code, you can also pass the API key as a keyword argument. This is also where you will pass additional configuration options such as proxy settings if you wish to use those. .. code-block:: python import os from pinecone import Pinecone pc = Pinecone( api_key=os.environ.get("PINECONE_API_KEY"), host="https://api-staging.pinecone.io" ) **Environment variables** The Pinecone client supports the following environment variables: * ``PINECONE_API_KEY``: The API key to use for authentication. If not passed via kwarg, the API key will be read from the environment variable ``PINECONE_API_KEY``. * ``PINECONE_DEBUG_CURL``: Enable some additional debug logging representing the HTTP requests as curl commands. The main use of is to run calls outside of the SDK to help evaluate whether a problem you are experiencing is due to the API's behavior or the behavior of the SDK itself. * ``PINECONE_ADDITIONAL_HEADERS``: A json string of a dictionary of header values to attach to all requests. This is primarily used for internal testing at Pinecone. .. warning:: Be very careful with the ``PINECONE_DEBUG_CURL`` environment variable, as it will print out your API key which forms part of a required authentication header. **Proxy configuration** If your network setup requires you to interact with Pinecone via a proxy, you will need to pass additional configuration using optional keyword parameters. These optional parameters are forwarded to ``urllib3``, which is the underlying library currently used by the Pinecone client to make HTTP requests. You may find it helpful to refer to the `urllib3 documentation on working with proxies `_ while troubleshooting these settings. Here is a basic example: .. code-block:: python from pinecone import Pinecone pc = Pinecone( api_key='YOUR_API_KEY', proxy_url='https://your-proxy.com' ) pc.list_indexes() If your proxy requires authentication, you can pass those values in a header dictionary using the ``proxy_headers`` parameter. .. code-block:: python from pinecone import Pinecone import urllib3 import make_headers pc = Pinecone( api_key='YOUR_API_KEY', proxy_url='https://your-proxy.com', proxy_headers=make_headers(proxy_basic_auth='username:password') ) pc.list_indexes() **Using proxies with self-signed certificates** By default the Pinecone Python client will perform SSL certificate verification using the CA bundle maintained by Mozilla in the `certifi `_ package. If your proxy server is using a self-signed certificate, you will need to pass the path to the certificate in PEM format using the ``ssl_ca_certs`` parameter. .. code-block:: python from pinecone import Pinecone import urllib3 import make_headers pc = Pinecone( api_key='YOUR_API_KEY', proxy_url='https://your-proxy.com', proxy_headers=make_headers(proxy_basic_auth='username:password'), ssl_ca_certs='path/to/cert-bundle.pem' ) pc.list_indexes() **Disabling SSL verification** If you would like to disable SSL verification, you can pass the ``ssl_verify`` parameter with a value of ``False``. We do not recommend going to production with SSL verification disabled. .. code-block:: python from pinecone import Pinecone import urllib3 import make_headers pc = Pinecone( api_key='YOUR_API_KEY', proxy_url='https://your-proxy.com', proxy_headers=make_headers(proxy_basic_auth='username:password'), ssl_ca_certs='path/to/cert-bundle.pem', ssl_verify=False ) pc.list_indexes() >config index_apiopenapi_configzPassing z is no longer supported. Please pass individual settings such as proxy_url, proxy_headers, ssl_ca_certs, and ssl_verify directly to the Pinecone constructor as keyword arguments. See the README at READMEz for examples.)r.r/r4r0r1r2r3N)NotImplementedErrorrrbuild_configr build_openapi_config_openapi_configr _pool_threads _inference _db_controlsuper__init__) selfr.r/r0r1r2r3r4r5kwargsdeprecated_kwarg __class__s c/var/www/catia.catastroantioquia-mas.com/valormas/lib/python3.12/site-packages/pinecone/pinecone.pyrFzPinecone.__init__4s|!J  6))/01vw@AIwJvKKYZ  &++  1'%!      ,AA$,,YRXY  !"Y[D  "!-D  " c|j4ddlm}||j|j|j |_|jS)z Inference is a namespace where an instance of the `pinecone.inference.Inference` class is lazily created and cached. r) Inferencer7r9r5)rCpinecone.inferencerNr?rArB)rGrNs rK inferencezPinecone.inferencesB ?? " 4'||#33!//DO rLc|j4ddlm}||j|j|j |_|jS)z DBControl is a namespace where an instance of the `pinecone.db_control.DBControl` class is lazily created and cached. r) DBControlrO)rDpinecone.db_controlrSr?rArB)rGrSs rKdbz Pinecone.dbsG    # 5(||#33!// D  rLreturncztjdtd|jjj S):meta private:zThe `index_host_store` property is deprecated. This warning will become an error in a future version of the Pinecone Python SDK. stacklevel)warningswarnDeprecationWarningrUindex_index_host_storerGs rKindex_host_storezPinecone.index_host_stores2   O  ww}}...rLc|jS)rX)r?ras rKr7zPinecone.configs ||rLcRtjdtd|jS)rXzThe `openapi_config` property has been renamed to `_openapi_config`. It is considered private and should not be used directly. This warning will become an error in a future version of the Pinecone Python SDK.rYrZ)r\r]r^rAras rKr9zPinecone.openapi_config%s*   _  ###rLcRtjdtd|jS)rXzThe `pool_threads` property has been renamed to `_pool_threads`. It is considered private and should not be used directly. This warning will become an error in a future version of the Pinecone Python SDK.rYrZ)r\r]r^rBras rKr5zPinecone.pool_threads/s*   [  !!!rLcftjdtd|jjS)rXzyThe `index_api` property is deprecated. This warning will become an error in a future version of the Pinecone Python SDK.rYrZ)r\r]r^rU _index_apiras rKr8zPinecone.index_api9s.   H  ww!!!rLdisablednamespecr!r"r# dimensionmetricrtimeoutdeletion_protectionr vector_typertagsr$c \|jjj||||||||S)N)rirjrkrlrmrnrorp)rUr_create) rGrirjrkrlrmrnrorps rK create_indexzPinecone.create_indexCs<ww}}## 3#$  rLcloudrregionrrr embed)r'rc Z|jjj|||||||S)N)rirtrurvrprnrm)rUr_create_for_model)rGrirtrurvrprnrms rKcreate_index_for_modelzPinecone.create_index_for_modelYs9ww}}-- 3.  rL)rnrprm backup_idcV|jjj|||||S)N)rirzrnrprm)rUr_create_from_backup)rGrirzrnrprms rKcreate_index_from_backupz!Pinecone.create_index_from_backupms3ww}}// 3 0  rLcP|jjj||S)N)rirm)rUr_delete)rGrirms rK delete_indexzPinecone.delete_indexs ww}}##w#??rLcJ|jjjSN)rUr_listras rK list_indexeszPinecone.list_indexessww}}!!##rLcN|jjj|SN)ri)rUr_describerGris rKdescribe_indexzPinecone.describe_indexsww}}%%4%00rLcN|jjj|Sr)rUr_hasrs rK has_indexzPinecone.has_indexsww}}  d ++rLreplicaspod_typerrcX|jjj||||||S)N)rirrrnrprv)rUr_ configure)rGrirrrnrprvs rKconfigure_indexzPinecone.configure_indexs6ww}}&& 3 '  rLsourcecP|jjj||S)N)rir)rU collectionrr)rGrirs rKcreate_collectionzPinecone.create_collections"ww!!((d6(BBrLcJ|jjjSr)rUrrras rKlist_collectionszPinecone.list_collectionssww!!&&((rLcN|jjj|Sr)rUrrrs rKdelete_collectionzPinecone.delete_collections ww!!((d(33rLcN|jjj|Sr)rUrrrs rKdescribe_collectionzPinecone.describe_collections ww!!***55rL) description index_name backup_namerr(cR|jjj|||S)N)rrr)rUbackuprr)rGrrrs rK create_backupzPinecone.create_backups+ww~~$$!{ %  rL rlimitpagination_tokenrrr)cR|jjj|||S)Nr)rUrr)rGrrrs rK list_backupszPinecone.list_backupss,ww~~""!AQ#  rLcN|jjj|SN)rz)rUrrrGrzs rKdescribe_backupzPinecone.describe_backupsww~~&&&;;rLcN|jjj|Sr)rUrrrs rK delete_backupzPinecone.delete_backupsww~~$$y$99rLrrr+cP|jjj||S)Nr)rU restore_jobr)rGrrs rKlist_restore_jobszPinecone.list_restore_jobss%ww""''eFV'WWrLjob_idr*cN|jjj|S)N)r)rUrr)rGrs rKdescribe_restore_jobzPinecone.describe_restore_jobs ww""++6+::rLc*ttd)rX from_textsAttributeErrorrargsrHs rKrzPinecone.from_textssElSTTrLc*ttd)rXfrom_documentsrrs rKrzPinecone.from_documentssEFVWXXrLIndexc ddlm}|dk(r|dk(r td|jddxs |j}|j j }|j}|dk7rt|t|}n%|jjj|}|d|||||jjd|S)Nr)rrz%Either name or host must be specifiedr5)r/r.r5r9 source_tagr<)pinecone.db_datar ValueErrorpoprBr?r.rAcheck_realistic_hostr rUr_ _get_hostr7r) rGrir/rHrptr.r9 index_hosts rKrzPinecone.Indexs+ 2:$"*DE E ZZ - C1C1C,,&&-- 2:  &(-J006J ){{--     rL IndexAsyncioc ddlm}|jj}|j}||dk(r t dt |t|}|d||||jjd|S)Nr)rrzA host must be specified)r/r.r9rr<) rrr?r.rArrr r7r)rGr/rHrr.r9rs rKrzPinecone.IndexAsynciosz2,,&&-- <42:78 8T"#D)  ){{--     rL)rVr)rVr)rVr)rVr)NcosineNrhdenseN)NrhNr)rVr%)NNNNN)rVr&)rr),__name__ __module__ __qualname____doc__rstrrboolintrFpropertyrQrUrbr7r9r5r8rrsryrr}rrrrrrrrrrrrrrr staticmethodrrrr __classcell__)rJs@rKr-r-/s "&"#'26&*%)79&*@#@sm@C= @  S#X/ @ sm @TN@%T#s(^4@sm@D      // $$"c""""$(19!%JT:A)-  D*IzAB C=  x}-.  #  &e,@#,E&FG eL#$567 tCH~&   8*.JT!%  _c)* k; sBC  FG  tCH~&  &e,@#,E&FG #   ( KU)-!%    &e,@#,E&FG  tCH~&  #    "@@x}@$131<1,c,d, #'48JN)->B  3- 5C01  &e,@#,E&FG  tCH~&  3T9:; $CcC3C4C)4c4d466GI   /2 AD   %)!*.  SM  }  #3-      FsmX XX ;c;6G;;UUYY # #  8  > rLr-r/rVc4d|vrd|vrtd|dyy)aV:meta private: Checks whether a user-provided host string seems plausible. Someone could erroneously pass an index name as the host by mistake, and if they have done that we'd like to give them a simple error message as feedback rather than attempting to call the url and getting a more cryptic DNS resolution error. . localhostz You passed 'zk' as the host but this does not appear to be valid. Call describe_index() to confirm the host of the index.N)r)r/s rKrr s9 $;d24&!L M  3rL)>loggingtypingrrrrmultiprocessingrr\pinecone.configrr legacy_pinecone_interfacer pinecone.utilsr r rrlangchain_import_warningsr getLoggerrloggerrrrrrrr$pinecone.db_control.index_host_storer7pinecone.core.openapi.db_control.api.manage_indexes_apirpinecone.db_control.typesrrpinecone.db_control.enumsrrrrrrrr pinecone.db_control.modelsr!r"r#r$r%r&r'r(r)r*r+r-rrr<rLrKrs77%9GQQO   8 $<OCX`       X {<X v  s  t  rL