Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.
의견 보내기
역할 및 권한
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에는 Agent Registry의 IAM 역할과 권한이 나와 있습니다.
레지스트리에서 에이전트, MCP 서버, 도구, 독립형 스킬, 엔드포인트, 바인딩을 관리하거나 보는 사용자 또는 그룹에 적절한 에이전트 레지스트리 IAM 역할을 부여합니다. 역할을 부여하려면 Google Cloud 콘솔의 IAM 페이지 또는 Google Cloud CLI를 사용하면 됩니다. 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리 를 참고하세요.
Agent Registry 역할
다음 표에서는 Agent Registry IAM 역할과 일반적인 책임을 설명합니다.
주의: 레지스트리를 관리할 권한이 필요한 신뢰할 수 있는 관리자에게만 에이전트 레지스트리 API 관리자 (roles/agentregistry.admin) 또는 에이전트 레지스트리 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 스킬, 독립형 스킬, 스킬 버전, 게시자, 엔드포인트, 바인딩을 볼 수 있습니다.
Agent Registry 사용자 (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 Registry 역할은 레지스트리 자체에서 리소스를 관리하고 검색할 수 있는 사용자를 관리합니다. Agent Gateway 를 통해 등록된 서비스, 엔드포인트, MCP 서버와 통신할 수 있는 에이전트를 제어하려면 Identity-Aware Proxy 이그레스 정책을 사용합니다.
IAP 이그레스 정책 구성에 관한 자세한 안내는 IAM 에이전트 정책 구성 을 참고하세요.
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-10-11(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-11(UTC)"],[],[]]
