챕터별 상세
인테리어 디자인 에이전트 소개
사용자가 자신의 방 사진을 업로드하고 가구 카탈로그에서 선택한 아이템이 해당 공간에 어떻게 어울리는지 시각화해주는 AI 에이전트이다. 단순히 이미지를 생성하는 것을 넘어 실제 상용 서비스와 유사한 복잡한 워크플로를 처리하도록 설계되었다. Weights & Biases의 엔지니어 Russ가 직접 개발한 데모를 통해 실무적인 접근 방식을 제시한다.
Marimo 노트북을 활용한 프로토타입 워크플로
Marimo 노트북 환경에서 Gemini 1.5 Flash 모델을 기반으로 에이전트 클래스를 정의했다. weave.Model과 weave.op 데코레이터를 사용하여 모델 호출 과정을 자동으로 기록하도록 구성했다. 입력값으로 방 사진, 가구 사진, 그리고 고양이 사진을 포함한 상세 프롬프트를 전달하여 이미지를 합성한다. 결과물은 입력된 가구의 조명과 위치를 방의 맥락에 맞게 조정하여 생성된다.
Marimo는 Python 기반의 반응형 노트북으로, 코드 변경 시 관련 셀이 자동으로 업데이트되어 대화형 앱 제작에 유리하다.
W&B Weave를 이용한 트레이싱 및 피드백
에이전트 실행 시 생성된 모든 트레이스는 Weights & Biases Weave 대시보드에 기록된다. 각 단계의 입력 이미지, 프롬프트, 출력 결과 및 실행 시간을 한눈에 확인할 수 있다. 개발자는 인터페이스에서 직접 결과에 대한 피드백을 추가하여 어떤 프롬프트나 모델 설정이 더 나은 결과를 내는지 기록할 수 있다. 이러한 데이터는 나중에 모델 성능을 개선하고 최적화하는 기초 자료가 된다.
트레이싱은 복잡한 AI 에이전트의 내부 동작 과정을 투명하게 공개하여 디버깅을 돕는 필수적인 MLOps 기법이다.
python
class ImageGenerateModel(weave.Model):
model: str = "gemini-1.5-flash-image-preview"
@weave.op
def invoke(self, image_paths: list, prompt_text: str, output_file: str = "combined_image.png") -> dict:
# ... logic to load images and call Gemini API ...
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
# ... process response ...
return {"image": pil_result, "saved_path": saved_path, "user_prompt": prompt_text}Weave를 사용하여 Gemini 모델 호출을 추적 가능하도록 래핑한 클래스 정의
모델 평가 및 최적화
다양한 이미지 모델(Gemini 1.5 Flash, Pro 등)을 대상으로 정확도, 지연 시간, 비용을 기준으로 벤치마크 평가를 수행했다. Weave의 평가 기능을 통해 여러 모델의 합성 결과를 나란히 비교하고 정량적 지표를 산출했다. 이를 통해 프로덕션 환경에 가장 적합한 모델을 데이터에 기반하여 선택할 수 있다. 최종적으로 최적화된 에이전트를 실제 웹 애플리케이션 백엔드에 통합하는 과정을 보여준다.
python
weave.init(WANDB_ENTITY + '/' + WANDB_PROJECT)
image_model = ImageGenerateModel()
result = image_model.invoke(image_paths=image_paths, prompt_text=prompt)Weights & Biases Weave 프로젝트를 초기화하고 에이전트를 실행하는 코드
용어 해설
- 관측 가능성(Observability)
- — 시스템 내부 상태를 외부 출력을 통해 파악할 수 있는 정도이다. AI 애플리케이션에서는 모델의 입력, 출력, 실행 시간 등을 추적하여 성능 저하나 오류의 원인을 진단하는 데 필수적이다.
- 트레이싱(Tracing)
- — 분산 시스템이나 복잡한 워크플로에서 개별 요청의 실행 경로를 기록하는 기법이다. AI 에이전트의 각 단계별 호출 결과와 프롬프트를 시각화하여 로직의 병목이나 실패 지점을 식별하는 데 사용된다.
- 평가(Evaluation)
- — AI 모델이나 시스템의 성능을 정량적 또는 정성적 지표로 측정하는 과정이다. 정확도, 비용, 지연 시간 등을 기준으로 여러 모델의 결과를 비교하여 프로덕션 환경에 적합한 최적의 구성을 결정한다.
언급된 리소스
API DocsGemini API Quickstart
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 04. 25.수집 2026. 04. 25.출처 타입 YOUTUBE
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
