Agent Studio에서 에이전트 설계

이 페이지에서는Google Cloud 콘솔에서 Agent Studio를 사용하는 방법을 간략하게 설명합니다.

Agent Studio는 에이전트 개발을 간소화하는 Google Cloud 콘솔 내의 로우 코드 시각 디자이너입니다. Agentic Workflows를 시각적으로 매핑하고, 실시간으로 대답을 테스트하고, 배포하거나 코드로 전환하기 전에 다양한 구성을 실험할 수 있습니다.

이 문서에서는 Agent Studio의 개요를 제공하고 환경을 설정하고, 에이전트를 만들고 테스트하고, 프로덕션 런타임에 직접 배포하는 방법을 설명합니다.

환경 설정

Agent Studio를 사용하기 전에 Google Cloud를 설정하세요.

필요한 역할 가져오기

Agent Studio를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 에이전트 플랫폼 사용자 (roles/aiplatform.user) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

에이전트 만들기

프롬프트 또는 플로우 빌더를 사용하여 Agent Studio에서 에이전트를 만들 수 있습니다.

프롬프트를 사용하여 에이전트 만들기

프롬프트를 사용하여 에이전트를 만들려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 에이전트 페이지로 이동합니다.

    에이전트로 이동

  2. 에이전트 만들기를 클릭하여 새 에이전트의 Agent Studio 캔버스를 엽니다.

  3. 채팅 상자에 에이전트의 목적과 의도된 동작을 설명하는 프롬프트를 입력합니다.

  4. 을 클릭합니다.

  5. 프롬프트에 따라 다음 중 하나가 수행됩니다.

    • 성공: 흐름 빌더가 즉시 업데이트되어 에이전트의 실시간 미리보기가 표시되고 채팅에 적용된 수정사항의 요약이 제공됩니다. 모든 변경사항은 자동으로 저장됩니다.

    • 설명 필요: 프롬프트가 모호한 경우 어시스턴트는 채팅에서 명확한 질문을 하여 빌드하려는 항목을 더 잘 이해합니다.

    • 오류: 어시스턴트가 프롬프트를 적용할 수 없는 경우 요청을 다시 작성하라는 오류 메시지가 표시됩니다.

  6. 프롬프트 또는 흐름 빌더를 사용하여 에이전트를 계속 업데이트할 수 있습니다.

  7. 에이전트를 저장하려면 캔버스 헤더에서 저장을 클릭하고 안내를 따릅니다. 자세한 내용은 에이전트 저장을 참고하세요.

  8. 에이전트를 빌드하면서 에이전트의 기능과 대답을 테스트하려면 미리보기 탭을 클릭하고 에이전트와 채팅하세요.

제한사항

프롬프트를 사용하여 에이전트를 만들 때는 다음 제한사항이 적용됩니다.

기능 제한사항
지식 에이전트에 지식을 추가할 수 없습니다. 흐름 빌더 인터페이스를 사용하여 에이전트에 기술 자료를 추가할 수 있습니다.

플로우 빌더를 사용하여 에이전트 만들기

