AI Agents SDK

OpenAI Agents SDK 기반 에이전트 앱을 가장 작은 실행 가능한 형태로 만들고, 실제 경로를 검증한다. 현재 SDK 동작은 공식 문서를 먼저 확인한다.

시작 전

• 대상 레포의 README, 의존성, 진입점, 기존 도구와 eval 구조를 확인한다.
• 에이전트 목표, 입력·출력, 도구, 상태, 승인 경계를 한 문장 또는 짧은 계약으로 정리한다.
• 실행·테스트 전에 OPENAI_API_KEY가 필요한지 확인하고, 키 값을 읽거나 출력하거나 커밋하지 않는다.
• 현재 Agents SDK 문서와 Agent Evals 문서를 확인한다. 관련 OpenAI 문서 스킬이 있으면 사용하고, 없으면 공식 문서를 직접 확인한다.

구현 원칙

• 처음에는 에이전트 하나로 시작한다. 전문가·handoff·다중 에이전트는 실제 요구가 확인된 뒤 추가한다.
• 도구는 결정적이고 범위를 좁게 설계하며 입력 스키마와 부작용을 명확히 한다.
• 파일·셸 접근이 꼭 필요한 경우에만 sandbox를 사용한다.
• 프로젝트의 기존 패키지 매니저와 실행 규칙을 따른다.
• 로컬 smoke 명령, 샘플 입력, 관찰 가능한 기대 결과를 남긴다.
• 배포는 사용자가 명시적으로 요청한 경우에만 진행한다.