Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

스킬 관리

에이전트 레지스트리를 사용하면 독립형 기술을 검사, 업데이트, 제어하여 에이전트가 사용할 수 있는 기술 버전과 수명 주기 상태를 제어할 수 있습니다. 독립형 스킬을 등록한 후에는 세부정보를 보거나, 설명 또는 기본 버전을 업데이트하거나, 수명 주기 상태를 전환하거나, 에이전트 레지스트리에서 삭제할 수 있습니다. 에이전트 레지스트리를 설정하는 즉시 사용할 수 있는 Google 관리 스킬을 나열하고 볼 수도 있습니다.

시작하기 전에

Agent Registry 설정
Agent Registry가 사용 설정된 거버넌스 프로젝트의 프로젝트 ID를 가져옵니다.
독립형 스킬을 등록합니다.
이 문서의 Google Cloud CLI 명령어를 사용하려면 gcloud CLI 환경을 설정합니다.

필요한 역할

에이전트 레지스트리에서 기술을 관리하는 데 필요한 권한을 얻으려면 관리자에게 에이전트 레지스트리가 사용 설정된 거버넌스 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

스킬 나열 및 보기: Agent Registry API 뷰어 (roles/agentregistry.viewer)
스킬 업데이트, 수명 주기 상태 전환, 삭제: Agent Registry 사용자 (roles/agentregistry.user)
스킬 및 기타 Agent Registry 리소스 관리: Agent Registry API 편집자 (roles/agentregistry.editor)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

다른 Agent Registry 역할에도 기술을 보고, 업데이트하고, 삭제하는 데 필요한 권한이 포함될 수 있습니다. 자세한 내용은 에이전트 레지스트리 역할 및 권한을 참조하세요.

스킬 나열 및 보기

등록된 모든 스킬을 둘러보거나 특정 기능을 검색할 수 있습니다.

콘솔

Google Cloud 콘솔에서 에이전트 레지스트리 페이지로 이동합니다.
에이전트 레지스트리로 이동
기술 탭을 선택합니다.
기술 목록을 검토합니다. 위치 또는 상태 메뉴를 사용하여 표시를 필터링할 수 있습니다.
스킬 이름을 클릭하여 스킬 세부정보 페이지를 엽니다. 이 페이지에는 이름, 설명, 활성 버전, 스킬 식별자, 최종 업데이트, 커스텀 메타데이터, 업데이트 기록이 표시됩니다.

gcloud

위치의 모든 기술을 나열하려면 gcloud alpha agent-registry skills list 명령어를 사용합니다.

gcloud alpha agent-registry skills list \
    --project=PROJECT_ID \
    --location=LOCATION

특정 기술의 세부정보를 보려면 gcloud alpha agent-registry skills describe 명령어를 사용합니다.

gcloud alpha agent-registry skills describe SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

다음을 바꿉니다.

SKILL_ID: 검토하려는 기술의 ID입니다. 수동으로 등록된 기술의 경우 private- 프리픽스(예: private-my-skill)를 포함합니다.
PROJECT_ID: 프로젝트 ID입니다.
LOCATION: 레지스트리 위치입니다.

REST

모든 기술 목록을 검색하려면 GET 요청을 전송합니다.

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills"

단일 기술 컨테이너를 가져오려면 GET 요청을 전송합니다.

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID"

다음을 바꿉니다.

PROJECT_ID: 프로젝트 ID입니다.
LOCATION: 레지스트리 위치입니다.
SKILL_ID: 검토하려는 기술의 ID입니다. 수동으로 등록된 기술의 경우 private- 프리픽스(예: private-my-skill)를 포함합니다.

스킬 메타데이터 또는 기본 버전 업데이트

스킬의 표시 이름, 설명을 수정하거나 기본 버전 포인터를 수동으로 변경하여 다른 버전을 배포할 수 있습니다. 새 스킬 버전을 만들려면 스킬 버전 관리를 참조하세요.

스킬 메타데이터 또는 특정 스킬의 기본 버전을 업데이트하려면 다음 단계를 따르세요.

콘솔