다음 단계에 따라 흐름 빌더를 사용하여 에이전트를 설계하고 테스트합니다.

  1. Google Cloud 콘솔에서 에이전트 페이지로 이동합니다.

    에이전트로 이동

  2. 에이전트 만들기를 클릭하여 새 에이전트의 Agent Studio 캔버스를 엽니다.

  3. Agent Studio 캔버스에서 에이전트를 설계하고 저장합니다. 기본 에이전트를 만들고 하위 에이전트를 추가할 수 있습니다. 기본 에이전트는 항상 로컬 에이전트입니다. 하위 에이전트는 로컬 에이전트 또는 Agent Registry 에이전트일 수 있습니다.

    • 로컬 에이전트: Agent Studio 캔버스 내에서 직접 지침, 모델, 도구를 작성하고 구성하는 에이전트입니다.
    • Agent Registry 에이전트: Agent Registry에 등록되고 게시된 에이전트입니다. 이러한 에이전트를 기본 에이전트의 흐름 내에서 원격 하위 에이전트로 사용할 수 있습니다.

    설계할 때 다음 흐름 및 미리보기 탭 간에 전환할 수 있습니다.

    Flow

    에이전트의 워크플로와 제어 로직을 시각적으로 표현하여 기본 에이전트와 하위 에이전트를 만듭니다.

    1. 에이전트를 클릭하여 해당 에이전트의 세부정보 패널을 엽니다. 하위 에이전트 추가 (+)를 클릭하여 하위 에이전트를 추가할 수도 있습니다.

    2. 세부정보 패널에서 기본 에이전트와 하위 에이전트를 구성합니다.

      기본 에이전트 및 로컬 하위 에이전트:

      1. 이름: 에이전트를 식별하는 데 도움이 되는 이름을 추가합니다.
      2. 설명: 에이전트의 목적에 대한 요약입니다.
      3. 요청 사항: 에이전트를 안내할 요청 사항을 추가합니다.
      4. 모델: 에이전트를 지원할 모델을 선택합니다.
      5. 도구: 도구 추가 (+)를 클릭하여 에이전트가 작업을 완료할 수 있는 도구를 추가합니다. 자세한 내용은 도구 설정 및 추가하기를 참고하세요.

      하위 에이전트 (로컬 또는 Agent Registry에서 가져온 에이전트):

      1. 하위 에이전트 소스: 하위 에이전트의 소스를 선택합니다.

        • 로컬: 캔버스에서 직접 하위 에이전트의 요청 사항, 모델, 도구를 작성합니다.
        • 에이전트 레지스트리: 에이전트 레지스트리에서 등록된 에이전트를 원격 하위 에이전트로 선택합니다. 이 옵션은 에이전트를 저장한 후에만 사용할 수 있습니다. 자세한 내용은 에이전트 저장을 참고하세요.

        등록된 에이전트를 선택하면 해당 이름과 설명이 레지스트리에서 가져와지고 캔버스에서 읽기 전용이 됩니다. 상위 에이전트는 에이전트 카드를 기반으로 이 하위 에이전트에 작업을 라우팅합니다.

        상위 에이전트를 실행하거나 배포하려면 상위 에이전트의 ID에 A2A 하위 에이전트를 검색하고 호출할 수 있는 권한이 있어야 합니다. 권한 대화상자에서 이 작업을 자동으로 처리합니다. 권한을 수동으로 관리해야 하는 경우 에이전트 간 (A2A) 위임에 대한 액세스 권한 부여를 참조하세요.

    3. 에이전트를 저장하려면 캔버스 헤더에서 저장을 클릭하고 안내를 따릅니다. 자세한 내용은 에이전트 저장을 참고하세요.

    미리보기

    미리보기 창에서 에이전트와 채팅하여 기능과 대답을 테스트합니다.

    • 저장된 에이전트를 미리 보려면 Agent Studio에서 에이전트의 ID 권한을 확인합니다. 필수 역할이 누락된 경우 알림이 표시됩니다. 관리를 클릭하여 권한 대화상자를 열고 에이전트 ID 권한을 관리합니다.
    • 각 에이전트 실행의 이벤트를 검사하여 에이전트 동작을 디버그할 수 있습니다. 자세한 내용은 에이전트 이벤트 검사를 참조하세요.

  4. 코드 가져오기를 클릭하여 에이전트 코드를 확인합니다. 다른 곳에서 에이전트를 계속 개발하려면 코드를 복사하여 원하는 코드 편집기에 붙여넣으면 됩니다.

    에이전트가 에이전트 레지스트리의 원격 하위 에이전트를 사용하는 경우 생성된 Python 코드에는 런타임에 하위 에이전트를 동적으로 확인하기 위한 AgentRegistry.get_remote_a2a_agent 호출이 포함됩니다.

에이전트가 완성되면 Agent Studio에서 바로 배포할 수 있습니다. 자세한 내용은 Agent Studio에서 에이전트 배포를 참고하세요.

