Volcengine Agent Development Kit (VeADK)

정의

• Volcengine의 대규모 언어 모델 플랫폼(ARK)에서 실행되는 AI 에이전트를 구축하기 위한 Python 라이브러리입니다. 경량 런타임, 도구 통합 헬퍼, 선택적 웹 UI/Studio 구성 요소를 번들로 제공합니다.

주요 기능

• 에이전트 추상화 – veadk.Agent는 언어 모델(예: Volcengine에서 호스팅되는 OpenAI 호환 모델)을 래핑하고 간단한 run(prompt) 비동기 API를 제공합니다.
• 도구 확장 – Feishu 봇 채널, 데이터베이스 기반 단기 메모리, 평가 도구, CLI에 대한 기본 지원.
• AgentKit 통합 – 한 줄 팩토리(create_agentkit_app)가 상태 확인, 메타데이터, Studio 호환 엔드포인트(동적 도구, 웹 검색, 지식 베이스, 장기 메모리 등)를 노출하는 FastAPI 앱을 생성합니다.
• YAML 기반 구성 – 프로젝트 루트의 config.yaml에서 모델 제공자, API 엔드포인트, 자격 증명, 선택적 도구 설정을 지정할 수 있습니다.
• 개발자 리소스 – Jupyter 튜토리얼, Google-Colab 링크, 포괄적인 문서.

시작하기

# PyPI에서 설치 (핵심 + 선택적 확장)
pip install veadk-python[extensions]

from veadk import Agent
import asyncio

agent = Agent()  # config.yaml 자동 읽기
result = asyncio.run(agent.run("hello!"))
print(result)

일반적인 워크플로우

1. Volcengine ARK API 키와 모델 이름이 포함된 config.yaml을 생성합니다.
2. 코드에서 Agent(또는 명명된 하위 에이전트)를 인스턴스화합니다.
3. 선택적으로 create_agentkit_app으로 래핑하여 Studio가 관리할 수 있는 FastAPI 서버(메타데이터, 도구 라우팅, 피드백 수집)를 노출합니다.
4. 서버를 배포하거나 로컬에서 실행합니다. 제공된 Feishu 채널 확장을 사용하여 에이전트를 Feishu 봇에 연결합니다.

확장성

• 데이터베이스 확장 – uv sync --extra database로 영구 단기 메모리를 추가합니다.
• 평가 확장 – 피드백을 위한 평가 세트 처리를 추가합니다.
• CLI 확장 – 에이전트 실행 및 세션 관리를 위한 명령줄 유틸리티를 제공합니다.

커뮤니티 및 지원

• Apache 2.0 라이선스로 오픈소스.
• 문서 사이트: https://volcengine.github.io/veadk-python/
• 실시간 도움을 위한 토론 그룹(리포지토리의 QR 코드).
• 보안 정책 및 CI 테스트가 적용됩니다. 기여는 pytest 통과가 필요합니다.

사용 대상

• Volcengine 인프라에서 LLM 기반 에이전트를 빠르게 프로토타입하거나 출시하려는 개발자.
• 보일러플레이트 네트워킹 코드를 작성하지 않고 내장 통합(Feishu, 지식 베이스, 메모리 저장소)이 필요한 팀.
• Studio UI와 일치하는 Python SDK를 원하는 Volcengine AgentKit 플랫폼 사용자.