Google Cloud 콘솔에서 에이전트 레지스트리 페이지로 이동합니다.
에이전트 레지스트리로 이동
기술 탭을 선택합니다.
기술 목록을 검토합니다. 위치 또는 상태 메뉴를 사용하여 표시를 필터링할 수 있습니다.
스킬 이름을 클릭하여 스킬 세부정보 페이지를 엽니다. 이 페이지에는 이름, 설명, 활성 버전, 스킬 식별자, 최종 업데이트, 커스텀 메타데이터, 업데이트 기록이 표시됩니다.
다음 옵션 중에서 선택합니다.
- 스킬 메타데이터 업데이트:
  1. 수정을 클릭합니다.
  2. 기술 수정 패널에서 기술의 표시 이름 또는 설명을 업데이트합니다.
  3. 저장을 클릭합니다.
- 기본 버전 업데이트:
  1. 버전 기록 표를 찾습니다.
  2. 활성으로 설정할 버전을 찾습니다.
  3. 작업 열에서 버전 활성화를 클릭합니다.

gcloud

기술의 메타데이터를 업데이트하려면 gcloud alpha agent-registry skills update 명령어를 사용합니다.

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

스킬의 기본 서빙 버전을 업데이트하려면 gcloud alpha agent-registry skills update 명령어를 사용하고 대상 버전의 리소스 이름을 지정합니다.

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --default-revision="projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"

다음을 바꿉니다.

SKILL_ID: 업데이트할 기술의 ID입니다. 수동으로 등록된 기술의 경우 private- 프리픽스(예: private-my-skill)를 포함합니다.
PROJECT_ID: 프로젝트 ID입니다.
LOCATION: 레지스트리 위치입니다.
DISPLAY_NAME: 업데이트된 표시 이름입니다.
DESCRIPTION: 업데이트된 설명입니다.
REVISION_ID: 기본값으로 설정할 기술 버전의 ID입니다.

REST

업데이트할 필드를 지정하는 PATCH 요청을 보냅니다.

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
        "displayName": "DISPLAY_NAME",
        "description": "DESCRIPTION",
        "defaultRevision": "projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID/revisions/REVISION_ID"
      }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=displayName,description,defaultRevision"

다음을 바꿉니다.

DISPLAY_NAME: 기술의 업데이트된 표시 이름입니다.
DESCRIPTION: 기술에 대한 업데이트된 설명입니다.
PROJECT_ID: 프로젝트 ID입니다.
LOCATION: 레지스트리 위치입니다.
SKILL_ID: 업데이트할 기술의 ID입니다. 수동으로 등록된 기술의 경우 private- 프리픽스(예: private-my-skill)를 포함합니다.
REVISION_ID: 활성화하려는 기술 버전의 ID입니다.

기술 수명 주기 상태 관리

런타임 시 스킬이 확인되는 방식을 제어하려면 스킬의 타겟 상태를 변경하면 됩니다.

활성: 기술이 제공되고 완전히 해결 가능합니다. 기술을 활성으로 설정하려면 defaultRevision 필드가 활성 기술 버전을 가리켜야 합니다.
사용 중지됨: 기술이 생성될 때의 기본 초기 상태입니다. 스킬은 런타임에 제공되지 않고 스킬 확인이 즉시 실패하며 페이로드 다운로드가 차단됩니다. defaultRevision 포인터가 삭제되거나 기본 버전이 삭제된 경우에도 기술이 사용 중지됨 상태로 전환됩니다. 사용 중지됨 상태와 달리 유효한 defaultRevision를 설정하고 대상 상태를 활성으로 업데이트하여 사용 중지된 기술을 사용 설정할 수 있습니다.
지원 중단됨: 스킬을 계속 로드하고 다운로드할 수 있지만 사용 중지될 예정임을 나타냅니다.
사용 중지됨: 기술이 영구적으로 비활성화되고 더 이상 제공되지 않으며 활성 또는 다른 상태로 되돌릴 수 없습니다. 기술은 이미 지원 중단된 후에만 사용 중지할 수 있습니다. 기술을 사용 중단하기 전에 마이그레이션할 수 있는 충분한 시간을 제공합니다. 이 상태는 최종 상태이므로 주의해서 사용하세요.

기술의 수명 주기 상태를 전환하려면 다음 안내를 따르세요.

콘솔

