AgentPool
PyPI License
Package status
Monthly downloads
Python version
Github Stars
YAML을 통해 이종(heterogeneous) AI 에이전트를 구성하고 관리하며 표준화된 프로토콜로 노출할 수 있는 통합 에이전트 오케스트레이션 허브입니다.
Documentation
문제점 (The Problem)
여러 AI 에이전트를 함께 사용하고 싶을 때가 있습니다. 예를 들어, 리팩토링을 위한 Claude Code, 고급 추론 기능을 갖춘 코드 편집을 위한 Codex, 사용자 정의 분석 에이전트, 또는 특정 작업을 위한 Goose 등이 필요할 수 있습니다. 하지만 이들 각각은 서로 다른 API, 프로토콜, 통합 패턴을 가지고 있습니다. 이들을 조정하려면 각 조합에 맞는 '접착 코드(glue code)'를 작성해야 합니다.
해결책 (The Solution)
AgentPool은 프로토콜 브릿지(protocol bridge) 역할을 수행합니다. 사용자가 정의하는 모든 에이전트(네이티브 PydanticAI 기반, 직접 통합(Claude Code, Codex), 외부 ACP 에이전트(Goose), 또는 AG-UI 에이전트 등)를 단일 YAML 파일에 정의할 수 있습니다. 그런 다음 이들을 모두 ACP 또는 AG-UI 프로토콜을 통해 노출하여, 에이전트들이 통일된 인터페이스를 통해 협력하고, 작업을 위임하며, 통신하도록 합니다.
flowchart TB
subgraph AgentPool
subgraph config[YAML Configuration]
...
빠른 시작 (Quick Start)
uv tool install agentpool
최소 구성 (Minimal Configuration)
agentpool run assistant "Hello!"
...
외부 에이전트 통합 (Integrating External Agents)
진정한 강력함은 다양한 유형의 에이전트를 혼합할 때 발생합니다:
이제 coordinator는 이들 중 어떤 에이전트에게든 작업을 위임할 수 있으며, 모든 에이전트는 동일한 인터페이스를 통해 접근 가능합니다.
주요 기능 (Key Features)
다중 에이전트 조정 (Multi-Agent Coordination)
에이전트들은 팀(병렬/parallel)을 구성하거나 체인(순차/sequential)을 구성할 수 있습니다:
teams:
review_pipeline:
mode: sequential
...
async with AgentPool("agents.yml") as pool:
# 병렬 실행
team = pool.get_agent("analyzer") & pool.get_agent("reviewer")
...
풍부한 YAML 구성 (Rich YAML Configuration)
모델, 도구, 연결, 트리거, 저장소 등 모든 것이 구성 가능합니다:
agents:
analyzer:
type: native
...
서버 프로토콜 (Server Protocols)
AgentPool은 여러 서버 프로토콜을 통해 에이전트를 노출할 수 있습니다:
| 서버 | 명령어 | 사용 사례 |
|---|
| ACP | agentpool serve-acp | IDE 통합 (Zed, Toad) - 도구 확인에 대한 양방향 통신 |
| ... | | |
ACP 서버는 IDE 통합에 이상적입니다. 실시간 도구 확인 및 세션 관리를 제공합니다. OpenCode 서버는 OpenCode TUI가 원격 환경(Docker, SSH, 클라우드 샌드박스)에서 작동하는 에이전트를 포함하여 AgentPool 에이전트를 제어할 수 있도록 합니다.
추가 기능 (Additional Capabilities)
- 구조화된 출력: 인라인으로 응답 스키마를 정의하거나 Python 타입을 가져올 수 있습니다.
- 저장소 및 분석: 구성 가능한 제공업체와 모든 상호 작용을 추적합니다.
- 파일 추상화: UPath 기반 작업은 로컬 및 원격 소스에서 작동합니다.
- 트리거: 파일 변경, 웹훅 또는 사용자 지정 이벤트에 반응합니다.
- 스트리밍 TTS: 모든 에이전트를 위한 음성 출력 지원
사용 패턴 (Usage Patterns)
CLI (명령줄 인터페이스)
agentpool run agent_name "프롬프트"
agentpool serve-acp config.yml
agentpool serve-opencode config.yml
...
프로그래밍 방식 (Programmatic)
from agentpool import AgentPool
async with AgentPool("agents.yml") as pool:
...
문서화 (Documentation)
고급 구성, 연결 패턴 및 API 참조를 포함한 전체 문서는 phil65.github.io/agentpool에서 확인하십시오.