Agent Registry에서 게시자는 에이전트 스킬을 게시하는 인증된
기관을 나타냅니다. 게시자는 스킬이 이름 스쿼팅을 방지하고 신원 확인을 시행하는 데 사용할 수 있는 프리픽스를 지정합니다. 예를 들어 google- 프리픽스는 인증된 Google 스킬을 위해 예약되어 있습니다.
이 문서에서는 등록된 스킬의 인증된 게시자 세부정보를 검토하고 검사하는 방법을 설명합니다.
게시자를 만들거나 업데이트하거나 삭제하고 인증된 프리픽스 할당을 관리하는 것은 Google 내부 관리자로 제한됩니다. 사용자 또는 다른 사용자가 만든 스킬은 기본 private
게시자에 자동으로 할당되므로 특정 스킬의 게시된 ID에는
private-가 프리픽스로 지정됩니다. 커스텀 게시자 리소스는 등록할 수 없습니다.
시작하기 전에
시작하기 전에 Agent Registry를 설정하고 독립형 스킬을 등록하세요. 이러한 작업을 수행하려면 프로젝트 ID가 필요합니다.
이 문서에서 Google Cloud CLI 명령어를 사용하려면 gcloud CLI 환경을 설정해야 합니다.
필요한 역할
Agent Registry에서 스킬 게시자 세부정보를 검토하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Agent Registry 사용자 (roles/agentregistry.user) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
게시자 계층
게시자는 인증 수준을 반영하는 계층으로 분류됩니다.
- 퍼스트 파티 (
FIRST_PARTY): 인증된 Google에서 큐레이팅한 글로벌 게시자입니다. 예를 들어publishers/cloud.google.com및publishers/discoveryengine.googleapis.com입니다. - 비공개 (
PRIVATE): 프로젝트 내에서 사용자 또는 다른 사용자가 만든 스킬에 자동으로 할당되는 기본private게시자입니다.
게시자 나열
위치에 구성된 모든 게시자를 나열할 수 있습니다.
콘솔
- Google Cloud 콘솔에서 Agent Registry 페이지로 이동합니다.
- 스킬 탭을 선택합니다. 페이지에 등록된 모든 등록된 스킬 목록이 표시됩니다.
- 등록된 모든 스킬의 게시자 열에서 각 스킬과 연결된 사용 가능한 모든 인증된 게시자를 찾아볼 수 있습니다.
gcloud
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 콘솔에서 Agent Registry 페이지로 이동합니다.
- 스킬 탭을 선택합니다.
- 스킬 이름을 클릭하여 세부정보 페이지를 엽니다.
스킬 세부정보 섹션에서 스킬의 URN (Uniform Resource Name)을 찾습니다.
이 스킬 URN 필드를 사용하여 특정 게시자의 애셋을 찾습니다. 예를 들어 Google에서 만든 스킬의 형식은
urn:skill:PUBLISHER_ID:NAMESPACE:SKILL_ID
gcloud
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입니다.
다음 단계
- 독립형 스킬을 등록하는 방법을 알아보세요.