스킬 레지스트리는 에이전트 스킬을 관리하기 위한 안전하고 비공개이며 지연 시간이 짧은 저장소 역할을 합니다. 각 스킬은 에이전트의 기능을 확장하도록 설계된 구조적 안내, 실행 가능한 코드, 문서를 포함하는 독립형 패키지입니다.
이러한 기술을 중앙 집중화함으로써 스킬 레지스트리는 상담사가 사용자 의도에 따라 가장 관련성 높은 기능을 동적으로 검색하고 로드할 수 있도록 지원하여 성능을 최적화하고 안전한 실행 환경을 보장합니다.
주요 개념
Skill Registry는 수명 주기와 버전 관리를 위해 두 가지 최상위 표준 API 엔티티를 도입합니다.
| 개념 | 설명 |
|---|---|
| 스킬 |
메타데이터 (예: 표시 이름, 생성 및 업데이트 타임스탬프, 라벨), 기본 버전, 스킬의 콘텐츠를 포함하는 변경 가능한 최상위 수준 항목입니다.
예상되는 스킬 구조의 예는 Google Cloud Skills 저장소의 SKILL.md 파일을 참고하세요.
|
| 스킬 버전 | 특정 스킬 버전의 변경 불가능한 스냅샷입니다. 여기에는 이름, 설명, 변경할 수 없는 상위 스킬 리소스 참조가 포함됩니다. |
스킬 페이로드 유효성 검사
상담사가 유효한 스킬 콘텐츠를 사용할 수 있도록 시스템은 생성 또는 업데이트 중에 모든 스킬 페이로드를 자동으로 확인합니다. 이러한 유효성 검사는 비동기적으로 실행됩니다.
시스템에서 다음 중 하나를 감지하면 비동기 작업이 유효성 검사 오류와 함께 실패합니다.
- 파일이 적절한 zip 파일이 아니거나 핵심 정보가 누락되었습니다.
- ZIP 파일이 비어 있습니다.
- ZIP 파일에 10,000개가 넘는 항목이 있습니다.
- ZIP의 파일 또는 폴더 이름에
..가 포함되어 있거나/또는\\로 시작합니다. - ZIP 파일에 심볼릭 링크가 포함되어 있습니다.
- ZIP 파일에 중복된 파일 또는 폴더 이름이 있습니다.
- ZIP 파일 내 모든 파일의 총 크기가 압축 해제 시 500MB를 초과합니다.
- 파일이 너무 많이 압축되어 압축률이 100을 초과합니다.
- ZIP 내부의 폴더가 8개 수준을 초과합니다.
- ZIP 파일에
SKILL.md파일이 포함되어 있지 않습니다. SKILL.md파일에 다음과 같은 문제가 있습니다.SKILL.md파일에 필수 YAML 전문 또는 예상되는 마크다운 콘텐츠가 없습니다.- YAML 프런트 매터의 이름 필드가 누락되었거나, 64자를 초과하거나, 하이픈으로 시작하거나 끝나거나, 소문자, 숫자, 하이픈 이외의 문자가 포함되어 있습니다.
- YAML 프런트 매터의 설명 필드가 누락되었거나 1,024자를 초과합니다.
- YAML 프런트 매터의 라이선스 필드가 1,024자를 초과합니다.
SKILL.md파일의 요청 사항이 500,000자를 초과합니다.
- 압축된 보관 파일의 크기가 10MB를 초과합니다.
기본 제공 스킬
스킬 레지스트리에는 기본 제공 gcp-skill-registry 스킬이 포함되어 있습니다. 이 스킬을 통해 에이전트는 스킬 레지스트리와 상호작용하여 사용 가능한 스킬을 만들고, 검색하고, 관리할 수 있으므로 새로운 기능을 등록하거나 기존 기능을 검색할 수 있습니다. Google은 이 기본 제공 스킬의 수명 주기, 출시, 버전 관리를 관리하여 즉시 사용 가능한 기능을 보장합니다.