Eino 빠른 시작 — ChatWithEino 로 단계별 구축

Eino 빠른 시작

Quick Start 는 ChatWithEino 라는 학습용 에이전트를 '점진적 빌드업' 방식으로 만들어 보는 시리즈의 진입점입니다. 콘솔 앱으로 시작해 마지막엔 웹 앱(에이전트 이벤트 스트림을 증분 렌더링하는 A2UI 프로토콜)까지 완성합니다.

출처: Eino Quick Start — 공식문서

가장 짧은 경로 — 먼저 실행

git clone https://github.com/cloudwego/eino-examples.git
cd eino-examples/quickstart/chatwitheino

export OPENAI_API_KEY="..."
export OPENAI_MODEL="gpt-4.1-mini"

go run ./cmd/ch01 -- "Explain in one sentence what problem Eino's Component design solves."
# 최종(웹) 버전은 go run . → http://localhost:8080

챕터별 학습 경로

Chapter Topic
1 ChatModel and Message (Console)
2 Agent and Runner (Console multi-turn)
3 Memory and Session (persistent conversation)
4 Tools and file system access
5 Middleware pattern
6 Callback and Trace (observability)
7 Interrupt/Resume
8 Graph Tool (complex workflows)
9 Skill (knowledge/instruction packs)
10 A2UI (Web)
11 TurnLoop

최종 산출물: 확장 가능한 에이전트 골격

  • 런타임은 Runner 가 스트리밍 출력과 이벤트 모델로 실행을 이끕니다.
  • Tool 로 파일시스템·검색·워크플로를 통합합니다.
  • Middleware 로 재시도·승인·오류 처리 같은 횡단 관심사를 담습니다.
  • Interrupt/Resume + checkpoint 로 승인·누락 인자 채우기 같은 인터랙티브 흐름을 지원합니다.
  • compose(graph/chain/workflow) 로 복잡한 비즈니스 흐름을 유지 보수 가능한 실행 그래프로 구성합니다.

Skill 은 SKILL.md + reference/*.md 같은 안정적 지식/지시 팩을 에이전트에 주입해 필요할 때 모델이 로드해 호출하게 합니다.

더 알아보기