ν”Όλ“œλ‘œ λŒμ•„κ°€κΈ°
πŸ€– nanobot: A Comprehensive Build-Your-Own Guide πŸ“š
Dev.toDev.to
AI/ML

4k 라인의 μ΄ˆκ²½λŸ‰ λ£¨ν”„λ‘œ κ΅¬ν˜„ν•œ 닀채널 ν™•μž₯ν˜• AI Agent μ•„ν‚€ν…μ²˜

πŸ€– nanobot: A Comprehensive Build-Your-Own Guide πŸ“š

Truong Phung2026λ…„ 4μ›” 28일25λΆ„intermediate

Context

λ³΅μž‘ν•œ μ˜€μΌ€μŠ€νŠΈλ ˆμ΄μ…˜ λ ˆμ΄μ–΄μ™€ DAG 기반 μŠ€μΌ€μ€„λŸ¬λ‘œ μΈν•œ AI ν”„λ ˆμž„μ›Œν¬μ˜ κ³Όλ„ν•œ λ³΅μž‘μ„± 증가. ν™•μž₯μ„± 확보λ₯Ό μœ„ν•΄ λ„μž…λ˜λŠ” 무거운 좔상화 계측이 였히렀 μ½”λ“œ 가독성과 μœ μ§€λ³΄μˆ˜ νš¨μœ¨μ„ μ €ν•˜μ‹œν‚€λŠ” ν•œκ³„ 직면.

Technical Solution

  • 단일 Async ν•¨μˆ˜ 기반의 Readable Agent Loop 섀계λ₯Ό ν†΅ν•œ λ³΅μž‘ν•œ μ œμ–΄ 흐름 제거 및 도ꡬ 호좜 μ€‘μ‹¬μ˜ λ‹¨μˆœ ꡬ쑰 κ΅¬ν˜„
  • MessageBus 기반의 I/O-Brain λ””μ»€ν”Œλ§μœΌλ‘œ 채널 ν™•μž₯ μ‹œ 단일 파일 PR만으둜 μΆ”κ°€ κ°€λŠ₯ν•œ μœ μ—°ν•œ ꡬ쑰 확보
  • Session-key λ‹¨μœ„μ˜ Lock μ μš©μ„ ν†΅ν•œ μ„Έμ…˜ λ‚΄ 순차 μ²˜λ¦¬μ™€ μ„Έμ…˜ κ°„ 병렬 처리의 μ΅œμ ν™”λœ Concurrency λͺ¨λΈ ꡬ좕
  • Vector DB λŒ€μ‹  Markdown 파일 및 Git 기반의 Memory 관리λ₯Ό ν†΅ν•œ 인간 가독성 확보 및 λΉ„μš© 제둜의 μƒνƒœ μœ μ§€
  • ProviderSpec 및 BaseChannel λ ˆμ§€μŠ€νŠΈλ¦¬ 기반의 ν”ŒλŸ¬κ·ΈμΈ ꡬ쑰둜 μ‹ κ·œ LLM 및 ν”Œλž«νΌ 톡합 λΉ„μš© μ΅œμ†Œν™”
  • InboundMessage 큐λ₯Ό ν†΅ν•œ Cron, Sub-agent, μ‹œμŠ€ν…œ λ©”μ‹œμ§€μ˜ 단일 μΈν„°νŽ˜μ΄μŠ€ 톡합 처리

1. μ˜€μΌ€μŠ€νŠΈλ ˆμ΄μ…˜ λ ˆμ΄μ–΄ λ„μž… μ „ 단일 루프와 도ꡬ 호좜둜 ν•΄κ²° κ°€λŠ₯ν•œμ§€ κ²€ν† 

2. I/O 계측과 핡심 둜직 사이에 λ©”μ‹œμ§€ 큐λ₯Ό λ°°μΉ˜ν•˜μ—¬ μΈν„°νŽ˜μ΄μŠ€ μ˜μ‘΄μ„± 뢄리

3. λ³΅μž‘ν•œ μƒνƒœ λ¨Έμ‹  λŒ€μ‹  LLM의 Stop Reason을 ABI처럼 ν™œμš©ν•˜μ—¬ 흐름 μ œμ–΄

4. 초기 λ‹¨κ³„μ˜ λ©”λͺ¨λ¦¬ μ‹œμŠ€ν…œμ€ Vector DB보닀 μˆ˜μ • κ°€λŠ₯ν•œ 파일 기반 μ €μž₯μ†Œ μš°μ„  κ³ λ €

원문 읽기