에이전트의 토폴로지 보기

에이전트 레지스트리에서 에이전트 또는 AI 애플리케이션으로 오가는 트래픽을 보여주는 토폴로지 그래프를 볼 수 있습니다. 그래프를 분석하면 에이전트 또는 AI 애플리케이션이 신뢰할 수 있는 에이전트, MCP 서버, 엔드포인트와 통신하고 있는지 파악할 수 있습니다.

에이전트 리소스에 대한 자세한 통계를 확인하려면 토폴로지 페이지에서 쿼리 빌더를 사용하세요. 관측 가능성, 보안, 소프트웨어 공급망, 에이전트와 연결된 인프라 리소스 데이터를 시각화할 수 있습니다.

토폴로지 데이터에는 일부 제한사항이 적용됩니다.

시작하기 전에

이 안내에서는 Agent Registry를 설정하고 에이전트 리소스를 등록했다고 가정합니다.

1. 에이전트 트래픽을 확인하려면 AI 애플리케이션을 계측하세요.

2. 아직 사용 설정되지 않은 API가 있으면 App Hub, 앱 토폴로지, Cloud 애셋 인벤토리, Observability API를 사용 설정합니다.

   API 사용 설정에 필요한 역할

   API를 사용 설정하려면 serviceusage.services.enable 권한이 필요합니다. 프로젝트를 만든 경우 소유자 역할 (roles/owner)을 통해 이 권한이 이미 있을 수 있습니다. 그렇지 않은 경우 서비스 사용량 관리자 역할 (roles/serviceusage.serviceUsageAdmin)을 통해 이 권한을 얻을 수 있습니다. 역할을 부여하는 방법 알아보기

   API 사용 설정

3. Cloud de Confiance 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

4. VPC 서비스 제어 경계에서 서비스를 보호하는 경우 앱 토폴로지와 기본 데이터를 제공하는 서비스를 포함하도록 경계를 업데이트합니다. 자세히 알아보기

필요한 역할

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

• 앱 토폴로지 뷰어 (roles/apptopology.viewer)
• Agent Registry API 뷰어 (roles/agentregistry.viewer)

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

이러한 사전 정의된 역할에는 Agent Registry에서 토폴로지 그래프를 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

에이전트 레지스트리에서 토폴로지 그래프를 보려면 다음 권한이 필요합니다.

• 발견된 리소스 데이터 가져오기: apptopology.discoveredResourcesTopologies.generate
• 리소스 데이터 가져오기: apptopology.sreDomainTopologies.generate

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

에이전트 토폴로지 보기

1. Cloud de Confiance 콘솔에서 Agent Registry 페이지로 이동합니다.

   Agent Registry로 이동

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

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

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

5. 빠른 쿼리 섹션에서 쿼리를 클릭합니다. 쿼리와 일치하는 결과가 있으면 토폴로지 그래프가 표시됩니다.

6. 토폴로지 그래프를 살펴봅니다. 그래프에는 쿼리와 일치하는 리소스와 리소스 간의 관계가 표시됩니다.

   • 아이콘은 노드, 검색되고 등록된 리소스, 리소스 유형을 나타냅니다.
   • 선은 연결, 즉 노드 간의 관계를 나타냅니다.

   

   다음과 같은 방법으로 토폴로지와 상호작용할 수 있습니다.

   • 확대/축소하거나 노드 위치를 변경하여 시각화를 변경합니다.
   • 두 노드 사이의 연결 선 위로 마우스를 가져가 연결 라벨을 확인합니다.
   • 노드 또는 연결을 선택하여 정보를 확인합니다.
   • 패널 전환 first_page을 클릭하여 쿼리 패널을 숨기거나 표시합니다.

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

AI 애플리케이션 토폴로지 보기

1. Cloud de Confiance 콘솔에서 Agent Registry 페이지로 이동합니다.

   Agent Registry로 이동

2. 프로젝트 선택기에서 AI 애플리케이션이 포함된 프로젝트를 선택합니다.

3. AI 애플리케이션 탭에서 보려는 에이전트의 이름을 클릭합니다.

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

5. 빠른 쿼리 섹션에서 쿼리를 클릭합니다. 쿼리와 일치하는 결과가 있으면 토폴로지 그래프가 표시됩니다.

6. 토폴로지 그래프를 살펴봅니다. 그래프에는 쿼리와 일치하는 리소스와 리소스 간의 관계가 표시됩니다.

   • 아이콘은 노드, 검색되고 등록된 리소스, 리소스 유형을 나타냅니다.
   • 선은 연결, 즉 노드 간의 관계를 나타냅니다.

   

   다음과 같은 방법으로 토폴로지와 상호작용할 수 있습니다.

   • 확대/축소하거나 노드 위치를 변경하여 시각화를 변경합니다.
   • 두 노드 사이의 연결 선 위로 마우스를 가져가 연결 라벨을 확인합니다.
   • 노드 또는 연결을 선택하여 정보를 확인합니다.
   • 패널 전환 first_page을 클릭하여 쿼리 패널을 숨기거나 표시합니다.

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

다음 단계

• 토폴로지 페이지에서 에이전트 리소스에 관한 데이터를 시각화합니다.