Studio 프롬프트에서 에이전트 모드 전환을 사용하여 에이전트 만들기

에이전트 모드로 전환하여 Agent Studio 시작 프롬프트에서 바로 에이전트 빌드를 시작할 수 있습니다. 사용 설정하면 프롬프트를 제출하면 에이전트 디자이너 캔버스 내에서 에이전트 빌더가 바로 실행됩니다.

다음 단계에 따라 Studio 프롬프트에서 에이전트를 빌드합니다.

  1. Google Cloud 콘솔에서 Agent Studio로 이동합니다.

  2. 시작 작업공간의 기본 프롬프트 입력 영역에서 모드 전환을 찾습니다.

  3. 전환 버튼을 에이전트 모드로 전환합니다.

  4. 설계하려는 에이전트의 목적, 워크플로, 동작을 설명하는 프롬프트를 입력합니다.

  5. 을 클릭합니다.

Agent Studio는 에이전트 디자이너 캔버스에서 에이전트 빌더 작업을 직접 실행하여 프롬프트를 기반으로 에이전트 흐름과 구성을 자동 입력합니다. 그런 다음 요청 사항을 수정하고, 모델을 선택하고, 도구 또는 하위 에이전트를 추가할 수 있습니다.

에이전트 이벤트 검사

이벤트를 검사하면 에이전트의 동작을 디버그하고, 에이전트의 추론 프로세스 및 모델 요청을 문제 해결하고 추적할 수 있습니다.

Agent Studio의 미리보기 탭에서 에이전트 이벤트를 검사하여 에이전트 실행을 디버깅할 수 있습니다. 이 작업을 사용하면 실행 중에 에이전트가 생성하는 개별 이벤트의 문제를 진단할 수 있습니다.

에이전트 이벤트를 검사하려면 다음 단계를 따르세요.

  1. Agent Studio 캔버스에서 에이전트를 열고 미리보기 탭을 엽니다.
  2. 미리보기 창에서 에이전트와 채팅을 시작하여 실행을 시작합니다.

  3. 대화에서 이벤트를 선택하여 세부정보를 엽니다. 사용 가능한 세부정보는 이벤트에 따라 다르며 다음이 포함될 수 있습니다.

    • 작성자: 이벤트를 생성한 에이전트 또는 하위 에이전트입니다. 작성자를 사용하여 멀티 에이전트 워크플로에서 단계를 수행한 하위 에이전트를 식별합니다.
    • 요청 및 응답: 모델에 전송된 페이로드와 반환된 응답입니다.
    • 도구 호출: 에이전트 실행 중에 도구에 전달되는 인수입니다.
    • 메타데이터: 모델 이름, 토큰 사용량, 타임스탬프와 같은 추가 진단 정보입니다.

미리보기 중에 에이전트가 오류를 반환하면 문제를 진단할 수 있도록 미리보기 탭에 오류가 표시됩니다.

에이전트 저장

저장되지 않은 에이전트에는 아직 ID가 없으므로 에이전트를 미리 보거나 배포하거나 기술 자료 파일을 업로드하려면 먼저 에이전트를 저장해야 합니다. 이 요구사항은 에이전트 레지스트리 하위 에이전트에도 적용됩니다.

또한 Agent Registry에 게시된 MCP 서버를 노드 수준 도구로 추가하기 전에 에이전트를 저장해야 합니다.

에이전트를 처음 저장하려면 다음 단계를 따르세요.

  1. Agent Studio 캔버스에서 저장을 클릭합니다.

  2. 에이전트 저장 대화상자에서 에이전트 이름을 입력합니다.

  3. 저장을 클릭합니다.

처음 저장한 후에는 Agent Studio에서 추가로 변경한 사항을 자동으로 저장합니다. 새 에이전트를 저장하기 전에 캔버스를 나가려고 하면 Agent Studio에서 먼저 저장하라는 메시지가 표시됩니다.

에이전트 업데이트

