역할 및 권한

Agent Registry는 다음과 같은 Identity and Access Management (IAM) 역할을 제공합니다.

  • Agent Registry API 관리자 (roles/agentregistry.admin): 에이전트 수동 등록 및 메타데이터 업데이트를 비롯한 모든 작업을 수행합니다.
  • Agent Registry API 편집자 (roles/agentregistry.editor): Agent Registry 리소스에 대한 수정 액세스 권한입니다.
  • Agent Registry API 뷰어 (roles/agentregistry.viewer): 에이전트, 도구, 속성을 봅니다.

레지스트리에서 에이전트를 관리하거나 볼 사용자 또는 그룹에 적절한 Agent Registry IAM 역할을 부여합니다. 역할을 부여하려면 콘솔 또는 Google Cloud CLI에서 IAM 페이지를 사용하면 됩니다. Google Cloud 자세한 안내는 프로젝트, 폴더, 조직에 대한 액세스 관리를 참고하세요.

Agent Registry 역할

다음 표에서는 Agent Registry IAM 역할과 일반적인 책임을 설명합니다.

역할

설명

목적

Agent Registry API 관리자

에이전트 수동 등록 및 메타데이터 업데이트를 비롯한 모든 작업을 수행합니다.

  • 에이전트 및 MCP 서버를 등록하고 관리합니다.
  • 도구 정의 및 엔드포인트를 업데이트합니다.

Agent Registry API 편집자

Agent Registry 리소스에 대한 수정 액세스 권한입니다.

  • 에이전트 및 MCP 서버를 등록하고 관리합니다.
  • 도구 정의 및 엔드포인트를 업데이트합니다.

Agent Registry API 뷰어

에이전트, 도구, 속성을 봅니다.

  • 사용 가능한 에이전트 및 MCP 서버를 검색합니다.
  • 통합을 위한 기술 및 엔드포인트를 봅니다.

Agent Registry 권한

다음 표에는 각 Agent Registry IAM 역할에 있는 권한이 나와 있습니다.

(roles/agentregistry.admin)

Agent Registry API 리소스에 대한 전체 액세스 권한입니다.

agentregistry.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search
  • agentregistry.bindings.create
  • agentregistry.bindings.delete
  • agentregistry.bindings.fetchAvailable
  • agentregistry.bindings.get
  • agentregistry.bindings.list
  • agentregistry.bindings.update
  • agentregistry.endpoints.get
  • agentregistry.endpoints.list
  • agentregistry.locations.get
  • agentregistry.locations.list
  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search
  • agentregistry.operations.cancel
  • agentregistry.operations.delete
  • agentregistry.operations.get
  • agentregistry.operations.list
  • agentregistry.services.create
  • agentregistry.services.delete
  • agentregistry.services.get
  • agentregistry.services.list
  • agentregistry.services.update

(roles/agentregistry.editor)

Agent Registry API 리소스에 대한 수정 액세스 권한입니다.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.*

  • agentregistry.operations.cancel
  • agentregistry.operations.delete
  • agentregistry.operations.get
  • agentregistry.operations.list

agentregistry.services.*

  • agentregistry.services.create
  • agentregistry.services.delete
  • agentregistry.services.get
  • agentregistry.services.list
  • agentregistry.services.update

(roles/agentregistry.viewer)

Agent Registry API 리소스에 대한 읽기 전용 액세스 권한입니다.

agentregistry.agents.*

  • agentregistry.agents.get
  • agentregistry.agents.list
  • agentregistry.agents.search

agentregistry.bindings.fetchAvailable

agentregistry.bindings.get

agentregistry.bindings.list

agentregistry.endpoints.*

  • agentregistry.endpoints.get
  • agentregistry.endpoints.list

agentregistry.locations.*

  • agentregistry.locations.get
  • agentregistry.locations.list

agentregistry.mcpServers.*

  • agentregistry.mcpServers.get
  • agentregistry.mcpServers.list
  • agentregistry.mcpServers.search

agentregistry.operations.get

agentregistry.operations.list

agentregistry.services.get

agentregistry.services.list

IAM 권한에 대한 자세한 내용은 적합한 사전 정의된 역할 찾기IAM 역할 및 권한 색인을 참고하세요.