Skill Registry는 에이전트 스킬을 관리하기 위한 안전하고 비공개적이며 지연 시간이 짧은 저장소 역할을 합니다. 각 스킬은 에이전트의 기능을 확장하도록 설계된 구조적 안내, 실행 가능한 코드, 문서를 포함하는 독립된 패키지입니다.
Skill Registry는 이러한 기술을 중앙 집중화하여 에이전트가 사용자 의도에 따라 가장 관련성 높은 기능을 동적으로 검색하고 로드할 수 있도록 지원함으로써 성능을 최적화하고 안전한 실행 환경을 보장합니다.
주요 개념
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자(영문 기준)를 초과합니다.
- 압축된 ZIP 파일의 크기가 10MB를 초과합니다.
기본 제공 스킬
스킬 레지스트리에는 기본 제공 gcp-skill-registry 스킬이 포함되어 있습니다. 이 스킬을 사용하면 에이전트가 Skill Registry와 상호작용하여 사용 가능한 스킬을 만들고, 검색하고, 관리할 수 있으므로 새로운 기능을 등록하거나 기존 기능을 검색할 수 있습니다. Google은 이 기본 제공 기술의 수명 주기, 출시, 버전 관리를 관리하여 즉시 사용 가능한 기능을 보장합니다.