에이전트를 업데이트하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 에이전트 페이지로 이동합니다.

    에이전트로 이동

  2. 업데이트할 에이전트에서 을 클릭한 다음 수정을 클릭합니다.

  3. 프롬프트 또는 플로우 빌더를 사용하여 에이전트를 업데이트합니다.

Agent Studio는 변경사항을 자동으로 저장합니다.

Agent Studio에서 도구 설정 및 추가하기

에이전트에 다음 도구를 구성할 수 있습니다.

  • Google 검색: 에이전트가 Google 검색을 사용하여 웹 검색을 수행할 수 있습니다. 기본적으로 사용 설정되어 있습니다.

  • URL 컨텍스트: 모델이 에이전트에 전송된 프롬프트의 URL을 분석할 수 있습니다. 기본적으로 사용 설정되어 있습니다.

  • Agent Registry의 MCP 서버: Agent Registry에 게시된 MCP 서버를 노드 수준 도구로 연결합니다. 이 옵션은 에이전트를 저장한 후에만 사용할 수 있습니다. 자세한 내용은 에이전트 저장을 참고하세요.

    1. 에이전트 레지스트리의 MCP 서버 옆에 있는 추가 (+)를 클릭합니다.
    2. 위치: 등록된 도구를 필터링할 리전을 선택합니다.
    3. MCP 서버: 목록에서 등록된 Google MCP 서버를 선택합니다.
    4. 인증 구성: IAM 바인딩을 통해 확인된 표준 서비스 액세스를 사용하려면 없음을 선택합니다.
    5. 추가를 클릭합니다.
    6. 에이전트를 처음 저장하는 경우 캔버스 헤더에서 저장을 클릭합니다. 이후 변경사항은 자동으로 저장됩니다.

    에이전트가 연결된 MCP 서버의 모든 도구를 사용할 수 있습니다.

기존 도구 이전

Agent Registry를 통해 보안을 적용하고 도구 관리를 표준화하기 위해 Agent Studio에서는 Vertex AI Search 데이터 스토어 및 직접 모델 컨텍스트 프로토콜 (MCP) 서버와의 직접 통합을 지원 중단합니다.

기존 에이전트의 경우 지원 중단된 도구는 읽기 전용입니다. 전체 기능을 유지하려면 Agent Registry의 MCP 서버로 마이그레이션하세요.

기존 Vertex AI Search 데이터 스토어에서 마이그레이션

에이전트가 지원 중단된 Agent Platform Search 데이터 스토어 도구를 사용하는 경우 Agent Registry에서 사용할 수 있는 Agent Search MCP 서버로 이전하세요. 이 도구는 Agent Registry에 discoveryengine.googleapis.com로 표시됩니다.

Agent Search MCP 서버를 연결할 때는 에이전트의 안내에 대상 서빙 구성을 정의해야 합니다. 또한 에이전트 ID에는 액세스 권한이 필요합니다.

이전하려면 다음 단계를 따르세요.

  1. Agent Studio 캔버스에서 에이전트를 엽니다.
  2. 도구 패널에서 Vertex AI Search 데이터 스토어 도구를 찾습니다.
  3. 프로젝트 ID, 위치, 데이터 스토어 ID와 같은 도구 설정을 기록해 둡니다.
  4. 새 에이전트를 만들고 저장합니다.
  5. 에이전트 ID에 검색 엔진 뷰어 (roles/discoveryengine.viewer) 역할을 부여합니다. 타겟 데이터 스토어 또는 검색 애플리케이션에 직접 이 역할을 부여하는 것이 좋습니다. 하지만 문제 해결을 위해 프로젝트에 부여할 수 있습니다. 에이전트의 ID 주 구성원을 찾아 역할을 부여하려면 역할 수동 관리를 참고하세요. 또한 에이전트에는 MCP 도구 사용자 역할 (roles/mcp.toolUser)이 필요하며, 이 역할은 권한 대화상자에서 자동으로 부여됩니다.
  6. 도구 패널에서 에이전트 레지스트리의 MCP 서버 옆에 있는 추가 (+)를 클릭합니다.
  7. 다음 사항을 지정합니다.
    1. 위치: 도구가 등록된 리전을 선택합니다.
    2. MCP 서버: 등록된 MCP 서버 목록에서 에이전트 검색 또는 discoveryengine.googleapis.com을 선택합니다.
    3. 인증 구성: 없음을 선택합니다. 액세스는 표준 IAM 바인딩을 통해 확인됩니다.
    4. 추가를 클릭합니다.

  8. 새 에이전트의 안내에서 3단계에서 기록한 값을 사용하여 대상 서빙 구성을 지정합니다. 예를 들면 다음과 같습니다.

    Use the search tool to answer questions about YOUR_TOPIC.
