1. 시작하기 전에
이 자기 주도형 Codelab에서는 Google Cloud의 Vertex AI Agent Builder를 사용하여 AI 에이전트를 빌드하는 방법을 안내합니다. 각 단계에서는 특정 상담사 생성기 기능을 강조 표시하고 그 목적을 설명합니다.
기본 요건
- Google Cloud의 생성형 AI에 관한 기본적인 이해
- AI 상담사 개념에 관한 기본 이해
학습할 내용
- Vertex AI Agent Builder를 사용하여 간단한 AI 에이전트를 만드는 방법
- 데이터 스토어를 연결하여 생성된 에이전트를 접지하는 방법
필요한 항목
- 호기심 많은 마음
- 작동하는 컴퓨터와 안정적인 Wi-Fi
- 결제가 연결된 Google Cloud 프로젝트
2. 첫 번째 AI 에이전트 설계
이제 나만의 AI 상담사를 만들 준비가 되었습니다. 그러나 개발을 시작하기 전에 에이전트에 대한 명확한 비전을 설정하는 것이 중요합니다. 다음과 같은 주요 질문을 스스로에게 던져 보세요.
- 어떤 문제를 해결하나요? 작업을 자동화하거나, 정보를 제공하거나, 엔터테인먼트를 제공하거나, 창의적인 탐색을 용이하게 하나요?
- 주요 기능은 무엇인가요? 작업을 실행하나요, 작업을 위임하나요? 텍스트를 생성할까요, 아니면 다양한 미디어의 조합을 생성할까요?
- 어떤 제한사항이 있나요? 모든 작업을 자동으로 할 수 있나요?
- 어떤 성격이나 캐릭터를 가져야 하나요? 격식 있는 내용인가요, 비격식적인 내용인가요, 유머러스한 내용인가요, 유용한 내용인가요, 정보 제공적인 내용인가요?
- 성공 측정항목은 무엇인가요? 상담사의 효과는 어떻게 측정하나요?
절차를 신속하게 진행할 수 있도록 오늘 생성할 여행사에 대한 질문과 답변을 아래와 같이 전달해 주세요.
- 어떤 문제를 해결하나요?
- 여행을 계획하는 것은 시간이 많이 걸리고 부담스러울 수 있습니다. 이 여행 에이전트를 사용하면 사용자가 목적지를 찾고, 일정을 계획하고, 항공편 및 숙박 시설을 예약할 수 있습니다.
- 주요 기능은 무엇인가요?
- 상담사는 다음을 수행할 수 있어야 합니다.
- 비자 요구사항과 같은 목적지에 관한 질문에 답변
- 사용자의 일정 및 목표에 맞는 숙박 일정 계획
- 항공편 및 숙박 예약
- 어떤 제한사항이 있나요?
- 상담사가 기본적으로 복잡한 쿼리에 답변하지 못할 수 있습니다.
- 에이전트가 시각적 이미지를 생성할 수 없게 됩니다.
- 상담사의 지식은 기본 모델에 의해 제한됩니다.
- 어떤 성격이나 캐릭터를 가져야 하나요?
- 이 상담사는 여행에 대한 지식이 풍부하고 유용하며 열정이 있어야 합니다. 명확하고 간결하게 정보를 전달할 수 있어야 합니다.
- 성공 측정항목은 무엇인가요?
- 이 상담사의 성공은 사용자가 추천 (탐색, 계획, 예약)에 얼마나 만족하는지로 측정할 수 있습니다.
3. Vertex AI Agent Builder로 AI 에이전트 빌드
Vertex AI Agent Builder를 사용하면 몇 단계만으로 AI 에이전트를 만들 수 있습니다.
1단계:
- Vertex AI Agent Builder로 이동합니다.
- 시작 페이지가 표시됩니다.
- API 계속 및 활성화 버튼을 클릭합니다.
2단계:
- 앱 만들기 페이지로 리디렉션됩니다.
- 새 앱 만들기 버튼을 클릭합니다.
3단계:
- 다음 페이지에서 상담사를 선택합니다.
4단계:
- 표시 이름을 선택합니다 (예: 여행 친구).
- 리전으로 전역 선택
- 동의 및 만들기 버튼을 클릭합니다.
5단계:
- 상담사 이름 (예: 정보 상담사)을 선택합니다.
- 목표 추가 (예: 고객이 여행 관련 문의에 답변할 수 있도록 지원)
- 안내를 정의합니다 (예: - 사용자에게 인사한 다음, 오늘 어떻게 도와드릴지 묻습니다).
- 모든 작업이 완료되면 저장을 누릅니다.
6단계:
- 방금 만든 에이전트 (예: 정보 에이전트)를 선택합니다.
- 에이전트의 기본 생성형 AI 모델을 선택합니다 (예: gemini-1.5-flash).
- 대화하면서 에이전트를 테스트합니다 (예: '사용자 입력 입력' 텍스트 상자에 입력).
축하합니다. Vertex AI Agent Builder를 사용하여 AI 에이전트를 만들었습니다.
4. 에이전트에 데이터 스토어 연결
상담사에게 와칸다로 이동하는 방법에 관해 질문하면 (예: "와칸다에 연락하려면 어떻게 해야 하나요?") 다음과 같은 응답을 받게 됩니다.
사실에 기반한 대답이지만 '정보를 제공해 드릴 수 없습니다'라고 말하고 대화를 종료하는 대신 상담사가 유사한 장소를 제안하는 것이 사용자에게 더 도움이 될 것입니다. 이 접근 방식은 사용자가 실제로 에이전트를 통해 여행을 예약하도록 할 수 있습니다.
상담사가 유사한 장소를 추천할 수 있도록 하려면 Datastore를 통해 상담사에게 추가 정보를 제공하면 됩니다. 상담사가 내장된 지식을 바탕으로 사용자 질문에 답변할 수 없는 경우 참고할 수 있는 추가 지식 베이스 역할을 합니다.
데이터 스토어를 만드는 것은 간단합니다. 상담사 기본사항 페이지 하단에 있는 + 데이터 스토어 버튼을 클릭합니다.
다음 화면에서 다음 정보를 입력합니다.
- 도구 이름: 대체 위치
- 유형: 데이터 스토어
- 설명: 사용자의 요청에 존재하지 않는 위치가 포함된 경우 이 도구를 사용하세요.
완료되면 저장을 클릭합니다. 이렇게 하면 에이전트가 데이터 저장소와 통신할 수 있는 데이터 저장소 도구가 생성되지만, 여전히 이 정보를 포함하는 실제 데이터 저장소를 만들어야 합니다. 이렇게 하려면 데이터 스토어 만들기를 클릭합니다.
검색 및 대화 데이터 스토어를 미국 리전에 배치하는 데 동의하라는 팝업이 표시될 수 있습니다. 계속하려면 AGREE 버튼을 클릭합니다.
데이터 스토어 생성을 계속하여 회사 이름 필드 (예: Travel Wise)을 작성하고 계속을 클릭합니다.
데이터 저장소 만들기를 클릭하고 Cloud Storage를 선택합니다.
단계를 완료하면
- 구조화되지 않은 문서 (PDF, HTML, TXT 등)를 선택합니다.
- 파일을 클릭합니다.
- 셀에 ai-workshops/agents/data/wakanda.txt를 입력합니다.
- 계속 버튼을 클릭합니다.
제공된 텍스트 파일의 내용은 다음과 같습니다.
Wakanda와 유사한 장소
- 남아프리카 공화국의 오리비 협곡: 이곳의 암석 지형은 와칸다의 전사 폭포를 연상시킵니다.
- 이구아수 폭포: 아르헨티나와 브라질의 국경에 위치한 이 거대한 폭포는 워리어 폭포의 주요 영감이 되었습니다.
- Wakandan 문화에 푹 빠져 보세요. 블랙팬더 만화를 읽고, 영화를 시청하고, 온라인 리소스를 살펴보면서 Wakandan 문화, 언어, 기술에 대해 자세히 알아보세요.
- 디즈니 테마파크 방문: 아직 전용 Wakanda 랜드는 없지만 디즈니랜드 또는 Marvel Day at Sea Disney 크루즈에서 블랙팬더를 만날 수 있습니다.
다음 페이지에서 데이터 스토어 이름 (예: Wakanda Alternative)을 지정하고 만들기를 클릭합니다.
마지막 단계로 방금 만든 데이터 소스를 선택하고 만들기를 클릭합니다.
모든 작업이 원활하게 진행되면 '사용 가능한 데이터 스토어' 페이지에 생성된 데이터 스토어가 표시됩니다.
데이터 스토어 (이 경우 Wakanda Alternative)를 클릭하면 데이터 스토어에 포함된 문서를 비롯한 데이터 스토어에 관한 세부정보가 표시됩니다.
상담사 기본사항 페이지로 돌아가서 모든 도구 관리 를 클릭합니다.
이전에 만든 데이터 스토어를 클릭합니다.
데이터 스토어 섹션에 새로운 설정이 표시됩니다. 새 설정이 즉시 표시되지 않으면 데이터 스토리지가 아직 Google Cloud Storage에서 데이터를 처리하고 있는 것입니다. 이 작업은 5분 이내에 완료됩니다.
- 연결할 데이터 스토어 (예: Wakanda Alternative)를 선택합니다.
- 상담사가 할루시네이션을 일으키지 않도록 설정을 매우 낮음으로 설정합니다. 이렇게 하면 상담사가 무언가를 꾸며내지 못하도록 더 엄격한 제한이 적용됩니다.
- 수정이 완료되면 페이지 상단의 저장 버튼을 클릭합니다.
Agent Basics 페이지로 다시 이동하여 데이터 스토어 (예: 대체 위치)를 선택하고 페이지 상단의 저장 버튼을 클릭합니다.
거의 완료되었습니다. 마지막 단계는 상담사 안내에 '대체 위치' 도구를 포함하는 것입니다. 상담사 안내에 - 사용자의 요청에 존재하지 않는 위치가 포함된 경우 ${TOOL: 대체 위치}를 사용하세요라는 줄을 추가합니다.
안내 상자의 테두리가 빨간색으로 변할 수 있지만 괜찮습니다. 페이지 상단의 저장 버튼을 클릭하여 상담사를 저장합니다.
상담사의 구성을 저장한 후 상담사에게 다시 Wakanda (예: 'Wakanda에 가는 가장 좋은 방법은 무엇인가요?')에 관해 물어보면 다음과 같이 다른 대답을 받게 됩니다.
축하합니다. 이제 에이전트가 텍스트 파일에 제공된 정보를 사용하여 장소를 추천합니다.