Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.
의견 보내기
역할 및 권한
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Identity and Access Management (IAM) 역할 및 권한을 사용하면 에이전트 레지스트리에서 에이전트, MCP 서버, 도구, 독립형 스킬, 엔드포인트, 바인딩을 보고, 등록하고, 관리할 수 있는 사용자를 제어할 수 있습니다.
거버넌스 프로젝트 의 사용자 또는 그룹에 Agent Registry IAM 역할을 부여하려면 Google Cloud 콘솔의 IAM 페이지 또는 Google Cloud CLI를 사용합니다. 자세한 내용은 IAM으로 액세스 제어 및 프로젝트, 폴더, 조직에 대한 액세스 관리 를 참조하세요.
Agent Registry 역할
다음 표에서는 Agent Registry IAM 역할과 일반적인 책임을 설명합니다.
주의: Agent Registry API 관리자 (roles/agentregistry.admin) 또는 Agent Registry API 편집자 (roles/agentregistry.editor) 역할은 레지스트리를 관리하는 신뢰할 수 있는 관리자에게만 부여하세요. 이러한 역할을 에이전트에 직접 부여하지 마세요. 이러한 역할에는 중요한 에이전트 메타데이터 및 readOnlyHint 또는 destructiveHint와 같은 도구 주석 수정을 포함하여 서비스를 만들고, 삭제하고, 업데이트할 수 있는 권한이 포함되어 있습니다. 메타데이터 및 주석에 대한 악의적인 변경은 조정자가 수정된 도구를 사용할 때 의도하지 않은 파괴적인 결과를 초래할 수 있습니다. 또한 이러한 권한이 있는 에이전트는 악성 외부 에이전트를 레지스트리에 명시적으로 등록할 수 있습니다.
역할
설명
목적
Agent Registry API 관리자 (roles/agentregistry.admin)
에이전트, MCP 서버, 도구, 엔드포인트, 독립형 스킬, 스킬 버전, 바인딩, 스킬 IAM 정책을 포함한 모든 Agent Registry 리소스에 대한 전체 액세스 권한입니다.
에이전트, MCP 서버, 도구, 엔드포인트를 등록하고 관리합니다.
독립형 스킬 및 스킬 버전을 만들고 업데이트하고 삭제합니다.
바인딩 및 스킬 IAM 정책을 만들고 관리합니다.
Agent Registry API 편집자 (roles/agentregistry.editor)
에이전트, MCP 서버, 도구, 엔드포인트, 독립형 스킬, 스킬 버전을 포함한 Agent Registry 리소스에 대한 수정 액세스 권한입니다.
에이전트 및 MCP 서버를 등록하고 관리합니다.
도구 정의 및 엔드포인트를 업데이트합니다.
독립형 스킬 및 스킬 버전을 만들고 업데이트하고 삭제합니다.
Agent Registry API 뷰어 (roles/agentregistry.viewer)
에이전트, MCP 서버, 도구, 독립형 스킬, 스킬 버전, 게시자, 엔드포인트, 바인딩을 보고 검색할 수 있는 읽기 전용 액세스 권한입니다.
사용 가능한 에이전트, MCP 서버, 도구를 검색합니다.
통합을 위한 A2A 스킬, 독립형 스킬, 스킬 버전, 게시자, 엔드포인트, 바인딩을 확인합니다.
에이전트 레지스트리 사용자 (roles/agentregistry.user)
에이전트 레지스트리 리소스에 대한 읽기 전용 액세스 권한과 독립형 스킬 및 스킬 버전을 만들고 업데이트하고 삭제할 수 있는 액세스 권한입니다.
에이전트, MCP 서버 또는 엔드포인트에 대한 수정 액세스 권한 없이 독립형 스킬 및 스킬 버전을 만들고 업데이트하고 삭제합니다.
스킬 버전의 버전 제어를 유지하고 스킬의 활성 상태를 중앙에서 관리합니다.
Agent Registry 권한
다음 표에는 각 Agent Registry IAM 역할에 있는 권한이 나와 있습니다.
Agent Registry API 관리자베타
(roles/)
Agent Registry API 리소스에 대한 전체 액세스 권한입니다.
agentregistry.*
agentregistry.agents.getagentregistry.agents.listagentregistry.agents.searchagentregistry.bindings.createagentregistry.bindings.deleteagentregistry.agentregistry.bindings.getagentregistry.bindings.listagentregistry.bindings.updateagentregistry.endpoints.getagentregistry.endpoints.listagentregistry.locations.getagentregistry.locations.listagentregistry.mcpServers.getagentregistry.mcpServers.listagentregistry.agentregistry.agentregistry.agentregistry.operations.getagentregistry.operations.listagentregistry.publishers.getagentregistry.publishers.listagentregistry.services.createagentregistry.services.deleteagentregistry.services.getagentregistry.services.listagentregistry.services.updateagentregistry.agentregistry.agentregistry.agentregistry.agentregistry.skills.createagentregistry.skills.deleteagentregistry.skills.getagentregistry.agentregistry.skills.listagentregistry.skills.searchagentregistry.agentregistry.skills.update
Agent Registry API 편집자베타
(roles/)
Agent Registry API 리소스에 대한 수정 액세스 권한입니다.
agentregistry.agents.*
agentregistry.agents.getagentregistry.agents.listagentregistry.agents.search
agentregistry.
agentregistry.bindings.get
agentregistry.bindings.list
agentregistry.endpoints.*
agentregistry.endpoints.getagentregistry.endpoints.list
agentregistry.locations.*
agentregistry.locations.getagentregistry.locations.list
agentregistry.mcpServers.*
agentregistry.mcpServers.getagentregistry.mcpServers.listagentregistry.
agentregistry.operations.*
agentregistry.agentregistry.agentregistry.operations.getagentregistry.operations.list
agentregistry.publishers.*
agentregistry.publishers.getagentregistry.publishers.list
agentregistry.services.*
agentregistry.services.createagentregistry.services.deleteagentregistry.services.getagentregistry.services.listagentregistry.services.update
agentregistry.skillRevisions.*
agentregistry.agentregistry.agentregistry.agentregistry.
agentregistry.skills.create
agentregistry.skills.delete
agentregistry.skills.get
agentregistry.skills.list
agentregistry.skills.search
agentregistry.skills.update
Agent Registry API 뷰어
베타
(roles/)
Agent Registry API 리소스에 대한 읽기 전용 액세스 권한입니다.
agentregistry.agents.*
agentregistry.agents.getagentregistry.agents.listagentregistry.agents.search
agentregistry.
agentregistry.bindings.get
agentregistry.bindings.list
agentregistry.endpoints.*
agentregistry.endpoints.getagentregistry.endpoints.list
agentregistry.locations.*
agentregistry.locations.getagentregistry.locations.list
agentregistry.mcpServers.*
agentregistry.mcpServers.getagentregistry.mcpServers.listagentregistry.
agentregistry.operations.get
agentregistry.operations.list
agentregistry.publishers.*
agentregistry.publishers.getagentregistry.publishers.list
agentregistry.services.get
agentregistry.services.list
agentregistry.
agentregistry.
agentregistry.skills.get
agentregistry.skills.list
agentregistry.skills.search
Agent Registry 사용자베타
(roles/)
스킬 및 스킬 버전을 만들고 업데이트하고 삭제합니다.
agentregistry.agents.*
agentregistry.agents.getagentregistry.agents.listagentregistry.agents.search
agentregistry.
agentregistry.bindings.get
agentregistry.bindings.list
agentregistry.endpoints.*
agentregistry.endpoints.getagentregistry.endpoints.list
agentregistry.locations.*
agentregistry.locations.getagentregistry.locations.list
agentregistry.mcpServers.*
agentregistry.mcpServers.getagentregistry.mcpServers.listagentregistry.
agentregistry.operations.get
agentregistry.operations.list
agentregistry.publishers.*
agentregistry.publishers.getagentregistry.publishers.list
agentregistry.services.get
agentregistry.services.list
agentregistry.skillRevisions.*
agentregistry.agentregistry.agentregistry.agentregistry.
agentregistry.skills.create
agentregistry.skills.delete
agentregistry.skills.get
agentregistry.skills.list
agentregistry.skills.search
agentregistry.skills.update
IAM 권한에 대한 자세한 내용은 적절한 사전 정의된 역할 찾기 및 IAM 역할 및 권한 색인 을 참조하세요.
등록된 리소스에 대한 액세스 제어
에이전트 레지스트리 역할은 레지스트리 자체에서 리소스를 관리하고 검색할 수 있는 사용자를 제어합니다. Agent Gateway 를 통해 등록된 서비스, 엔드포인트, MCP 서버와 통신할 수 있는 에이전트를 제어하려면 IAP (Identity-Aware Proxy) 이그레스 정책을 사용합니다.
IAP 이그레스 정책 구성에 대한 자세한 안내는 IAM 에이전트 정책 구성 을 참조하세요.
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-10-27(UTC)
의견을 전달하고 싶나요?
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-10-27(UTC)"],[],[]]