When using the search tool, use this servingConfig:
projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores/DATA_STORE_ID/servingConfigs/default_search

    검색 애플리케이션의 경우 dataStores/DATA_STORE_ID을 engines/APP_ID로 바꿉니다. 지원되는 형식과 인수는 MCP 도구 참조: discoveryengine.googleapis.com을 참고하세요.

기존 직접 MCP 서버에서 마이그레이션

에이전트가 엔드포인트 URL을 사용하여 MCP 서버에 직접 연결하는 경우 먼저 에이전트 레지스트리에 MCP 서버 카탈로그를 등록해야 합니다.

도구를 이전하려면 다음 단계를 따르세요.

  1. MCP 서버가 에이전트 레지스트리에 등록되어 있는지 확인합니다.
  2. Agent Studio에서 에이전트를 업데이트합니다.
    1. Agent Studio 캔버스에서 에이전트를 엽니다.
    2. 기존 직접 MCP 서버 연결을 찾아 삭제합니다.
    3. 에이전트 레지스트리의 MCP 서버 옆에 있는 추가 (+)를 클릭합니다.
    4. 목록에서 등록된 MCP 서버를 선택합니다.
    5. 추가를 클릭합니다.
    6. 에이전트를 처음 저장하는 경우 캔버스 헤더에서 저장을 클릭합니다. 이후 변경사항은 자동으로 저장됩니다.

지식 파일로 에이전트 그라운딩

Agent Studio에서 에이전트의 대답을 그라운딩하기 위해 정적 참조 문서를 업로드합니다.

  1. 캔버스에서 참조 파일을 첨부할 상위 에이전트 노드를 선택합니다. 하위 에이전트에는 지식 파일을 첨부할 수 없습니다.
  2. 노드의 세부정보 패널에서 지식 섹션을 찾습니다. 지식 섹션은 에이전트를 처음 저장한 후에만 표시됩니다. 자세한 내용은 에이전트 저장을 참고하세요.
  3. 파일 업로드 구성요소를 클릭하고 참조 파일을 찾아 선택합니다. 에이전트당 최대 10개의 파일을 첨부할 수 있습니다. 파일 크기는 2MB를 초과해서는 안 됩니다. 업로드 캔버스에서는 다음 파일 형식을 지원합니다.
    • PDF
    • 일반 텍스트

  4. 에이전트를 처음 저장하는 경우 캔버스 헤더에서 저장을 클릭하여 상위 에이전트의 AGENT_ID와 일치하는 경로 프리픽스 아래에 있는 전용 Cloud Storage 버킷에 파일을 저장합니다. 이후 변경사항은 자동으로 저장됩니다.

    권한 대화상자는 버킷의 에이전트 ID에 스토리지 객체 뷰어 역할(roles/storage.objectViewer)을 부여합니다.

  5. 미리보기 탭으로 이동하여 테스트 질문을 제출하여 에이전트가 환각 없이 파일의 콘텐츠를 사용하여 대답을 그라운딩하는지 확인합니다.

  6. 선택사항: 코드 가져오기를 클릭하여 생성된 Python 코드(agent.py)를 복사하고 그라운딩 파일 구성을 검사할 수 있습니다. 이 단계를 건너뛸 수 있습니다.

상담사 ID 권한 관리

