Gemini API를 사용하면 자체 데이터에 대한 시맨틱 검색을 수행할 수 있습니다. Kubernetes는 데이터에 액세스하는 경우 API 키보다 더 엄격한 액세스 제어가 필요합니다.
이 빠른 시작에서는 적합한 간소화된 인증 방식을 사용합니다. 테스트 환경용입니다 프로덕션 환경의 경우 정보 인증 및 승인 이전 액세스 사용자 인증 정보 선택 선택할 수 있습니다.
목표
- OAuth용 클라우드 프로젝트 설정
- application-default-credentials 설정
gcloud auth
를 사용하는 대신 프로그램에서 사용자 인증 정보 관리
기본 요건
이 빠른 시작을 실행하려면 다음이 필요합니다.
클라우드 프로젝트 설정
이 빠른 시작을 완료하려면 먼저 Cloud 프로젝트를 설정해야 합니다.
1. API 사용 설정
Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 사용 설정해야 합니다.
Google Cloud 콘솔에서 Google Generative Language API를 사용 설정합니다.
2. OAuth 동의 화면 구성
다음으로 프로젝트의 OAuth 동의 화면을 구성하고 본인을 테스트로 추가합니다. 있습니다. Cloud 프로젝트에서 이 단계를 이미 완료한 경우 다음 섹션에서 설명하겠습니다.
Google Cloud 콘솔에서 메뉴 > API 및 서비스 > OAuth 동의 화면을 선택합니다.
<ph type="x-smartling-placeholder"></ph> OAuth 동의 화면으로 이동
앱의 사용자 유형을 외부로 선택한 다음 만들기를 클릭합니다.
앱 등록 양식을 작성합니다 (대부분의 입력란은 비워도 됩니다). 저장하고 계속하기를 클릭합니다.
지금은 범위 추가를 건너뛰고 저장 후 계속을 클릭할 수 있습니다. 향후 Google Workspace 외부에서 사용할 앱을 만드는 경우 인증 범위를 추가하여 있습니다.
테스트 사용자 추가:
- 테스트 사용자에서 사용자 추가를 클릭합니다.
- 이메일 주소 및 기타 승인된 테스트 사용자를 입력한 다음 저장하고 계속하기를 클릭합니다.
앱 등록 요약을 검토합니다. 변경하려면 수정을 클릭합니다. 만약 앱 등록이 정상적으로 표시되면 대시보드로 돌아가기를 클릭합니다.
3. 데스크톱 애플리케이션의 사용자 인증 정보 승인
최종 사용자로 인증하고 앱에서 사용자 데이터에 액세스하려면 OAuth 2.0 클라이언트 ID를 하나 이상 만들어야 합니다. 클라이언트 ID는 Google OAuth 서버에서 단일 앱을 식별하는 데 사용됩니다. 앱이 여러 플랫폼에서 실행되는 경우 플랫폼마다 별도의 클라이언트 ID를 만들어야 합니다.
Google Cloud 콘솔에서 메뉴 > API 및 서비스 > 사용자 인증 정보.
<ph type="x-smartling-placeholder"></ph> 사용자 인증 정보로 이동
사용자 인증 정보 만들기를 클릭합니다. OAuth 클라이언트 ID.
애플리케이션 유형을 클릭합니다. 데스크톱 앱.
이름 필드에 사용자 인증 정보의 이름을 입력합니다. 이 이름은 Google Cloud 콘솔에 표시됩니다
만들기를 클릭합니다. OAuth 클라이언트 생성 화면이 표시되고 새로 생성된 클라이언트 ID 및 클라이언트 보안 비밀번호
확인을 클릭합니다. 새로 생성된 사용자 인증 정보가 OAuth 2.0 클라이언트 아래에 표시됩니다. 있습니다.
다운로드 버튼을 클릭하여 JSON 파일을 저장합니다. 다음으로 저장됩니다.
client_secret_<identifier>.json
, 이름을client_secret.json
로 바꿉니다. 작업 디렉터리로 이동합니다
애플리케이션 기본 사용자 인증 정보 설정
client_secret.json
파일을 사용 가능한 사용자 인증 정보로 변환하려면 다음을 전달합니다.
gcloud auth application-default login
명령어의
--client-id-file
인수입니다.
gcloud auth application-default login \
--client-id-file=client_secret.json \
--scopes='https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/generative-language.retriever'
이 가이드에서는 간소화된 프로젝트 설정으로 'Google은 아직 확인했습니다.'라는 대화상자가 표시됩니다. 이는 정상적인 현상입니다. '계속'을 선택하세요.
이렇게 하면 결과 토큰이 잘 알려진 위치에 배치되어 액세스할 수 있습니다.
gcloud
또는 클라이언트 라이브러리를 통해 구현됩니다.
gcloud auth application-default login
--no-browser
--client-id-file=client_secret.json
--scopes='https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/generative-language.retriever'
애플리케이션 기본 사용자 인증 정보 (ACD)를 설정하고 나면 클라이언트는 거의 또는 전혀 필요하지 않은 라이브러리입니다.
Curl
제대로 작동하는지 테스트하는 가장 빠른 방법은 curl을 사용하는 API:
access_token=$(gcloud auth application-default print-access-token) project_id=<MY PROJECT ID>
curl -X GET https://generativelanguage.googleapis.com/v1/models \ -H 'Content-Type: application/json' \ -H "Authorization: Bearer ${access_token}" \ -H "x-goog-user-project: ${project_id}" | grep '"name"'
Python
Python에서는 클라이언트 라이브러리가 이를 자동으로 찾아야 합니다.
pip install google-generativeai
이를 테스트하기 위한 최소한의 스크립트는 다음과 같습니다.
import google.generativeai as genai
print('Available base models:', [m.name for m in genai.list_models()])
다음 단계
제대로 작동한다면 다음을 시도해 보세요. 텍스트 데이터의 시맨틱 검색.
사용자 인증 정보 직접 관리 [Python]
대부분의 경우 액세스 권한을 만드는 데 gcloud
명령어를 사용할 수 없습니다.
토큰 (client_secret.json
)을 가져옵니다. Google은 다양한 언어로
앱 내에서 해당 프로세스를 관리할 수 있습니다. 이 섹션
은 Python에서 프로세스를 보여줍니다. 이와 동등한 예가 있습니다.
자세한 내용은 다음 링크에서 확인할 수 있습니다.
Drive API 문서
1. 필요한 라이브러리 설치
Python용 Google 클라이언트 라이브러리와 Gemini 클라이언트 라이브러리를 설치합니다.
pip install --upgrade -q google-api-python-client google-auth-httplib2 google-auth-oauthlib
pip install google-generativeai
2. 인증 관리자 작성
승인 버튼을 클릭해야 하는 횟수를 최소화하기 위해
화면에서 작업 디렉터리에 load_creds.py
라는 파일을 만들어
나중에 재사용하거나 만료되면 새로고침할 수 있는 token.json
파일을 캐시합니다.
먼저
다음 코드를 사용하여 client_secret.json
파일을 다음으로 사용할 수 있는 토큰으로 변환합니다.
genai.configure
:
import os.path
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
SCOPES = ['https://www.googleapis.com/auth/generative-language.retriever']
def load_creds():
"""Converts `client_secret.json` to a credential object.
This function caches the generated tokens to minimize the use of the
consent screen.
"""
creds = None
# The file token.json stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
if os.path.exists('token.json'):
creds = Credentials.from_authorized_user_file('token.json', SCOPES)
# If there are no (valid) credentials available, let the user log in.
if not creds or not creds.valid:
if creds and creds.expired and creds.refresh_token:
creds.refresh(Request())
else:
flow = InstalledAppFlow.from_client_secrets_file(
'client_secret.json', SCOPES)
creds = flow.run_local_server(port=0)
# Save the credentials for the next run
with open('token.json', 'w') as token:
token.write(creds.to_json())
return creds
3. 프로그램 작성
이제 script.py
를 만듭니다.
import pprint
import google.generativeai as genai
from load_creds import load_creds
creds = load_creds()
genai.configure(credentials=creds)
print()
print('Available base models:', [m.name for m in genai.list_models()])
4. 프로그램 실행
작업 디렉터리에서 샘플을 실행합니다.
python script.py
스크립트를 처음 실행하면 브라우저 창이 열리고 액세스를 승인합니다.
아직 Google 계정에 로그인하지 않은 경우 로그인합니다. 여러 계정에 로그인한 경우 계정에서 로그인하려는 '테스트 계정'으로 설정한 계정 참고하시기 바랍니다.
승인 정보는 파일 시스템에 저장되므로 다음에 샘플 코드를 실행하면 승인하라는 메시지가 표시되지 않습니다.
인증을 설정했습니다.