Vertex AI 클라이언트 라이브러리 설치

Google Distributed Cloud (GDC) 에어 갭 어플라이언스의 Vertex AI 클라이언트 라이브러리를 사용하면 원시 서버 요청을 작성하지 않고도 지원되는 언어에서 광학 문자 인식 (OCR), Speech-to-Text, Vertex AI Translation, Vertex AI Platform API에 프로그래매틱 방식으로 액세스할 수 있습니다. CentOS 또는 Ubuntu 운영체제의 tar 파일에서 직접 클라이언트 라이브러리를 추출하고 설치합니다.

Vertex AI 클라이언트 라이브러리

Vertex AI는 CentOS 및 Ubuntu 운영체제에 대해 다양한 버전의 클라이언트 라이브러리를 제공합니다.

tar 파일에 있는 Vertex AI 클라이언트 라이브러리의 이름 지정 규칙은 운영체제, 서비스 이름, 버전을 기반으로 합니다. 파일 이름은 다음 형식을 따릅니다.

OS-google-cloud-SERVICE-VERSION.tar.gz

다음을 바꿉니다.

  • OS: 클라이언트 라이브러리를 설치할 운영체제의 이름입니다. 허용되는 값은 centos 및 ubuntu, 입니다.

  • SERVICE: 클라이언트 라이브러리를 다운로드하려는 Vertex AI 서비스의 이름입니다. 허용되는 값은 다음과 같습니다.

    • aiplatform: Vertex AI Platform 클라이언트 라이브러리입니다.
    • speech: Speech-to-Text 클라이언트 라이브러리
    • translate: Vertex AI Translation 클라이언트 라이브러리
    • vision: OCR 클라이언트 라이브러리

  • VERSION: 클라이언트 라이브러리의 버전 번호입니다(예: 3.8.0).

다음 표에는 GDC 에어 갭 어플라이언스에서 지원하는 Vertex AI 클라이언트 라이브러리가 나와 있습니다.

Vertex AI 서비스 운영체제 파일 이름
OCR Centos centos-google-cloud-vision-3.0.0.tar.gz
Ubuntu ubuntu-google-cloud-vision-3.0.0.tar.gz
Speech-to-Text Centos centos-google-cloud-speech-2.15.0.tar.gz
Ubuntu ubuntu-google-cloud-speech-2.15.0.tar.gz
Vertex AI Translation Centos centos-google-cloud-translate-3.8.0.tar.gz
Ubuntu ubuntu-google-cloud-translate-3.8.0.tar.gz
Vertex AI Platform Centos centos-google-cloud-aiplatform-1.34.0.tar.gz
Ubuntu ubuntu-google-cloud-aiplatform-1.34.0.tar.gz

시작하기 전에

tar 파일을 다운로드하고 클라이언트 라이브러리를 추출하기 전에 다음 단계를 따르세요.

  1. Vertex AI용 프로젝트를 설정합니다.

  2. gdcloud CLI로 인증합니다.

    gdcloud auth login

    구성된 ID 공급업체로 인증하는 방법에 대한 자세한 내용은 gdcloud CLI 인증을 참조하세요.

  3. 서비스 계정에 Cloud AI 뷰어 (cloud-ai-viewer) 역할을 할당합니다. 서비스 계정에서 Vertex AI 서비스에 액세스하려면 이 역할이 필요합니다.

  4. Python 버전 3.7이 설치되어 있는지 확인합니다.

클라이언트 라이브러리 설치

기본 요건을 완료한 후 다음 단계에 따라 tar 파일을 다운로드하고 tar 파일을 사용하여 클라이언트 라이브러리를 설치합니다.

  1. 설치하려는 클라이언트 라이브러리를 다운로드합니다.

    wget https://GDC_URL/.well-known/static/client-libraries/CLIENT_LIBRARY

    다음을 바꿉니다.

  2. 라이브러리 파일의 압축을 풉니다.

    tar -zxf CLIENT_LIBRARY

  3. GDC 에어 갭 어플라이언스에 클라이언트 라이브러리를 설치합니다.

    pip install -r FOLDER_NAME/requirements.txt --no-index --find-links FOLDER_NAME

    FOLDER_NAME를 라이브러리 파일을 다운로드한 로컬 디렉터리의 경로로 바꿉니다.

  4. Python 스크립트를 사용하여 클라이언트 라이브러리를 가져옵니다. 다음 예시에서는 Vertex AI Translation 클라이언트 라이브러리를 가져오는 Python 스크립트의 코드 스니펫을 보여주며, 라이브러리를 가져오는 방법을 보여줍니다.

    from google.cloud import translate
translate_client = translate.Client(
 client_options={"API_ENDPOINT": "https://foo-translation.googleapis.com"})
result
= translate_client.translate(text, target_language="ru")

[...]

    이 코드 샘플은 완전하지 않습니다. Vertex AI Translation 요청을 하려면 번역 기능에 대해 알아보기를 참조하세요.

  5. Python 스크립트를 translation-service.py과 같은 이름으로 저장합니다.

  6. Python 스크립트를 실행합니다.

    python SCRIPT_NAME

    SCRIPT_NAME을 Python 스크립트에 지정한 이름(예: translation-service.py)으로 바꿉니다.