Google Vertex AI 자격 증명
n8n v2.42요약
Google Vertex AI 자격 증명을 사용하면 서비스 계정, 프로젝트, 리전으로 n8n을 Vertex AI에 연결할 수 있습니다. 이 자격 증명은 다음 노드와 함께 사용할 수 있습니다. 이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
Google Vertex AI 자격 증명을 사용하면 서비스 계정, 프로젝트, 리전으로 n8n을 Vertex AI에 연결할 수 있습니다.
이 자격 증명은 다음 노드와 함께 사용할 수 있습니다.
이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.
필수 조건#
- Google Cloud 계정.
- 결제와 Vertex AI API(
aiplatform.googleapis.com)가 활성화된 Google Cloud 프로젝트. Google의 프로젝트 설정 가이드를 참고하세요. - 해당 프로젝트에서 Vertex AI에 접근할 수 있는 서비스 계정. 서비스 계정에
roles/aiplatform.user역할 또는 필요한 Vertex 권한이 포함된 사용자 지정 역할을 부여하세요. Google의 접근 제어 문서를 참고하세요. - 서비스 계정의 JSON 키. 조직에서 서비스 계정 키를 허용해야 합니다. 서비스 계정 키 만들기를 참고하세요.
서비스 계정은 다른 프로젝트에 속해 있어도 됩니다. 자격 증명에서 선택하는 프로젝트에 해당 서비스 계정의 Vertex AI 권한을 부여하세요.
지원되는 인증 방법#
- 서비스 계정 이메일 및 프라이빗 키.
관련 리소스#
서비스에 대한 자세한 내용은 Google의 Vertex AI 문서를 참고하세요.
서비스 계정 사용하기#
n8n에서 Google Vertex AI 자격 증명을 만듭니다. 서비스 계정의 JSON 키 파일을 열고 다음 필드를 채웁니다.
| 필드 | 값 |
|---|---|
| Region | 사용하려는 모델을 지원하는 위치입니다. 기본값은 Global (multi-region) - global입니다. Google의 모델 위치를 참고하세요. |
| Service Account Email | JSON 키 파일의 client_email 값입니다. |
| Private Key | JSON 키 파일의 private_key 전체 값이며 BEGIN PRIVATE KEY와 END PRIVATE KEY 줄을 포함합니다. 값을 둘러싼 JSON 따옴표는 제외합니다. |
| Project | 목록에 표시된 프로젝트를 선택하거나, Custom을 선택하여 프로젝트 ID를 입력합니다. 기본값은 Custom입니다. 목록을 불러오기 전에 이메일과 프라이빗 키를 입력하세요. |
| Project ID | my-project-id와 같은 Google Cloud 프로젝트 ID입니다. 이 필드는 Project가 Custom일 때 표시됩니다. 표시 이름이나 프로젝트 번호가 아닌 프로젝트 ID를 사용하세요. |
Save를 선택하여 자격 증명을 저장합니다.
프로젝트 선택#
프로젝트 목록은 개인 Google 계정이 아닌 서비스 계정의 접근 권한을 기준으로 합니다. Google은 서비스 계정에 resourcemanager.projects.get 권한이 있는 프로젝트를 반환합니다. Google의 프로젝트 검색 문서를 참고하세요.
프로젝트 목록이 비어 있거나 불러오지 못하면 Custom을 선택하고 Project ID를 입력하세요. 프로젝트 조회는 선택 사항입니다. 서비스 계정은 선택한 프로젝트에서 여전히 Vertex AI 접근 권한이 필요합니다.
목록에 프로젝트가 표시된다고 해서 Vertex 모델에 접근할 수 있다는 의미는 아닙니다. 프로젝트에서 활성화된 API, 권한, 모델 사용 가능 여부는 여전히 적용됩니다.
워크플로에서 자격 증명 사용#
- Google Vertex Chat Model 또는 Embeddings Google Vertex 노드를 엽니다.
- Authentication을 Google Vertex AI로 설정합니다.
- Google Vertex AI 자격 증명을 선택합니다.
- 프로젝트와 리전에서 사용할 수 있는 모델을 선택합니다.
이 인증 방법에서 노드는 자격 증명에서 프로젝트를 읽어옵니다. 자격 증명은 기본 리전도 제공합니다. 노드의 Region 설정이 자격 증명의 리전을 재정의할 수 있습니다.
기존 워크플로는 계속 Google Service Account 인증을 사용할 수 있습니다. 이 방법에서는 프로젝트가 노드에 유지됩니다. 해당 설정은 Google Service Account 자격 증명을 참고하세요.
자주 발생하는 문제#
프로젝트 조회 실패#
Google이 Cloud Resource Manager API가 비활성화되었다고 알리면, 오류에 명시된 프로젝트에서 해당 API를 활성화하세요. 선택하려는 프로젝트에서 서비스 계정에 resourcemanager.projects.get 권한이 있는지 확인하세요. 조회 권한 문제를 해결하는 동안에는 Custom 프로젝트 입력을 사용할 수 있습니다.
Vertex가 권한 오류를 반환함#
자격 증명에서 선택한 프로젝트에서 서비스 계정의 역할을 확인하세요. 서비스 계정 자체 프로젝트의 역할은 다른 프로젝트에 대한 접근 권한을 부여하지 않습니다. 또한 선택한 프로젝트에서 결제와 Vertex AI API를 활성화하세요.
모델을 사용할 수 없음#
모델이 자격 증명의 Region 또는 노드의 Region 재정의를 지원하는지 확인하세요. 지원되는 엔드포인트는 Google의 모델 위치를 참고하세요. 프로젝트 조회는 모델 사용 가능 여부를 확인하지 않습니다.