상담사 관계 보기

Gemini Enterprise 에이전트 플랫폼에서 에이전트 간 통신 및 에이전트와 MCP 서버 간 통신을 비롯한 에이전트 관계를 볼 수 있습니다.

제공된 쿼리를 사용하여 쿼리 결과를 토폴로지 그래프 또는 테이블로 탐색할 수 있습니다. 에이전트 관계에 대한 정보는 종속성을 이해하고 에이전트 거버넌스를 지원하는 데 도움이 될 수 있습니다.

검색된 에이전트와 에이전트 레지스트리에 등록된 에이전트의 데이터를 모두 볼 수 있습니다. Gemini Enterprise 에이전트 플랫폼은 집계된 trace 데이터를 사용하여 관계를 결정합니다.

제한사항

  • 쿼리 결과에는 다음 기준을 충족하는 구성요소만 포함됩니다.
    • 에이전트의 기능 유형 이 AGENT로 설정되어 있고 ADK, Gemini Enterprise 또는 Cloud Run을 사용하여 배포되거나 GKE를 사용하여 배포되고 에이전트 레지스트리에 등록되어야 합니다.
    • MCP 서버의 기능 유형 이 MCP로 설정되어 있어야 합니다. OneMCP, GKE 또는 Cloud Run을 사용하여 배포된 서드 파티 MCP 서버가 포함됩니다. 다른 MCP 서버는 포함되려면 에이전트 레지스트리에 등록되어야 합니다.
    • 도구 및 모델 또는 Workspace 에이전트와 같은 다른 구성요소는 결과에 포함되지 않습니다.
  • MCP 서버가 에이전트 레지스트리에 등록되면 App Hub에서 공유 리소스로 분류되며 토폴로지 그래프의 다른 노드에 대한 가장자리가 표시되지 않습니다. 이 제한사항은 MCP 서버가 공유 리소스로 분류된 경우에만 적용되며 Gemini Enterprise 데이터 커넥터 또는 Cloud Run에서 호스팅되는 MCP 서버와 같은 애플리케이션 전용 리소스에는 적용되지 않습니다.

시작하기 전에

  1. App Hub, 앱 토폴로지, Observability, Trace API를 사용 설정합니다.

    API 사용 설정에 필요한 역할

    API를 사용 설정하려면 serviceusage.services.enable 권한이 포함된 서비스 사용량 관리자 IAM 역할(roles/serviceusage.serviceUsageAdmin)이 필요합니다. 역할 부여 방법 알아보기.

    API 사용 설정

    2. trace 범위에 다른 프로젝트를 추가한 경우 해당 프로젝트에 Observability API도 사용 설정하는 것이 좋습니다. 토폴로지 그래프에는 선택한 프로젝트와 동일한 조직에 있는 trace 범위 프로젝트의 trace 데이터만 표시됩니다.

  2. 계측 OpenTelemetry를 사용하여 AI 애플리케이션을 계측합니다.

필요한 역할

토폴로지 그래프를 보는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 그래프 보기: 앱 토폴로지 뷰어 (roles/apptopology.viewer)
  • 등록된 에이전트 데이터 보기: 에이전트 레지스트리 API 뷰어 (agentregistry.viewer)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

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

프로젝트의 그래프 보기

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

    토폴로지로 이동

  2. 프로젝트 선택기에서 에이전트가 포함된 프로젝트를 선택합니다.

  3. 쿼리 섹션에서 쿼리를 클릭합니다.

  4. 그래프 섹션에 선택한 쿼리의 결과가 표시됩니다.

    토폴로지 그래프는 완전히 대화형입니다. 노드를 확대 및 축소하고 드래그하여 관계를 시각화할 수 있습니다. 그래프의 노드에 대한 추가 세부정보를 제공하는 패널을 열려면 노드를 클릭합니다.

  5. 쿼리 결과를 테이블로 보려면 테이블 을 클릭합니다.

    • 테이블에 표시할 열을 선택하려면 열 표시 옵션 을 클릭합니다.
    • 특정 속성에 대해 테이블을 필터링하려면 필터 필드에서 속성을 선택합니다.
    • 각 열을 오름차순 또는 내림차순으로 정렬할 수도 있습니다.

  6. 쿼리를 구체화하거나 맞춤설정하려면 선택한 쿼리를 수정하고 Cloud Hub에서 결과를 토폴로지 그래프로 볼 수 있습니다. Cloud Hub에서 수정 을 클릭합니다.

선택한 프로젝트의 에이전트에 대한 추가 데이터를 보려면 애플리케이션 모니터링에서 대시보드를 확인하세요.

등록된 에이전트의 그래프 보기

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

    에이전트 레지스트리로 이동

  2. 프로젝트 선택기에서 에이전트가 포함된 프로젝트를 선택합니다.

  3. 에이전트 탭에서 보려는 에이전트의 이름을 클릭합니다.

  4. 토폴로지 탭을 클릭합니다.

  5. 쿼리 섹션에서 쿼리를 클릭합니다.

  6. 그래프 섹션에 선택한 쿼리의 결과가 표시됩니다.

    토폴로지 그래프는 완전히 대화형입니다. 노드를 확대 및 축소하고 드래그하여 관계를 시각화할 수 있습니다. 그래프의 노드에 대한 추가 세부정보를 제공하는 패널을 열려면 노드를 클릭합니다.

  7. 쿼리 결과를 테이블로 보려면 테이블 을 클릭합니다.

    • 테이블에 표시할 열을 선택하려면 열 표시 옵션 을 클릭합니다.
    • 특정 속성에 대해 테이블을 필터링하려면 필터 필드에서 속성을 선택합니다.
    • 각 열을 오름차순 또는 내림차순으로 정렬할 수도 있습니다.

  8. 쿼리를 구체화하거나 맞춤설정하려면 선택한 쿼리를 수정하고 Cloud Hub에서 결과를 토폴로지 그래프로 볼 수 있습니다. Cloud Hub에서 수정 을 클릭합니다.

선택한 에이전트에 대한 추가 데이터를 보려면 애플리케이션 모니터링에서 대시보드를 확인하세요.

다음 단계