1. 소개
뉴스에 관한 모든 질문에 답변할 수 있는 에이전트를 만들고 Cloud Run에 배포합니다. 이 뉴스는 '벵갈루루'라는 한 지역과 관련된 모든 주제를 다룰 수 있습니다. 다음과 같은 쿼리를 사용할 수 있습니다.
- 벵갈루루의 최신 소식을 알려줘.
- 벵갈루루 교통과 관련된 최근 소식을 알려 줘.
Cloud Run에 에이전트를 배포할 수 있습니다. 모델과 로컬 도구를 사용하는 간단한 에이전트를 만든 다음 배포합니다.
학습할 내용
- Cloud Run용 Google Cloud 프로젝트를 설정하는 방법
- Google ADK를 사용하여 간단한 AI 에이전트를 빌드하는 방법
- 에이전트 내에서 로컬 도구를 정의하고 사용하는 방법
- Docker를 사용하여 에이전트를 패키징하는 방법
- Google Cloud Run에 에이전트를 서비스로 배포하는 방법
- 웹 UI를 통해 배포된 에이전트와 상호작용하는 방법
필요한 항목
- Gmail 계정
- Chrome 브라우저
2. Google Cloud 환경 설정
Cloud 크레딧 받기
배포에 필요한 기프트 크레딧을 사용하세요. Gmail 계정을 사용해야 합니다.
프로젝트 만들기
- Google Cloud 콘솔의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.
- Cloud 프로젝트에 결제가 사용 설정되어 있어야 하므로 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.
- 이 링크를 클릭하여 Cloud Shell을 활성화합니다.
- 활성 계정을 설정하려면 Cloud Shell에서 다음 명령어를 실행합니다.
gcloud config set account <ACCOUNT>
ACCOUNT은 Google Cloud에 로그인하는 데 사용한 Gmail입니다.
- Cloud Shell에서 다음 명령어를 실행하여 인증을 확인합니다.
gcloud auth list
- 다음 명령어를 사용하여 프로젝트 ID를 확인합니다.
gcloud config list project
- 프로젝트 ID 변수를 설정합니다. <YOUR_PROJECT_ID>를 이전 단계의 ID로 바꿉니다.
export PROJECT_ID=<YOUR_PROJECT_ID> && gcloud config set project $PROJECT_ID
export REGION=europe-west1 && gcloud config set run/region $REGION
- Google API 키를 설정합니다.
https://aistudio.google.com/app/apikey를 사용하여 API 키를 생성하고 여기에 키를 붙여넣으세요.
export GOOGLE_API_KEY=PASTE_YOUR_ACTUAL_API_KEY_HERE
export GOOGLE_GENAI_USE_VERTEXAI=FALSE
- 필요한 API를 사용 설정합니다.
gcloud services enable cloudresourcemanager.googleapis.com \
servicenetworking.googleapis.com \
run.googleapis.com \
cloudbuild.googleapis.com \
artifactregistry.googleapis.com \
aiplatform.googleapis.com \
compute.googleapis.com \
storage.googleapis.com
(몇 분 정도 걸릴 수 있습니다.)
Cloud Run Day 워크숍용 코드 샘플 클론
모든 워크숍의 샘플 코드에 액세스하려면 전체 저장소를 클론하세요.
git clone https://github.com/shrutimantri/first-adk-agent5.git
3. Cloud Run에 에이전트 배포
Cloud Shell 편집기에서 모든 파일을 준비한 후 Cloud Shell 터미널에서 다음 명령어를 실행하여 서비스를 Cloud Run에 배포합니다.
gcloud run deploy news-assistant-agent \
--source . \
--region $REGION \
--project $PROJECT_ID \
--allow-unauthenticated \
--set-env-vars="GOOGLE_GENAI_USE_VERTEXAI=$GOOGLE_GENAI_USE_VERTEXAI,GOOGLE_API_KEY=$GOOGLE_API_KEY"
(메시지가 표시되면 'Y'를 입력하여 배포를 확인합니다.)
4. 에이전트 테스트
배포가 완료되면 Cloud Shell에 배포된 Cloud Run 서비스의 URL이 출력됩니다.
링크를 열면 ADK 웹 UI를 사용하여 에이전트와 직접 상호작용할 수 있습니다.
5. 삭제
향후 요금이 청구되지 않도록 생성한 Cloud Run 서비스를 삭제합니다.
gcloud run services delete news-assistant-agent --region $REGION $GOOGLE_CLOUD_LOCATION --quiet
6. 축하합니다.
AI 뉴스 에이전트를 빌드하고 Google Cloud Run에 배포했습니다.