DougTrajano/pydantic-ai-skills

해결하는 문제

AI 에이전트가 프롬프트의 부피 증가 없이 기능을 확장할 수 있도록 합니다. "진행적 공개"를 통해 에이전트는 사용 가능한 기술의 고수준 카탈로그(이름과 설명)만을 보고, 특정 작업이 필요할 때에만 전체 지침, 참조 문서, 또는 실행 가능한 스크립트를 로드합니다.

작동 방식

이 프로젝트는 모듈화된 패키지로 구성된 "에이전트 기술"을 관리하는 시스템을 구현합니다. 각 패키지는 SKILL.md 파일(지침 포함)과 선택적 스크립트 및 리소스를 포함합니다. pydantic-ai-harness를 확장하여 다음 기능을 추가합니다:

• 원격 레지스트리: Git 리포지토리 또는 S3 버킷에서 기술을 가져올 수 있는 기능.
• 패키지 파일 실행: read_skill_resource 및 run_skill_script 도구를 통해 에이전트가 기술과 연결된 문서를 읽거나 스크립트를 실행할 수 있습니다.
• 사전 보호: 신뢰할 수 없는 스크립트를 컨테이너나 가상 파일 시스템에서 실행하여 호스트 머신을 보호하는 기능.
• 프로그래밍 방식 정의: 데코레이터나 데이터클래스를 사용해 Python 코드 내에서 기술을 직접 정의할 수 있는 기능.

대상 사용자

Pydantic AI로 에이전트를 개발하고 있으며, 전문적인 작업 라이브러리를 대규모로 관리하고, 외부 기술 레지스트리(예: Anthropic의 기술 레지스트리)를 통합하면서도 보안과 프롬프트 효율성을 유지하고자 하는 개발자.

주요 특징

• 진행적 공개: 필요할 때만 세부 지침을 로드하여 프롬프트 오버플로우를 방지합니다.
• 원격 소스: Git 및 S3 레지스트리 지원과 필터링 및 병합 기능을 제공합니다.
• 안전한 실행: 패키지된 기술 스크립트 실행을 위한 사전 보호 옵션 포함.
• 동적 해결: 기술 파일 내의 ${SKILL_DIR} 경로 플레이스홀더를 자동으로 처리합니다.