pydantic/pydantic-ai-harness

해결하는 문제

Pydantic AI Harness는 단순한 AI 에이전트를 고도화되고 장기간 실행 가능한 자율 에이전트로 전환할 수 있는 포괄적인 '기능' 라이브러리를 제공합니다. 코드베이스 유지보수, 심층 웹 조사, 세션 간 메모리 관리와 같은 복잡한 작업을 수행하기 위한 필요한 환경이 부족하거나, 시간이 지남에 따라 에이전트의 성능이 저하되는 문제를 해결합니다.

작동 방식

이 라이브러리는 '기능'이라는 기본 개념을 기반으로 작동합니다. 기능은 capabilities=[...] 인수를 통해 어떤 Pydantic AI 에이전트에도 추가할 수 있는 자가 포함된 에이전트 행동 단위입니다. 이러한 기능들은 모듈식이며 조합 가능하여, 파일 시스템이나 쉘과 같은 개별 블록을 쉽게 추가하거나, Coder 또는 Researcher 스택과 같은 사전 구축된 '하네스'를 사용할 수 있습니다. 이 하네스는 여러 기능의 조합으로 구성되어 있습니다.

대상 사용자

Pydantic AI로 자율 에이전트를 개발하고, 지속 가능한 메모리, 안전한 실행 환경, 계획 능력, 고급 컨텍스트 관리를 갖춘 에이전트를 필요로 하는 개발자들.

주요 특징

• 사전 구축된 에이전트 스택: 코딩 에이전트(Coder) 및 조사 에이전트(Researcher)용 완전한 구성이 포함되어 있습니다.
• 실행 환경: 허용 목록 기반의 쉘 실행, 보안 파일 시스템 접근, Modal을 통한 격리된 클라우드 샌드박스를 제공합니다.
• 컨텍스트 관리: 도구 결과 정리, 슬라이딩 윈도우 트리밍, 도구 출력 제한 기능을 통해 컨텍스트 창의 과도한 확장 방지.
• 추론 및 위임: 구조화된 작업 계획, 하위 에이전트 위임, 모델이 다른 에이전트를 오케스트레이션하는 동적 워크플로우를 지원합니다.
• 지식 및 기억: 지속 가능한 네임스페이스 기반 노트북, 대화 기록에 대한 BM25 검색, 필요 시 스킬 지침 로딩을 구현합니다.
• 안전성 및 제어: 입력/출력 검증, 프롬프트 인젝션 방어, 토큰/USD 예산에 대한 사용 제한 등의 가드레일을 포함합니다.