원자 설계와 컴포넌트 구조

Atomic Agents의 이름이 말해 주듯, 이 프레임워크의 핵심은 에이전트를 '원자' 단위의 작은 컴포넌트로 나누고 조립한다는 설계예요. 큰 에이전트 하나를 만들기보다, 역할이 분명한 조그만 에이전트와 도구를 조합해서 전체를 만드는 방식이죠.

출처: https://github.com/Eigenwise/atomic-agents

리포는 크게 네 부분으로 나뉘어요. atomic-agents는 핵심 프레임워크이고, atomic-assembler는 여러 컴포넌트를 조립해 주는 쪽, atomic-examples는 실제 예제 모음, atomic-forge는 관련 도구를 담고 있어요. 개발할 때는 이 구조를 그대로 따라가면 자연스러워요.

모든 제어 흐름은 파이썬으로 작성해요. LLM이 즉흥적으로 판을 짜는 대신, 개발자가 정한 흐름 안에서 에이전트와 도구가 움직이죠. 덕분에 익숙한 소프트웨어 공학 기법을 그대로 적용할 수 있고, 유연성을 잃지 않으면서도 예측 가능한 동작을 만들 수 있어요.

# 컨셉: 작은 도구를 원자 단위로 정의하고 에이전트에 연결
@agent.tool
def add(a: int, b: int) -> int:
    """두 정수를 더해서 돌려줘요."""
    return a + b

코드가 스스로 로직을 말해 주니까, 에이전트가 어떻게 움직일지가 블랙박스가 아니에요. 디버깅이 훨씬 수월해지죠.