Agent Studio의 각 에이전트에는 다른 Google Cloud 리소스에 액세스하는 IAM 주 구성원 역할을 하는 고유한 ID가 있습니다.

주 구성원 형식은 다음과 같습니다.

principal://agents.global.org-ORGANIZATION_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID

다음을 바꿉니다.

  • ORGANIZATION_ID: 조직의 숫자 ID입니다.
  • PROJECT_NUMBER:Google Cloud 프로젝트의 프로젝트 번호입니다.
  • LOCATION: 에이전트가 배포된 리전입니다.
  • REASONING_ENGINE_ID: 추론 엔진의 리소스 ID입니다.

에이전트 ID에 관한 자세한 내용은 에이전트 ID로 에이전트 만들기 및 에이전트 ID 개요를 참고하세요.

권한 대화상자 동작

저장된 에이전트의 배포를 클릭하거나 미리보기 탭을 열면 Agent Studio는 에이전트의 ID에 성공적으로 실행하는 데 필요한 IAM 역할 집합이 있는지 자동으로 확인합니다. 일부 누락된 권한이 올바르게 설정되지 않았으면 에이전트가 실패할 수 있습니다. 이러한 권한을 에이전트의 ID에 부여하면 에이전트가 예상대로 작동하는 데 도움이 됩니다.

시스템에서 권한 문제를 감지하면 권한 대화상자에 오류 메시지가 표시됩니다.

  • 누락된 역할: 필수 역할이 누락된 경우 세부 역할이 나열된 대화상자가 표시됩니다. 대화상자에서 모두 부여를 클릭하여 한 번의 작업으로 에이전트 ID에 필요한 모든 역할을 자동으로 부여합니다. 역할을 부여하지 않고 에이전트를 미리 보거나 배포하려면 계속을 클릭합니다.
  • 모든 역할 부여됨: 필요한 모든 역할이 이미 부여된 경우 권한 대화상자가 표시되지 않습니다.
  • 저장되지 않은 에이전트: 저장되지 않은 에이전트에는 아직 ID가 없습니다. 에이전트를 저장할 때까지 권한 대화상자가 표시되지 않고 미리보기 탭과 배포 옵션이 사용 중지됩니다.

필요한 역할

권한 대화상자에서 다음 역할 목록을 자동으로 부여합니다.

  • roles/storage.objectViewer: 에이전트가 업로드된 파일을 사용하는 경우 필수입니다. 이 역할은 에이전트 파일의 특정 Cloud Storage 버킷 (예: {projectNumber}_{location}_agent_studio_files)에 부여되어야 합니다.
  • roles/mcp.toolUser: 에이전트가 에이전트 레지스트리 MCP 도구를 사용하는 경우 필요합니다.
  • roles/agentregistry.viewer: 에이전트가 Agent Registry MCP 도구 또는 하위 에이전트를 사용하는 경우 필요합니다.
  • roles/iamconnectors.user: Agent Registry MCP 도구가 authProviderName를 지정하는 경우에 필요합니다.
  • roles/aiplatform.viewer: 에이전트가 에이전트 간 (A2A) 위임을 통해 원격 하위 에이전트를 호출하는 경우 필요합니다.

Google Cloud 콘솔에서 수동으로 역할 관리

