이 페이지에서는 콘솔에서 Google Cloud Agent Studio를 사용하는 방법을 간략하게 설명합니다.
Agent Studio는 Google Cloud 콘솔 내의 로우 코드 시각 디자이너로 에이전트 개발을 간소화합니다. 에이전트 워크플로를 시각적으로 매핑하고, 실시간으로 대답을 테스트하고, 배포하거나 코드로 전환하기 전에 다양한 구성을 실험할 수 있습니다.
이 문서에서는 Agent Studio를 간략하게 설명하고 환경을 설정하고, 에이전트를 만들고 테스트하고, 프로덕션 런타임에 직접 배포하는 방법을 설명합니다.
환경 설정
Agent Studio를 사용하기 전에 설정을 완료하세요 Google Cloud.
필요한 역할 가져오기
Agent Studio를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 에이전트 플랫폼 사용자 (roles/aiplatform.user) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
에이전트 만들기
Agent Studio에서 에이전트를 설계하고 테스트하려면 다음 단계를 따르세요.
콘솔에서 에이전트 페이지로 이동합니다.
Google Cloud에이전트 만들기 를 클릭하여 새 에이전트의 Agent Studio 캔버스를 엽니다.
Agent Studio 캔버스에서 에이전트를 설계합니다. 다음 탭 간에 전환할 수 있습니다.
흐름: 에이전트의 워크플로 및 제어 로직을 시각적으로 표현하여 기본 에이전트와 하위 에이전트를 만듭니다.
에이전트를 클릭하여 해당 에이전트의 세부정보 패널을 엽니다. 하위 에이전트 추가 (+)를 클릭하여 하위 에이전트를 추가할 수도 있습니다.
세부정보 패널에서 기본 에이전트와 하위 에이전트를 구성합니다.
이름: 에이전트를 식별하는 데 도움이 되는 이름을 추가합니다.
설명: 에이전트의 목적을 요약합니다.
안내: 에이전트를 안내하는 안내를 추가합니다.
모델: 에이전트를 구동할 모델을 선택합니다.
도구: 도구 추가 (+)를 클릭하여 에이전트가 작업을 완료할 수 있는 도구를 추가합니다. 자세한 내용은 도구 설정 및 추가를 참조하세요.
미리보기: 에이전트를 빌드할 때 에이전트의 기능과 응답을 테스트합니다. 에이전트와 채팅하여 기능을 테스트합니다.
코드 가져오기 를 클릭하여 에이전트 코드를 확인합니다. 다른 곳에서 에이전트 개발을 계속하려면 코드를 복사하여 원하는 코드 편집기에 붙여넣으면 됩니다. 에이전트 개발을 계속하는 데 사용할 수 있는 다른 옵션은 ADK 튜토리얼을 참조하세요.
에이전트가 완료되면 Agent Studio에서 직접 배포할 수 있습니다. 자세한 내용은 Agent Studio에서 에이전트 배포를 참조하세요.
Agent Studio에서 도구 설정 및 추가
에이전트에 대해 다음 도구를 구성할 수 있습니다.
Google 검색: 에이전트가 Google 검색을 사용하여 웹 검색을 수행할 수 있도록 합니다. 기본적으로 사용 설정되어 있습니다.
URL 컨텍스트: 모델이 에이전트로 전송된 프롬프트의 URL을 분석하도록 합니다. 기본적으로 사용 설정되어 있습니다.
Agent Platform 검색 데이터 스토어: 추가 (+)를 클릭하여 에이전트가 Agent Search 데이터 스토어에서 색인이 생성된 정보에 액세스하도록 합니다.
프로젝트 번호: Agent Search 데이터 스토어와 연결된 Google Cloud 프로젝트 번호입니다. 프로젝트 번호 보기.
위치: 데이터 스토어의 위치 입니다.
데이터 스토어 ID: 포함할 데이터의 Datastore 모드의 Firestore (Datastore) ID입니다. 데이터 스토어 및 ID 목록 보기.
컬렉션 ID: 포함할 데이터의 컬렉션 ID입니다. 데이터 스토어 및 컬렉션 ID 목록 보기. 데이터 스토어에 컬렉션 ID가 없는 경우
default_collection을 입력합니다.
기존 데이터 스토어가 없는 경우 커스텀 검색 시작하기를 참조하여 데이터 스토어를 만드세요. 그런 다음 서비스 계정에 Agent Platform Search에 대한 액세스 권한을 부여합니다.
콘솔에서 IAM 페이지로 이동합니다.
Google Cloud액세스 권한 부여 를 클릭합니다.
새 주 구성원 필드에 다음 서비스 계정 정보를 입력합니다.
service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com.+ 역할 추가 를 선택합니다. Discovery Engine 사용자 를 검색하여 선택합니다. 적용 을 클릭한 후 저장 을 클릭합니다.
MCP 서버: 추가 (+)를 클릭하여 MCP 서버에 연결하여 MCP 도구를 추가합니다.
MCP 표시 이름: MCP 서버의 이름을 입력합니다.
엔드포인트 URL: MCP 서버의 엔드포인트 URL을 입력합니다.
인증: 없음 으로 자동 입력됩니다. Agent Studio는 인증이 필요하지 않은 MCP 서버만 지원합니다.
에이전트는 연결된 MCP 서버의 모든 도구를 사용할 수 있습니다.
Agent Studio에서 에이전트 배포
에이전트를 만들고 미리 본 후 프로덕션에 배포할 수 있습니다. Agent Studio에서 에이전트를 배포하려면 다음 단계를 따르세요.
에이전트 목록 페이지에서 배포할 에이전트를 클릭합니다. 선택한 에이전트의 에이전트 세부정보 페이지가 표시됩니다.
배포 를 클릭하여 Agent Runtime 인스턴스에 배포 대화상자를 엽니다.
(선택사항) 에이전트의 표시 이름 또는 설명 을 수정합니다.
사용 가능한 리전 목록에서 배포 리전을 선택한 후 확인 을 클릭합니다.
배포 를 클릭합니다.
배포하면 새 런타임 인스턴스가 생성되며 완료하는 데 최대 5분이 걸릴 수 있습니다. 성공하면 Agent Studio 캔버스의 흐름 탭에 메시지가 표시됩니다. 이제 에이전트를 프로덕션에서 사용할 수 있으며 외부 앱과 안전하게 통합할 수 있습니다.
배포된 에이전트 보기
배포된 에이전트를 보려면 다음 단계를 따르세요.
콘솔에서 **에이전트 플랫폼** 페이지로 이동합니다. Google Cloud
리전 목록을 사용하여 배포 리전별로 필터링합니다.
선택한 프로젝트에 속한 배포된 에이전트가 목록에 표시됩니다.
지정된 에이전트의 이름을 클릭합니다. 에이전트의 측정항목 페이지가 열립니다.
에이전트에 사용할 수 있는 측정항목에 대한 자세한 내용은 배포된 에이전트의 측정항목 보기를 참조하세요.