콘텐츠로 이동
LLaMON Agent SDK

용어집

문서를 읽다 낯선 단어가 나오면 여기서 먼저 의미를 잡고 돌아가세요. 각 항목의 링크는 자세한 설명이 있는 문서로 이어집니다.

핵심 개념

섹션 제목: “핵심 개념”
용어한 줄 정의자세히
Registry모델·프롬프트·가드레일·MCP를 ID로 보관·관리하는 중앙 서버. 에이전트는 ID만 참조하고, 메타데이터는 런타임에 로드합니다.Registry 기반 에이전트
플로우 (Flow)여러 노드(에이전트·비즈니스 로직·HTTP)를 연결한 멀티 에이전트 그래프. flow-seq·flow-parallel·flow-route·flow-http 네 가지 형태가 있습니다.상태와 헬퍼
노드 (node)플로우 그래프의 한 단계. Registry 에이전트 노드, Python 비즈니스 로직 노드, HTTP 노드 등이 있습니다.직렬 플로우
Studio노드·그래프·스킬·설정을 시각적으로 편집하는 UI. nodes.py·graph.py·agent_card.py·config.py 파일만 읽고 쓰며, LLM/MCP를 직접 호출하지 않습니다.아키텍처 → Studio
RuntimeAdapter모델 출력을 검증·정규화해 output_text/output_data를 보장하는 어댑터. 구조화 출력 에이전트(agent-structured)의 핵심.RuntimeAdapter 고급
InputContracts인바운드 A2A DataPart/FilePart 중 예상 스키마·형태에 일치하는 것만 골라내는 입력 계약.입력 선별
확정 MCP 호출 (deterministic_tool)LLM 판단 전에 규칙으로 특정 MCP tool을 확정 호출하는 데코레이터. 비용·지연 절감과 결정적 동작에 사용.확정 MCP 호출
upstream parts플로우에서 이전 노드가 만든 A2A parts. replace(기본)/append 정책으로 다음 노드 전달 방식을 제어.Upstream Parts 정책
도메인 에러비즈니스 의미를 담은 에러를 표준 A2A 에러(domainCode·domainTitle)로 매핑하는 방식.도메인 에러 매핑

프로토콜·런타임

섹션 제목: “프로토콜·런타임”
용어한 줄 정의자세히
A2A (Agent-to-Agent)에이전트 간 메시지·이벤트 표준 프로토콜(0.3.x). 요청은 message/send·message/stream.A2A 메시지 요청
ReActLLM이 추론(Reasoning)과 도구 호출(Acting)을 반복하는 루프. 반복 상한은 SDK가 안전 기본값으로 관리.ReAct 반복 상한
HITL (Human-in-the-loop)실행 중간에 사람의 확인·입력을 받는 흐름.상태와 헬퍼
멀티턴 메모리대화 히스토리를 유지해 이전 맥락을 참고하는 기능(in_memory/postgres).멀티턴 메모리

실행·배포

섹션 제목: “실행·배포”
용어한 줄 정의자세히
폐쇄망 (air-gapped)런타임에 외부 네트워크가 전혀 없는 환경. prepare-offline으로 tar.gz 산출물을 만들어 반입합니다. (≠ SSH로 접근 가능한 원격 서버 배포)로컬 실행 + 폐쇄망 준비
wheelhouse의존성 wheel을 미리 받아 둔 디렉토리. 빌드 시 온라인 PyPI 대신 이걸 사용합니다(vendor-deps가 생성).로컬 실행 + 폐쇄망 준비
인프라 프로필 (.llamon/profiles)배포 환경별 설정 묶음(.llamon/profiles/<name>.toml). SDK가 prod·stage를 기본 제공.인프라 프로필
Registry 런타임 vs local 런타임--runtime-source registry는 Registry의 노드를, local은 Registry 없이 노드별 LLM을 직접 연결합니다. (llamon run의 “로컬 실행”=Docker 기동과는 별개)직접 모델 연결