LLaMON Agent SDK

Registry 기반 에이전트·플로우·오케스트레이터를 빠르게 만들고, 로컬 실행부터 폐쇄망 배포까지 하나의 CLI로 진행합니다. 모델과 툴은 ID로 참조하고, 모든 에이전트는 A2A 프로토콜로 통신합니다.

바로 시작 핵심 개념

3분 퀵스타트

uv sync --frozen                       # .venv 생성 + 의존성 설치 (uv.lock 기준)
uv run llamon agent my-agent --yes     # 단일 에이전트 프로젝트 생성
cd my-agent                            # 생성된 프로젝트로 이동
# .env 채우기 — LLAMON_REGISTRY_HOST 등 (환경 설정 페이지 참고)
uv run llamon run .                    # 로컬 docker compose 실행

응답이 오면 첫 성공입니다. 설치부터 첫 A2A 호출까지의 전체 절차는 환경 설정 → 프로젝트 생성·첫 호출을 보세요. 무엇을 만들지 고르는 기준은 핵심 개념에 있습니다.

무엇을 만들까

에이전트 단일 에이전트 — 모델·입력 검증·툴 호출을 한 파일에서 처리. 대화·검색·도구 호출이 하나로 끝날 때.

플로우 여러 노드를 한 호출 안에서 연결 — flow-seq · parallel · route · http 네 가지 패턴.

오케스트레이터 여러 자식을 묶고 턴 사이에 상태를 누적 — rules-first bounded agentic loop를 권장하며, 명시적 run_turn도 지원.

입력·에러·툴 입력 선별(InputContracts) · 도메인 에러 매핑 · 확정 MCP 호출(deterministic_tool).

실행하고 배포하기

실행과 배포 로컬 Docker 실행 · SSH 배포 · 폐쇄망 패키징 · 환경별 프로필.

Studio Playground 실제 A2A Host 실행 · 대화 이력 · trace · 비교 · 재현 bundle.

데이터베이스 연결 asyncpg 공유 풀과 SQLAlchemy ORM의 선택·운영 기준.

자주 찾는 참고

문제 해결 막혔을 때 증상 → 원인 → 해결.

용어집 처음 보는 단어는 여기서 먼저.

아키텍처 개요 A2A executor → 에이전트 호출 → 직렬화 경계.

변경사항 최신 릴리스 노트.