Google Cloud 콘솔에서 에이전트 레지스트리 페이지로 이동합니다.
에이전트 레지스트리로 이동
기술 탭을 선택합니다.
기술 목록을 검토합니다. 위치 또는 상태 메뉴를 사용하여 표시를 필터링할 수 있습니다.
스킬 이름을 클릭하여 스킬 세부정보 페이지를 엽니다. 이 페이지에는 이름, 설명, 활성 버전, 스킬 식별자, 최종 업데이트, 커스텀 메타데이터, 업데이트 기록이 표시됩니다.
상태 제어 버튼을 사용하여 타겟 상태를 전환합니다. 페이지에 표시되는 버튼은 기술의 현재 상태에 따라 달라집니다(예: 사용 설정, 사용 중지, 지원 중단, 사용 중단).

gcloud

gcloud alpha agent-registry skills update 명령어와 --target-state 플래그를 사용하여 기술 컨테이너를 업데이트합니다.

gcloud alpha agent-registry skills update SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --target-state=DISABLED

다음을 바꿉니다.

SKILL_ID: 업데이트할 기술의 ID입니다. 수동으로 등록된 기술의 경우 private- 프리픽스(예: private-my-skill)를 포함합니다.
PROJECT_ID: 프로젝트 ID입니다.
LOCATION: 레지스트리 위치입니다.

대상 상태에 허용되는 값은 다음과 같습니다.

ACTIVE
DISABLED
DEPRECATED
DECOMMISSIONED

REST

본문과 업데이트 마스크에 targetState를 지정하는 PATCH 요청을 보냅니다.

curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "targetState": "TARGET_STATE_DISABLED"
    }' \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?updateMask=targetState"

다음을 바꿉니다.

PROJECT_ID: 프로젝트 ID입니다.
LOCATION: 레지스트리 위치입니다.
SKILL_ID: 업데이트할 기술의 ID입니다. 수동으로 등록된 기술의 경우 private- 프리픽스(예: private-my-skill)를 포함합니다.

대상 상태에 허용되는 값은 다음과 같습니다.

TARGET_STATE_ACTIVE
TARGET_STATE_DISABLED
TARGET_STATE_DEPRECATED
TARGET_STATE_DECOMMISSIONED

스킬 삭제하기

스킬 컨테이너를 삭제하면 Skill 리소스와 연결된 모든 변경 불가능한 SkillRevision 리소스가 영구적으로 삭제됩니다. 삭제된 스킬 식별자를 확인하려고 시도하는 에이전트는 런타임에 실패합니다.

콘솔

Google Cloud 콘솔에서 에이전트 레지스트리 페이지로 이동합니다.
에이전트 레지스트리로 이동
기술 탭을 선택합니다.
기술 목록을 검토합니다. 위치 또는 상태 메뉴를 사용하여 표시를 필터링할 수 있습니다.
삭제하려는 기술의 이름을 클릭합니다.
기술 세부정보 페이지에서 삭제를 클릭합니다.
확인 대화상자에서 DELETE을 입력하고 삭제를 클릭합니다.

gcloud

기술을 삭제하려면 gcloud alpha agent-registry skills delete 명령어를 사용합니다.

gcloud alpha agent-registry skills delete SKILL_ID \
    --project=PROJECT_ID \
    --location=LOCATION

다음을 바꿉니다.

SKILL_ID: 삭제하려는 기술의 ID입니다. 수동으로 등록된 기술의 경우 private- 프리픽스(예: private-my-skill)를 포함합니다.
PROJECT_ID: 프로젝트 ID입니다.
LOCATION: 레지스트리 위치입니다.

REST

기술을 삭제하려면 DELETE 요청을 보냅니다.

curl -X DELETE \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://agentregistry.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/skills/SKILL_ID?force=true"

다음을 바꿉니다.

PROJECT_ID: 프로젝트 ID입니다.
LOCATION: 레지스트리 위치입니다.
SKILL_ID: 삭제하려는 기술의 ID입니다. 수동으로 등록된 기술의 경우 private- 프리픽스(예: private-my-skill)를 포함합니다.

다음 단계

새 버전을 업로드하고 패키지를 다운로드하는 방법을 알아보세요.
기술 관리를 위한 역할 및 권한을 이해합니다.

스킬 관리 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

시작하기 전에

필요한 역할

스킬 나열 및 보기

콘솔

gcloud

REST

스킬 메타데이터 또는 기본 버전 업데이트

콘솔

gcloud

REST

기술 수명 주기 상태 관리

콘솔

gcloud

REST

스킬 삭제하기

콘솔

gcloud

REST

다음 단계

스킬 관리