Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina ti guida nell'installazione delle librerie client di Vertex AI per Google Distributed Cloud (GDC) air-gapped, che ti consentono di interagire con vari servizi Vertex AI dal tuo ambiente di sviluppo e applicazione. Puoi scoprire i tipi di librerie client disponibili per le API Vertex AI e i passaggi per installarle dal file tar.
Questa pagina è dedicata agli sviluppatori di applicazioni all'interno dei gruppi di operatori di applicazioni responsabili della configurazione degli ambienti di sviluppo e delle applicazioni per abilitare le funzionalità di AI. Per saperne di più, consulta la documentazione relativa ai segmenti di pubblico per GDC air-gapped.
Ogni servizio Vertex AI fornisce un'API. Sebbene tu possa interagire direttamente con queste API tramite richieste server non elaborate, le librerie client semplificano l'accesso programmatico dai linguaggi supportati su Distributed Cloud. Riduce il codice necessario, soprattutto quando si lavora in ambienti come un blocco note JupyterLab.
Puoi installare una libreria client di Vertex AI utilizzando questi metodi:
Estrai il file della libreria direttamente dal file tar.
Utilizza un notebook JupyterLab per importare la libreria.
Importa una libreria client da un notebook. Per informazioni, vedi Gestire i blocchi note.
Librerie client Vertex AI
Vertex AI offre diverse versioni delle librerie client per i sistemi operativi CentOS e Ubuntu.
Le convenzioni di denominazione delle librerie client Vertex AI nel file tar
si basano sul sistema operativo, sul nome del servizio e sulla versione. I nomi dei file rispettano il seguente formato:
OS-google-cloud-SERVICE-VERSION.tar.gz
Sostituisci quanto segue:
OS: il nome del sistema operativo in cui vuoi
installare la libreria client. I valori consentiti sono centos e ubuntu.
SERVICE: il nome del servizio Vertex AI da cui vuoi scaricare la libreria client. Di seguito sono riportati
i valori consentiti:
aiplatform: la libreria client Vertex AI Platform.
speech: la libreria client Speech-to-Text.
translate: la libreria client Vertex AI Translation.
vision: la libreria client OCR.
VERSION: il numero di versione della libreria client, ad esempio 3.8.0.
La tabella seguente contiene le librerie client Vertex AI supportate da Distributed Cloud:
Sostituisci FOLDER_NAME con il percorso della directory locale in cui hai scaricato il file della libreria.
Importa la libreria client utilizzando uno script Python. L'esempio seguente mostra
uno snippet di codice di uno script Python che importa la libreria client Vertex AI Translation
per illustrare l'aspetto dell'importazione delle librerie:
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 UTC."],[[["\u003cp\u003eGoogle Distributed Cloud (GDC) air-gapped offers Vertex AI services like OCR, Vertex AI Translation, and Speech-to-Text, each with its own API accessible through client libraries.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries are the recommended method for accessing Vertex AI APIs programmatically, simplifying the process compared to making raw server requests.\u003c/p\u003e\n"],["\u003cp\u003eVertex AI client libraries are available for both CentOS and Ubuntu operating systems, with filenames formatted as \u003ccode\u003eOS-google-cloud-SERVICE-VERSION.tar.gz\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eInstalling a client library involves downloading the tar file from the GDC URL, extracting it, and then using \u003ccode\u003epip\u003c/code\u003e to install it in Distributed Cloud.\u003c/p\u003e\n"],["\u003cp\u003eBefore downloading the tar file, it is mandatory that the user set up a project for Vertex AI, authenticate with gdcloud CLI and assign the \u003ccode\u003ecloud-ai-viewer\u003c/code\u003e role to a service account.\u003c/p\u003e\n"]]],[],null,["# Install Vertex AI client libraries\n\nThis page guides you through installing Vertex AI client libraries for Google Distributed Cloud (GDC) air-gapped, which let you interact with various Vertex AI services from your application and development environment. You can learn about the types of client libraries available for Vertex AI APIs and the steps for installing them from the tar file.\n\n\u003cbr /\u003e\n\nThis page is for application developers within application operator groups responsible for setting up their application and development environments to enable AI features. For more information, see [Audiences for GDC air-gapped documentation](/distributed-cloud/hosted/docs/latest/gdch/resources/audiences).\n\nEach Vertex AI service provides an API. While you can interact directly with these APIs through raw server requests, client libraries simplify programmatic access from supported languages on Distributed Cloud. They reduce the necessary code required, especially when working in environments like a JupyterLab notebook.\n\nYou can install a Vertex AI client library using these methods:\n\n- Extract the library file directly from the tar file.\n- Use a JupyterLab notebook to import the library.\n- Import a client library from a notebook. For information, see [Manage notebooks](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-workbench).\n\nVertex AI client libraries\n--------------------------\n\nVertex AI offers different versions of client libraries for\nCentOS and Ubuntu operating systems.\n\nThe naming conventions of Vertex AI client libraries in the tar\nfile are based on the operating system, the service name, and the version. The\nfilenames adhere to the following format: \n\n \u003cvar translate=\"no\"\u003eOS\u003c/var\u003e-google-cloud-\u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e-\u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e.tar.gz\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eOS\u003c/var\u003e: the name of the operating system where you want to install the client library. Allowed values are `centos` and `ubuntu`.\n- \u003cvar translate=\"no\"\u003eSERVICE\u003c/var\u003e: the name of the Vertex AI\n service from which you want to download the client library. The following are\n the allowed values:\n\n - `aiplatform`: the Vertex AI Platform client library.\n - `speech`: the Speech-to-Text client library.\n - `translate`: the Vertex AI Translation client library.\n - `vision`: the OCR client library.\n- \u003cvar translate=\"no\"\u003eVERSION\u003c/var\u003e: the version number of the client library,\n such as `3.8.0`.\n\nThe following table contains the Vertex AI client libraries that\nDistributed Cloud supports:\n\n| **Important:** You must install the Vertex AI Platform client library to use Generative AI models like Text Embedding and Text Embedding Multilingual.\n\nBefore you begin\n----------------\n\nBefore downloading the tar file and extracting client libraries, follow these\nsteps:\n\n1. [Set up a project for Vertex AI](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-set-up-project).\n\n2. Authenticate with gdcloud CLI:\n\n gdcloud auth login\n\n For more information about how to authenticate with your configured identity\n provider, see [the gdcloud CLI authentication](/distributed-cloud/hosted/docs/latest/gdch/resources/gdcloud-auth).\n3. Verify that you have installed Python version 3.7.\n\nInstall a client library\n------------------------\n\nAfter completing the [prerequisites](#before-you-begin), follow these steps to\ndownload the tar file, and use the tar file to install a client library:\n\n1. Download the client library you want to install:\n\n wget https://\u003cvar translate=\"no\"\u003eGDC_URL\u003c/var\u003e/.well-known/static/client-libraries/\u003cvar translate=\"no\"\u003eCLIENT_LIBRARY\u003c/var\u003e\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eGDC_URL\u003c/var\u003e: the URL of your organization in GDC.\n - \u003cvar translate=\"no\"\u003eCLIENT_LIBRARY\u003c/var\u003e: the filename of the [client library](#clientlib) you want to download.\n2. Extract the library file:\n\n tar -zxf \u003cvar translate=\"no\"\u003eCLIENT_LIBRARY\u003c/var\u003e\n\n3. Install the client library in Distributed Cloud:\n\n pip install -r \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eFOLDER_NAME\u003c/span\u003e\u003c/var\u003e/requirements.txt --no-index --find-links \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eFOLDER_NAME\u003c/span\u003e\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003eFOLDER_NAME\u003c/var\u003e with the path to the local\n directory where you downloaded the library file.\n4. Import the client library using a Python script. The following example shows\n a code snippet of a Python script that imports the Vertex AI Translation\n client library to illustrate what importing libraries looks like:\n\n from google.cloud import https://cloud.google.com/python/docs/reference/translate/latest/google.cloud.translate_v2.client.Client.html\n translate_client = https://cloud.google.com/python/docs/reference/translate/latest/google.cloud.translate_v2.client.Client.html.https://cloud.google.com/python/docs/reference/translate/latest/google.cloud.translate_v2.client.Client.html(\n client_options={\"\u003cvar translate=\"no\"\u003eAPI_ENDPOINT\u003c/var\u003e\": \"https://foo-translation.googleapis.com\"})\n result\n = translate_client.https://cloud.google.com/python/docs/reference/translate/latest/google.cloud.translate_v2.client.Client.html(text, target_language=\"ru\")\n\n [...]\n\n | **Note:** This code sample is not complete. To make a Vertex AI Translation request, [learn about translation features](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/vertex-ai-translation) or [translate text](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/quickstart-translation).\n5. Save the Python script with a name, such as `translation-service.py`.\n\n6. Run the Python script:\n\n python \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eSCRIPT_NAME\u003c/span\u003e\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003eSCRIPT_NAME\u003c/var\u003e with the name you gave to your\n Python script, such as `translation-service.py`."]]
