Skill Sync 객체 구조

개요

skillSync 객체를 사용하면 관리자가 외부 소스에서 Skills를 미러링할 수 있습니다. v1.3.13 버전에서는 GitHub가 지원되는 제공업체입니다.

GitHub Skill Sync는 구성된 저장소 경로에서 SKILL.md 파일과 해당 번들 파일을 읽어 source: "github"인 Skill로 저장하며, 이후 동기화 시 미러링된 행을 업스트림 저장소와 일치하도록 유지합니다.

예시

skillSync:
  github:
    enabled: true
    intervalMinutes: 60
    runOnStartup: true
    sources:
      - id: librechat-skills
        owner: your-org
        repo: your-skills-repo
        ref: main
        paths:
          - skills
        skillDiscoveryDepth: 2
        token: '${GITHUB_SKILLS_TOKEN}'
        # credentialKey: production-skills
        # tenantId: your-tenant-id

최상위 필드

skillSync.github

기본값:

• enabled: false
• intervalMinutes: 60
• runOnStartup: false
• sources: []

Source Fields

각 github.sources 항목은 하나의 저장소 소스를 구성합니다.

Source Identity

id 필드는 미러 ID의 일부입니다. 이를 안정적으로 유지하세요. 소스를 이름이 변경된 저장소나 새로운 참조(ref)로 다시 지정하면 미러링된 Skill은 동일한 소스 ID에 계속 연결되지만, 소스 ID를 변경하면 새로운 미러가 생성됩니다.

tenantId가 설정되면, 동기화 읽기 및 쓰기는 해당 테넌트의 격리 컨텍스트 내에서 실행됩니다. tenantId는 소스 ID에 대해 불변(immutable)으로 취급해야 합니다. 나중에 이를 변경, 추가 또는 제거하면 이전에 미러링된 Skill이 이전 테넌트에 그대로 남게 됩니다.

동기화 동작

GitHub Skill Sync:

• 각 구성된 경로 아래의 SKILL.md 파일을 검색합니다.
• SKILL.md 본문, frontmatter 및 번들 파일을 가져옵니다.
• source id, owner, repo, ref, skill path, commit SHA, blob SHA와 같은 소스 메타데이터를 저장합니다.
• 업스트림 파일이 변경될 때 미러링된 Skills를 업데이트합니다.
• 구성된 소스에서 제거된 미러링된 Skills 및 파일을 삭제합니다.
• GitHub 동기화가 한 번에 하나씩만 실행되도록 동기화 잠금(sync lock)을 사용합니다.

관리자 엔드포인트 (Admin Endpoints)

관리자 API는 GitHub Skill Sync 상태, 수동 실행 및 저장된 자격 증명 관리를 노출합니다:

상태 읽기에는 관리자 액세스 권한과 Skills 읽기 권한이 필요합니다. 수동 실행 및 자격 증명 쓰기에는 플랫폼 수준의 Skills 관리 권한이 필요합니다.