5분 만에 FROST로 작업 Agent 만들기: 기초부터 실전까지의 최소 실습 튜토리얼

저자: 神通说 (Shéntōngshuō)

날짜: 2026-07-30

주제: 코드 튜토리얼 | 목요일 로테이션

읽기 시간: 10분

프레임워크를 배우는 가장 좋은 방법은 문서를 읽는 것이 아니라, 실제로 돌아가는 무언가를 직접 작성해 보는 것입니다.

오늘 이 글의 목표는 매우 명확합니다: 5분이라는 시간을 사용하여, FROST 프레임워크를 기반으로 실제 작업을 수행할 수 있는 Agent를 작성하는 것입니다.

개념 놀이나 철학적인 이야기는 배제하고, 오직 코드만 작성하겠습니다.

1. 먼저 명확히 하기: 우리는 무엇을 작성하고 있는가?

FROST(Fractal Runtime of Orchestrated Skills & Tasks)의 핵심은 오직 **네 가지 원자(Atom)**로 구성됩니다:

작업 Agent란, Agent가 SOP(Standard Operating Procedure)에 정의된 단계에 따라 순차적으로 Skill을 호출하고, 중간 결과물을 Store에 저장하는 것을 의미합니다.

매우 간단합니다.

사용자 작업 -> Agent -> SOP에 따라 Skill 실행 -> 결과를 Store에 저장 -> 출력

2. 환경 준비

FROST는 순수 Python 프로젝트이며, 외부 의존성이 없습니다 (핵심 코드는 LLM API가 필요하지 않습니다).

# 프로젝트 클론
git clone https://gitee.com/liao_liang_7514/frost.git
cd frost
...

팁: FROST의 핵심 코드는 약 500줄의 Python 코드로 이루어져 있습니다. 클론한 후 core.py를 먼저 훑어보며 네 가지 원자의 인터페이스 설계를 이해하는 것을 권장합니다.

3. 첫 번째 작업 Agent: 3단계로 끝내기

Step 1: Skill 정의하기

Skill은 FROST의 최소 능력 단위입니다. 이는 무상태(Stateless)이며 부작용(Side-effect)이 없고, 오직 파라미터를 받아 결과를 반환합니다.

from core import Store, Agent

# ---- 두 개의 간단한 Skill 정의 ----
...

Skill 설계 원칙 주의사항:

1. 입력은 context 딕셔너리이며, 출력 또한 수정된 context 딕셔너리입니다.
2. 어떠한 내부 상태도 보유하지 않습니다 (no self.xxx).
3. 임의의 Agent에 의해 조합되어 사용될 수 있습니다.

이는 함수형 프로그래밍(Functional Programming)의 사고방식과 맥을 같이 합니다: 순수 함수(Pure Function), 조합 가능성, 테스트 가능성.

Step 2: Agent 조립하기

Skill이 준비되었다면, 이제 Agent를 생성하고 Store와 Skills를 부여합니다:

# Store(기억 컨테이너) 생성
store = Store(storage_path="./my_agent_memory")

...

이렇게 Agent가 생성되었습니다. 이 Agent는 대문자 변환, 접두사 추가라는 두 가지 능력을 갖추고 있으며, 중간 상태를 저장하기 위한 자신만의 Store를 가집니다.

Step 3: SOP로 작업 실행하기

SOP(Standard Operating Procedure, 표준 운영 절차)는 Agent가 실행할 순서를 정의한 단계 리스트입니다:

# SOP 단계 정의: 먼저 대문자로 변환한 후, 접두사를 추가함
result = agent.run(
    sop_steps=["uppercase", "add_prefix"],
...

정말 간단합니다. 3단계로 완료됩니다: Skill 정의 -> Agent 조립 -> SOP로 실행.

4. 심화: 기억력을 가진 작업 Agent

위의 예시는 최소 버전입니다. 하지만 FROST가 진정으로 강력한 이유는 바로 **기억의 전승(Memory Inheritance)**에 있습니다.

실전에 더 가까운 시나리오를 보여드리겠습니다: 이전 분석 결과를 기억하여 중복 계산을 피할 수 있는 데이터 분석 Agent입니다.

import json
from datetime import datetime
from core import Store, Agent
...

이 예시는 FROST의 핵심 장점을 보여줍니다: Agent가 Store를 통해 작업 간의 기억을 구현한다는 점입니다.

전통적인 Agent 프레임워크는 실행할 때마다 처음부터 다시 시작하지만, FROST의 Agent는 다음과 같이 동작합니다:

1. 먼저 Store에 과거 결과가 있는지 확인합니다.
2. 결과가 있다면 즉시 사용하여 중복 계산을 방지합니다.
3. 결과가 없다면 계산을 수행하고 그 결과를 Store에 저장합니다.

이것이 바로 '복리 효과'의 코드 구현이 아니겠습니까?

5. FROST에서 FROST-SOP로: 프로덕션급 업그레이드

위의 코드는 FROST 교육용 프레임워크의 작성 방식이며, 명확하고 간결하며 이해하기 쉽습니다. 하지만 프로덕션 환경에서 Agent 시스템을 운영하려면 다음과 같은 문제들을 해결해야 합니다:

• 오류 처리(Error Handling) 및 재시도 전략
• 병렬 실행(Concurrency) 및 비동기 스케줄링(Asynchronous Scheduling)
• 권한 제어 및 보안 샌드박스(Security Sandbox)
• 로그 감사(Log Auditing) 및 관측 가능성(Observability)
• 비용 추적 및 리소스 관리

이것이 바로 FROST-SOP가 해결하고자 하는 문제입니다.

FROST-SOP(https://gitee.com/liao_liang_7514/frost-sop)는 FROST의 엔지니어링 구현체로, 이벤트 기반 아키텍처(Event-driven Architecture)를 사용하여 교육용 프레임워크를 프로덕션급 플랫폼으로 업그레이드합니다:

# FROST-SOP의 태스크 Agent (개념 예시)

# 교육용 버전 FROST: 동기식, 단일 단계
...

교육에서 프로덕션까지, FROST와 FROST-SOP는 하나의 완전한 성장 경로를 형성합니다:

학습 및 이해 -> FROST (500행의 Python, 4개의 원자 단위)
    |
엔지니어링 적용 -> FROST-SOP (이벤트 기반, DAG 오케스트레이션, 권한 제어)
...

6. 실습 연습

5분이 부족하다면, 단계별로 진행할 수 있는 3가지 연습 과제를 드립니다:

입문: 위의 3단계 예시를 실행하여 Skill -> Agent -> SOP의 실행 흐름(Execution Flow)을 이해합니다.

심화: skill_analyze에 오류 처리(데이터 누락, 타입 오류 등)를 추가하여, Skill의 순수 함수(Pure Function) 제약 조건을 이해합니다.

도전: FROST-SOP를 클론(Clone)한 후, SOPEngine을 사용하여 위의 데이터 분석 작업을 다시 작성하고, 교육용 버전과 엔지니어링 버전의 차이점을 비교해 보세요.

# FROST 교육용 프레임워크
git clone https://gitee.com/liao_liang_7514/frost.git

...

7. 요약

오늘의 핵심 내용을 한 장의 그림으로 복습해 보세요:

+---------------------------------------------+
|           FROST 태스크 Agent 모델               |
+---------------------------------------------+
...

이 3가지 핵심 원칙을 기억하세요:

1. Skill은 무상태(Stateless)입니다: 순수 함수이며, context를 입력받아 context를 출력합니다.
2. Store는 상태 유지(Stateful)가 가능합니다: Agent의 기억이며, 태스크 간에 전승됩니다.
3. SOP는 조합 가능(Composable)합니다: 단계들을 자유롭게 오케스트레이션하여 서로 다른 태스크 흐름을 형성할 수 있습니다.

5분 만에, 여러분은 기억 능력을 갖춘 태스크 Agent를 소유하게 되었습니다.

다음 단계는 무엇일까요? FROST-SOP가 이 모델을 어떻게 프로덕션급 시스템으로 업그레이드하는지 확인해 보세요.

프로젝트 링크

• FROST 교육용 프레임워크: https://gitee.com/liao_liang_7514/frost
• FROST-SOP 엔지니어링 플랫폼: https://gitee.com/liao_liang_7514/frost-sop
• FROST 백서 (제4판): FROST 저장소 내 WHITEPAPER.md
• FROST-SOP 설계 문서: frost-sop 저장소 내 docs/ 디렉토리

본문은 FROST 듀얼 프로젝트 데일리 홍보 시리즈 | 목요일 코드 튜토리얼 순환 주제입니다.

FROST: 에이전트에게 계보, 기억, 그리고 명예를 부여합니다.