에이전트 레지스트리에서 게시자는 등록된 독립형 기술의 권한을 확인하여 게시자 이름의 무단 사용을 방지할 수 있습니다. 각 게시자는 Google 관리 스킬의 경우 cloud.google.com, 수동으로 등록된 스킬의 경우 private-와 같은 스킬 식별자의 확인된 도메인 또는 ID 프리픽스를 설정합니다.
Google은 게시자 생성, 업데이트, 삭제를 관리합니다. 만든 기술은 private- 프리픽스를 사용하는 기본 private 게시자에 자동으로 할당됩니다. 에이전트 레지스트리에서 게시자 세부정보를 나열하고 검사하여 등록된 기술의 소유권을 확인할 수 있습니다.
시작하기 전에
- Agent Registry 설정
단일 프로젝트 설정의 경우 Agent Registry가 사용 설정된 거버넌스 프로젝트의 프로젝트 ID를 가져옵니다. 여러 프로젝트에 관리 경계를 구성한 경우 경계 전체 검색 및 등록에 관리 프로젝트 ID를 사용하거나 단일 프로젝트 작업에 구성원 프로젝트 ID를 지정합니다.
이 문서의 Google Cloud CLI 명령어를 사용하려면 gcloud CLI 환경을 설정합니다.
필요한 역할
에이전트 레지스트리에서 스킬 게시자 세부정보를 검토하는 데 필요한 권한을 얻으려면 관리자에게 에이전트 레지스트리가 사용 설정된 거버넌스 프로젝트에 대한 Agent Registry API 뷰어 (roles/agentregistry.viewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
다른 에이전트 레지스트리 역할에는 스킬 게시자 세부정보를 보는 데 필요한 권한이 포함될 수도 있습니다. 자세한 내용은 에이전트 레지스트리 역할 및 권한을 참조하세요.
게시자 등급
게시자는 인증 수준을 반영하는 등급으로 분류됩니다.
- Google 관리(
FIRST_PARTY): Google에서 관리하는 검증된 게시자(예:cloud.google.com및discoveryengine.googleapis.com)입니다. - 비공개 (
PRIVATE): 프로젝트 내에서 사용자 또는 다른 사용자가 만드는 기술에 자동으로 할당되는 기본private게시자입니다.
게시자 나열
위치에 구성된 모든 게시자를 나열할 수 있습니다.
콘솔
- Google Cloud 콘솔에서 에이전트 레지스트리 페이지로 이동합니다.
- 기술 탭을 선택합니다. 페이지에 모든 등록된 기술 목록이 표시됩니다.
- 등록된 모든 기술의 게시자 열에서 각 기술과 연결된 사용 가능한 모든 확인된 게시자를 탐색할 수 있습니다.
gcloud
위치의 모든 인증된 게시자를 나열하려면 gcloud alpha agent-registry publishers list 명령어를 실행합니다.
gcloud alpha agent-registry publishers list \
--project=PROJECT_ID \
--location=LOCATION
다음을 바꿉니다.
PROJECT_ID: 프로젝트 ID입니다.LOCATION: 레지스트리 위치입니다.
REST
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers"
다음을 바꿉니다.
PROJECT_ID: 프로젝트 ID입니다.LOCATION: 레지스트리 위치입니다.
게시자 세부정보 보기
특정 게시자의 세부정보를 검사할 수 있습니다.
콘솔
- Google Cloud 콘솔에서 에이전트 레지스트리 페이지로 이동합니다.
- 기술 탭을 선택합니다.
- 기술 이름을 클릭하여 세부정보 페이지를 엽니다.
기술 세부정보 섹션에서 기술의 기술 식별자를 찾습니다.
이 기술 식별자 필드를 사용하여 특정 게시자의 저작물을 찾습니다. 예를 들어 Google 관리 스킬의 형식은
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID입니다.
gcloud
특정 게시자의 세부정보를 보려면 gcloud alpha agent-registry publishers describe 명령어를 실행합니다.
gcloud alpha agent-registry publishers describe PUBLISHER_ID \
--project=PROJECT_ID \
--location=LOCATION
다음을 바꿉니다.
PUBLISHER_ID: 검토하려는 게시자의 ID입니다.PROJECT_ID: 프로젝트 ID입니다.LOCATION: 레지스트리 위치입니다.
REST
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/publishers/PUBLISHER_ID"
다음을 바꿉니다.
PROJECT_ID: 프로젝트 ID입니다.LOCATION: 레지스트리 위치입니다.PUBLISHER_ID: 검토하려는 게시자의 ID입니다.
다음 단계
- 독립형 스킬 등록 방법 알아보기