Community코딩 & 개발github.com

KewalPra/agent-sdk

⚙️ 에이전트 개발을 간소화하는 직관적인 for-loop 프레임워크로, 애플리케이션에서 효율적인 툴 호출을 가능하게 합니다.

agent-sdk란 무엇인가요?

KewalPra/agent-sdk는 AI 에이전트 구축을 단순화하는 오픈소스 프레임워크입니다. 기존의 복잡한 에이전트 프레임워크와 달리, 직관적인 for-loop 패턴을 사용하여 여러 툴 호출을 순차적으로 쉽게 관리할 수 있습니다. 주로 Claude Code나 Cursor와 같은 터미널 기반 AI 도구와 통합되어 개발자가 복잡한 상태 관리 없이도 에이전트 로직을 빠르게 프로토타이핑하고 실행할 수 있도록 돕습니다. 이 SDK는 Python 환경에서 동작하며, 간단한 API를 통해 툴 등록과 호출을 처리하므로 초보자부터 전문가까지 쉽게 사용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add KewalPra/agent-sdk

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

agent-sdk은(는) 무엇을 하나요?

⚙️ 에이전트 개발을 간소화하는 직관적인 for-loop 프레임워크로, 애플리케이션에서 효율적인 툴 호출을 가능하게 합니다.

개요

KewalPra/agent-sdk는 AI 에이전트 구축을 위한 경량 프레임워크입니다. 복잡한 의존성이나 상태 관리 없이, 간단한 루프 구조를 사용하여 여러 툴을 순차적으로 호출하고 결과를 처리할 수 있습니다.

주요 특징

  • 직관적인 for-loop 구조: 복잡한 콜백이나 상태 머신 없이도 툴 호출 로직을 쉽게 작성할 수 있습니다.
  • 플랫폼 독립적: Claude Code, Cursor, Codex 등 다양한 AI 에이전트 환경과 호환됩니다.
  • 경량화: 최소한의 의존성으로 빠르게 설치하고 실행할 수 있습니다.

설치 방법

pip install agent-sdk

또는 소스에서 직접 설치:

git clone https://github.com/KewalPra/agent-sdk.git
cd agent-sdk
pip install -r requirements.txt

사용 예시

from agent_sdk import Agent

# 에이전트 인스턴스 생성
agent = Agent()

# 툴 등록
@agent.tool
def search_web(query: str) -> str:
    """웹 검색을 수행합니다."""
    return f"'{query}'에 대한 검색 결과"

@agent.tool
def calculate(expression: str) -> float:
    """수학 표현식을 계산합니다."""
    return eval(expression)

# for-loop으로 툴 호출 실행
for step in agent.run("오늘 날씨는?"):
    print(step)

환경 변수

  • OPENAI_API_KEY: OpenAI API 키 (선택 사항)
  • AGENT_LOG_LEVEL: 로깅 레벨 설정 (기본값: INFO)

라이선스

MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

기여하기

버그 제보 및 기능 요청은 GitHub 이슈를 통해 해주세요.

관련 자료

관련 스킬