NxtCloud NxtCloud Workshop / AI 에이전트 크루 실습
로그인

과정 정리 — 나의 에이전트 시스템 설계

개요

Lab 1~7을 거치며 크루를 만들고, 절차를 스킬로 붙이고, 규칙을 파일로 남기고, 문서로 답하게 하고, 루프를 설계해 돌리고, 일정을 걸고, 마지막에 사람이 결정하는 흐름을 직접 만들었습니다. 여기서 그 결과를 하나로 모아 정리합니다. 팀 발표 자료가 아니라, 자신이 무엇을 만들었는지 스스로 점검하는 개인 작업입니다 — 남에게 보여주기 위해서가 아니라, 흩어져 있던 결정들을 한 문서로 모으면 무엇이 빠졌는지가 보이기 때문입니다.

항목과 랩의 대응

아래 템플릿의 각 항목은 특정 Lab 하나가 아니라, 과정 전체에서 만든 것들이 재료입니다.

템플릿 항목이 과정에서 해당하는 것
입력 데이터와 신뢰 수준Lab 4의 Knowledge 소스와 검증
컨텍스트 조립 방식Lab 2 스킬 · Lab 3 Steering
워크플로우 단계와 상태Lab 5의 명세와 DAG
자동 검증Lab 5의 Acceptance Criteria
HITL 승인 지점Lab 1의 승인 경계 · Lab 7의 질문 카드
실패·재시도·종료 조건Lab 6의 이력 · Lab 7의 부분 실패

정리 템플릿

아래 9개 항목을 자신의 언어로 채워 봅니다. 실습 저장소의 원본 파일을 로컬에서 열어 직접 채우거나, 여기서 구조만 참고해도 됩니다.

# 최종 정리 템플릿

## 1. 해결하려는 문제
- 사용자:
- 현재 문제:
- 자동화 범위:
- 자동화하지 않을 범위:
- 성공 기준:

## 2. 입력 데이터
| 데이터 | 출처 | 신뢰 수준 | 갱신 주기 | 누락 시 처리 |
|---|---|---|---|---|
| | | | | |

## 3. 컨텍스트와 메모리
- 시스템 지시:
- 현재 세션 컨텍스트:
- 장기 메모리에 저장할 내용:
- 저장하지 않을 내용:
- 검색 결과 검증 방법:

## 4. 스킬과 MCP 도구
| 컴포넌트 | 책임 | 입력 | 출력 | 실패 형태 |
|---|---|---|---|---|
| | | | | |

## 5. 워크플로우
입력 → 분석 → 실행 → 검증 → 사람 승인 → 산출물
- 병렬 단계:
- 순차 의존 단계:
- 체크포인트:
- 재시도 조건:
- 재계획 조건:

## 6. 검증
- 자동 검증:
- 사람이 확인할 근거:
- 할루시네이션 또는 불확실성 표시 방법:

## 7. HITL 경계
- 승인이 필요한 행동:
- 승인 화면에 보여줄 근거:
- 거절 시 처리:
- 승인 만료 또는 응답 없음 처리:

## 8. 안전과 감사
- 최소 권한:
- 민감정보 처리:
- 거부 규칙:
- 기록할 이벤트:

## 9. POC 결과
- 성공한 부분:
- 실패한 부분:
- 관찰된 한계:
- 다음 실험:

왜 이 정리가 필요한가

과정 내내 결정은 여러 화면에 흩어져 있었습니다 — 크루 설정 화면의 워크스페이스, 스킬의 트리거 문구, Steering 파일의 규칙, Knowledge 소스의 등록 여부, 태스크 명세의 Acceptance Criteria, 스케줄의 Approval 정책, 그리고 마지막 질문 카드의 선택. 이 템플릿은 그 결정들을 한 문서로 모으는 도구입니다. 채우다가 빈칸이 남는 항목이 있다면, 그것이 바로 다음에 만들 시스템에서 먼저 정해야 할 것입니다.

Lab 1~3의 정리Lab 4~7의 정리가 개념을 되짚는 자리였다면, 여기서는 그 개념들을 자신의 문제에 적용해 봅니다.