DougTrajano/pydantic-ai-skills

This package implements Agent Skills (https://agentskills.io) support with progressive disclosure for Pydantic AI. Supports filesystem and programmatic skills.

해결하고자 하는 문제

이 프로젝트는 Pydantic AI 프레임워크로 구축된 AI 에이전트를 위한 "Agent Skills"를 구축하고 관리하는 표준화된 방법을 제공합니다. 개발자는 모듈식 도메인별 기능(명령, 스크립트, 리소스)을 만들 수 있으며, 에이전트는 이를 동적으로 발견하고 로드할 수 있어 모든 가능한 명령을 하나의 시스템 프롬프트에 넣어야 하는 상황을 방지합니다.

작동 방식

프레임워크는 Agent Skills 오픈 사양을 구현합니다. 스킬은 파일 시스템상의 디렉터리(Markdown 파일 및 스크립트 포함)로 정의하거나 Python 코드로 프로그래밍 방식 정의할 수 있습니다.

Pydantic AI 에이전트에 통합될 때, 프레임워크는 "점진적 공개"를 위한 툴 호출 방식을 사용합니다. 에이전트는 먼저 사용 가능한 스킬의 고수준 목록을 받고, 필요에 따라 특정 툴을 사용해 관련 스킬의 전체 명령을 로드하거나 리소스를 읽거나 스크립트를 실행합니다.

대상

Pydantic AI를 사용해 복잡한 AI 에이전트를 구축하는 개발자로, 모델의 컨텍스트 윈도우를 소진하지 않으면서 방대한 전문 툴 및 명령 라이브러리를 관리해야 하는 경우.

주요 특징

점진적 공개: 에이전트가 관련성을 판단했을 때만 상세 스킬 정보를 로드해 토큰 사용량을 줄입니다.
사양 호환성: Anthropic이 유지하는 Agent Skills 오픈 포맷과 완전 호환됩니다.
유연한 정의: 파일 시스템 기반 스킬(Markdown/스크립트)과 프로그래밍 방식 Python 정의를 모두 지원합니다.
타입 안전: Python 데이터 클래스와 타입 힌트를 활용해 스킬 메타데이터와 구조를 검증합니다.
보안: 경로 탐색 방지와 안전한 스크립트 실행을 내장하고 있습니다.