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