권한 대화상자에서 필요한 역할을 자동으로 부여합니다. 하지만 역할을 수동으로 관리하거나 권한 문제를 해결해야 하는 경우 다음 단계를 따르세요.

  1. 에이전트의 고유 ID 주 구성원을 복사합니다. Agent Studio 캔버스 헤더에서 에이전트 이름 옆에 있는 드롭다운 메뉴를 클릭하고 주 구성원 문자열을 복사합니다.

    주 구성원 형식은 다음 예시와 같습니다.

    principal://agents.global.org-ORG_ID.system.id.goog/resources/aiplatform/projects/PROJECT_NUMBER/locations/LOCATION/reasoningEngines/REASONING_ENGINE_ID

  2. Google Cloud 콘솔에서 IAM으로 이동합니다.

    IAM으로 이동

  3. 주 구성원 목록에서 에이전트 ID 주 구성원을 검색합니다. 주 구성원 문자열의 끝에서 특정 REASONING_ENGINE_ID를 사용하여 검색할 수 있습니다. 에이전트 ID 주 구성원을 가져오려면 다음 옵션 중 하나를 사용합니다.

    • 에이전트 ID 주 구성원이 이미 나열되어 있으면 에이전트 ID 옆에 있는 주 구성원 수정을 클릭합니다.
    • 에이전트 ID 주 구성원이 나열되지 않으면 액세스 권한 부여를 클릭하여 새 주 구성원으로 추가합니다.

  4. roles/storage.objectViewer 또는 roles/mcp.toolUser과 같이 구성에 필요한 역할을 추가하거나 수정합니다.

  5. 저장을 클릭합니다.

구성에 따라 권한 대화상자에서 자동으로 처리하지 않는 추가 역할을 수동으로 부여해야 할 수 있습니다. 예를 들어 등록된 MCP 도구가 BigQuery에서 데이터를 쿼리하는 등 다른 Google Cloud 리소스에 액세스하는 경우 에이전트의 ID에 BigQuery 데이터 뷰어 (roles/bigquery.dataViewer) 역할과 같은 필요한 역할을 수동으로 부여해야 합니다.

Agent Studio에서 에이전트 배포

에이전트를 만들고 미리 본 후 프로덕션에 배포할 수 있습니다. 다음 단계에 따라 Agent Studio에서 에이전트를 배포합니다.

  1. 에이전트 목록 페이지에서 배포할 에이전트를 클릭합니다. 선택한 상담사의 상담사 세부정보 페이지가 표시됩니다.

  2. 배포를 클릭하여 Agent Runtime 인스턴스에 배포 대화상자를 엽니다.

    에이전트의 ID에 필요한 권한이 누락된 경우 권한 대화상자가 표시되고 이 작업을 자동으로 처리합니다. 권한을 수동으로 관리해야 하는 경우 에이전트 ID 권한 관리 및 에이전트 간 (A2A) 위임 액세스 권한 부여를 참고하세요.

  3. 배포 구성 창에서 다음 옵션을 구성합니다.

    • 표시 이름 및 설명: 표시 이름을 수정하고 원하는 경우 에이전트에 대한 설명을 추가합니다.
    • A2A로 배포: 다른 에이전트가 재사용할 수 있는 Agent-to-Agent (A2A) 애셋으로 에이전트를 배포하려면 이 체크박스를 선택합니다. 독립형 애플리케이션의 경우 체크박스를 선택 해제하여 에이전트를 표준 ADK 애플리케이션으로 패키징합니다.

  4. 사용 가능한 리전 목록에서 배포 리전을 선택한 후 확인을 클릭합니다.

  5. 배포를 클릭합니다.

배포하면 새 런타임 인스턴스가 생성되며 완료하는 데 최대 5분이 걸릴 수 있습니다. 성공하면 Agent Studio 캔버스의 플로우 탭에 메시지가 표시됩니다. 이제 에이전트를 프로덕션에서 지금 이용 가능하며 외부 앱과 안전하게 통합할 수 있습니다.

배포된 에이전트 보기

배포된 에이전트를 보려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Agent Platform 배포 페이지로 이동합니다.

    배포로 이동

  2. 리전 목록을 사용하여 배포 리전별로 필터링합니다.

  3. 선택한 프로젝트의 일부인 배포된 에이전트가 목록에 표시됩니다.

  4. 지정된 에이전트의 이름을 클릭합니다. 에이전트의 측정항목 페이지가 열립니다.

  5. 플레이그라운드 탭을 선택하여 에이전트를 테스트합니다.

  6. 채팅 창에 테스트 쿼리를 입력하여 에이전트가 성공적으로 실행되는지 확인합니다.

에이전트에 사용할 수 있는 측정항목에 대한 자세한 내용은 배포된 에이전트의 측정항목 보기를 참조하세요.